diff --git a/sources/tech/20210630 Parse JSON configuration files with Groovy.md b/sources/tech/20210630 Parse JSON configuration files with Groovy.md deleted file mode 100644 index 4590f9e55f..0000000000 --- a/sources/tech/20210630 Parse JSON configuration files with Groovy.md +++ /dev/null @@ -1,312 +0,0 @@ -[#]: subject: (Parse JSON configuration files with Groovy) -[#]: via: (https://opensource.com/article/21/6/groovy-parse-json) -[#]: author: (Chris Hermansen https://opensource.com/users/clhermansen) -[#]: collector: (lujun9972) -[#]: translator: (geekpi) -[#]: reviewer: ( ) -[#]: publisher: ( ) -[#]: url: ( ) - -Parse JSON configuration files with Groovy -====== -Sidestep the debate on whether or not to use JSON as a configuration -format and just learn how to parse it using Groovy. -![Looking back with binoculars][1] - -Applications typically include some type of default or "out-of-the-box" state or configuration, as well as some way for users to customize that configuration for their needs. - -For example, [LibreOffice Writer][2] gives access to stuff like user data, fonts, language settings, and (much) more through **Tools > Options** on its menu bar. Some applications (like LibreOffice) provide a point-and-click user interface to manage these settings. Some, like [Tracker][3] (the GNOME task that indexes files), use XML files. And some, especially JavaScript-based applications, use JSON, despite the protestations of many (for example, [this writer][4] and [this other writer][5]). - -In this article, I'll sidestep the debate about whether or not to use JSON as a configuration file format and explain how to parse this kind of information using the [Groovy programming language][6]. Groovy is based on Java but with a different set of design priorities that make Groovy feel more like Python. - -### Install Groovy - -Since Groovy is based on Java, it also requires a Java installation. You might find recent and decent versions of Java and Groovy in your Linux distribution's repositories. Or you can install Groovy following the [instructions][7] on its website. A nice alternative for Linux users is [SDKMan][8], which you can use to get multiple versions of Java, Groovy, and many other related tools. For this article, I'll use my distro's OpenJDK11 release and SDKMan's Groovy 3.0.7 release. - -### The demo JSON configuration file - -For this demonstration, I snagged this JSON from [Drupal][9]—it's the main configuration file used by the Drupal CMS—and saved it in the file `config.json`: - - -``` -{ -  "vm": { -    "ip": "192.168.44.44", -    "memory": "1024", -    "synced_folders": [ -      { -        "host_path": "data/", -        "guest_path": "/var/www", -        "type": "default" -      } -    ], -    "forwarded_ports": [] -  }, -  "vdd": { -    "sites": { -      "drupal8": { -        "account_name": "root", -        "account_pass": "root", -        "account_mail": "[box@example.com][10]", -        "site_name": "Drupal 8", -        "site_mail": "[box@example.com][10]", -        "vhost": { -          "document_root": "drupal8", -          "url": "drupal8.dev", -          "alias": ["www.drupal8.dev"] -        } -      }, -      "drupal7": { -        "account_name": "root", -        "account_pass": "root", -        "account_mail": "[box@example.com][10]", -        "site_name": "Drupal 7", -        "site_mail": "[box@example.com][10]", -        "vhost": { -          "document_root": "drupal7", -          "url": "drupal7.dev", -          "alias": ["www.drupal7.dev"] -        } -      } -    } -  } -} -``` - -This is a nice, complex JSON file with several levels of structure, like: - - -``` -`<>.vdd.sites.drupal8.account_name` -``` - -and some lists like: - - -``` -`<>.vm.synced_folders` -``` - -Here, `<>` represents the unnamed top level. Let's see how Groovy handles that. - -### Parsing JSON with Groovy - -Groovy comes with the `groovy.json` package, which is full of all sorts of cool stuff. One of the best parts is the `JsonSlurper` class, which includes several `parse()` methods that convert JSON to a Groovy `Map`—a data structure with values stored against keys. - -Here's a nice, short Groovy program named `config1.groovy` that creates a `JsonSlurper` instance, then calls one of its `parse()` methods to parse the JSON in a file and convert it to a `Map` instance called `config`, and finally writes out that map: - - -``` -import groovy.json.JsonSlurper - -def jsonSlurper = new JsonSlurper() - -def config = jsonSlurper.parse(new File('config.json')) - -println "config = $config" -``` - -Run this program on the command line in a terminal: - - -``` -$ groovy config1.groovy -config = [vm:[ip:192.168.44.44, memory:1024, synced_folders:[[host_path:data/, guest_path:/var/www, type:default]], forwarded_ports:[]], vdd:[sites:[drupal8:[account_name:root, account_pass:root, account_mail:[box@example.com][10], site_name:Drupal 8, site_mail:[box@example.com][10], vhost:[document_root:drupal8, url:drupal8.dev, alias:[www.drupal8.dev]]], drupal7:[account_name:root, account_pass:root, account_mail:[box@example.com][10], site_name:Drupal 7, site_mail:[box@example.com][10], vhost:[document_root:drupal7, url:drupal7.dev, alias:[www.drupal7.dev]]]]]] -$ -``` - -The output shows a top-level map with two keys: `vm` and `vdd`. Each key references its own map of values. Notice the empty list referenced by the `forwarded_ports` key. - -Huh. That was easy, but all it did was print things out. How do you get at the various components? Here's another program that shows how to access the value stored at `config.vm.ip`: - - -``` -import groovy.json.JsonSlurper - -def jsonSlurper = new JsonSlurper() - -def config = jsonSlurper.parse(new File('config.json')) - -println "config.vm.ip = ${config.vm.ip}" -``` - -Run it: - - -``` -$ groovy config2.groovy -config.vm.ip = 192.168.44.44 -$ -``` - -Yup, that's easy, too. This takes advantage of Groovy shorthand that means: - - -``` -`config.vm.ip` -``` - -in Groovy is equivalent to: - - -``` -`config['vm']['ip']` -``` - -when `config` and `config.vm` are both instances of `Map`, and both are equivalent to: - - -``` -`config.get("vm").get("ip")` -``` - -in Java. - -So much for just handling the JSON. What if you want to have a standard configuration and let the user override it? In that case, you might want to have a JSON configuration hard-coded in the program, then read the user configuration and override any of the standard configuration settings. - -Say the above configuration is standard, and the user wants to override only a bit of it, just the `ip` and `memory` values in the `vm` structure, and put that in the `userConfig.json` file: - - -``` -{ -  "vm": { -    "ip": "201.201.201.201", -    "memory": "4096", -  } -} -``` - -You could do that using this program: - - -``` -import groovy.json.JsonSlurper - -def jsonSlurper = new JsonSlurper() - -// use parseText() to parse a string rather than reading from a file -// this gives us the “standard configuration” - -def standardConfig = jsonSlurper.parseText(""" -{ -  "vm": { -    "ip": "192.168.44.44", -    "memory": "1024", -    "synced_folders": [ -      { -        "host_path": "data/", -        "guest_path": "/var/www", -        "type": "default" -      } -    ], -    "forwarded_ports": [] -  }, -  "vdd": { -    "sites": { -      "drupal8": { -        "account_name": "root", -        "account_pass": "root", -        "account_mail": "[box@example.com][10]", -        "site_name": "Drupal 8", -        "site_mail": "[box@example.com][10]", -        "vhost": { -          "document_root": "drupal8", -          "url": "drupal8.dev", -          "alias": ["www.drupal8.dev"] -        } -      }, -      "drupal7": { -        "account_name": "root", -        "account_pass": "root", -        "account_mail": "[box@example.com][10]", -        "site_name": "Drupal 7", -        "site_mail": "[box@example.com][10]", -        "vhost": { -          "document_root": "drupal7", -          "url": "drupal7.dev", -          "alias": ["www.drupal7.dev"] -        } -      } -    } -  } -} -""") - -// print out the standard configuration - -println "standardConfig = $standardConfig" - -// read in and parse the user configuration information - -def userConfig = jsonSlurper.parse(new File('userConfig.json')) - -// print out the user configuration information - -println "userConfig = $userConfig" - -// a function to merge the user configuration with the standard - -def mergeMaps(Map input, Map merge) { -    merge.each { k, v -> -        if (v instanceof Map) -            mergeMaps(input[k], v) -        else -            input[k] = v -    } -} - -// merge the configurations and print out the modified -// standard configuration - -mergeMaps(standardConfig, userConfig) - -println "modified standardConfig $standardConfig" -``` - -Run this as: - - -``` -$ groovy config3.groovy -standardConfig = [vm:[ip:192.168.44.44, memory:1024, synced_folders:[[host_path:data/, guest_path:/var/www, type:default]], forwarded_ports:[]], vdd:[sites:[drupal8:[account_name:root, account_pass:root, account_mail:[box@example.com][10], site_name:Drupal 8, site_mail:[box@example.com][10], vhost:[document_root:drupal8, url:drupal8.dev, alias:[www.drupal8.dev]]], drupal7:[account_name:root, account_pass:root, account_mail:[box@example.com][10], site_name:Drupal 7, site_mail:[box@example.com][10], vhost:[document_root:drupal7, url:drupal7.dev, alias:[www.drupal7.dev]]]]]] -userConfig = [vm:[ip:201.201.201.201, memory:4096]] -modified standardConfig [vm:[ip:201.201.201.201, memory:4096, synced_folders:[[host_path:data/, guest_path:/var/www, type:default]], forwarded_ports:[]], vdd:[sites:[drupal8:[account_name:root, account_pass:root, account_mail:[box@example.com][10], site_name:Drupal 8, site_mail:[box@example.com][10], vhost:[document_root:drupal8, url:drupal8.dev, alias:[www.drupal8.dev]]], drupal7:[account_name:root, account_pass:root, account_mail:[box@example.com][10], site_name:Drupal 7, site_mail:[box@example.com][10], vhost:[document_root:drupal7, url:drupal7.dev, alias:[www.drupal7.dev]]]]]] -$ -``` - -The line beginning `modified standardConfig` shows that the `vm.ip` and `vm.memory` values were overridden. - -Sharp-eyed readers will notice that I did not check for malformed JSON , nor was I careful to ensure that the user configuration makes sense (doesn't create new fields, provides reasonable values, and so on). So the cute little recursive method to merge the two maps probably isn't all that practical in the real world. - -Well I had to leave _something_ for homework, didn't I? - -### Groovy resources - -The Apache Groovy site has a lot of great [documentation][11]. Another great Groovy resource is [Mr. Haki][12]. And a really great reason to learn Groovy is to go on and learn [Grails][13], which is a wonderfully productive full-stack web framework built on top of excellent components like Hibernate, Spring Boot, and Micronaut. - --------------------------------------------------------------------------------- - -via: https://opensource.com/article/21/6/groovy-parse-json - -作者：[Chris Hermansen][a] -选题：[lujun9972][b] -译者：[译者ID](https://github.com/译者ID) -校对：[校对者ID](https://github.com/校对者ID) - -本文由 [LCTT](https://github.com/LCTT/TranslateProject) 原创编译，[Linux中国](https://linux.cn/) 荣誉推出 - -[a]: https://opensource.com/users/clhermansen -[b]: https://github.com/lujun9972 -[1]: https://opensource.com/sites/default/files/styles/image-full-size/public/lead-images/look-binoculars-sight-see-review.png?itok=NOw2cm39 (Looking back with binoculars) -[2]: https://www.libreoffice.org/discover/writer/ -[3]: https://gitlab.gnome.org/GNOME/tracker -[4]: https://www.lucidchart.com/techblog/2018/07/16/why-json-isnt-a-good-configuration-language/ -[5]: https://medium.com/trabe/stop-using-json-config-files-ab9bc55d82fa -[6]: https://groovy-lang.org/ -[7]: https://groovy.apache.org/download.html -[8]: https://sdkman.io/ -[9]: https://www.drupal.org/node/2008800 -[10]: mailto:box@example.com -[11]: http://groovy-lang.org/documentation.html -[12]: https://blog.mrhaki.com/ -[13]: https://grails.org/ diff --git a/translated/tech/20210630 Parse JSON configuration files with Groovy.md b/translated/tech/20210630 Parse JSON configuration files with Groovy.md new file mode 100644 index 0000000000..58e018ca68 --- /dev/null +++ b/translated/tech/20210630 Parse JSON configuration files with Groovy.md @@ -0,0 +1,309 @@ +[#]: subject: (Parse JSON configuration files with Groovy) +[#]: via: (https://opensource.com/article/21/6/groovy-parse-json) +[#]: author: (Chris Hermansen https://opensource.com/users/clhermansen) +[#]: collector: (lujun9972) +[#]: translator: (geekpi) +[#]: reviewer: ( ) +[#]: publisher: ( ) +[#]: url: ( ) + +用 Groovy 解析 JSON 配置文件 +====== +抛开关于是否使用 JSON 作为配置格式的争论，只需学习如何用 Groovy 来解析它。 +![Looking back with binoculars][1] + +应用程序通常包括某种类型的默认或“开箱即用”的状态或配置，以及某种让用户根据自己的需要定制配置的方式。 + +例如，[LibreOffice Writer][2] 通过其菜单栏上的**工具>选项**，可以访问诸如用户数据、字体、语言设置等（更多）东西。一些应用程序（如 LibreOffice）提供了一个点选式的用户界面来管理这些设置。有些，像 [Tracker][3]（GNOME 的任务，用于索引文件），使用 XML 文件。还有一些，特别是基于 JavaScript 的应用，使用 JSON，尽管它有许多人抗议（例如，[这位作者][4]和[这位其他作者][5]）。 + +在这篇文章中，我将回避关于是否使用 JSON 作为配置文件格式的争论，并解释如何使用 [Groovy 编程语言][6]来解析这类信息。Groovy 以 Java 为基础，但有一套不同的设计重点，使 Groovy 感觉更像 Python。 + +### 安装 Groovy + +由于 Groovy 是基于 Java 的，它也需要安装 Java。你可能会在你的 Linux 发行版的软件库中找到最近的、合适的 Java 和 Groovy 版本。或者，你可以按照其网站上的[说明][7]安装 Groovy。 Linux 用户的一个不错的选择是 [SDKMan][8]，你可以使用它来获取 Java、Groovy 和许多其他相关工具的多个版本。 对于本文，我将使用我的发行版的 OpenJDK11 和 SDKMan 的 Groovy 3.0.7。 + +### 演示的 JSON 配置文件 + +在这个演示中，我从 [Drupal][9] 中截取了这个 JSON 文件，它是 Drupal CMS 使用的主要配置文件，并将其保存在文件 `config.json` 中： + +``` +{ + "vm": { + "ip": "192.168.44.44", + "memory": "1024", + "synced_folders": [ + { + "host_path": "data/", + "guest_path": "/var/www", + "type": "default" + } + ], + "forwarded_ports": [] + }, + "vdd": { + "sites": { + "drupal8": { + "account_name": "root", + "account_pass": "root", + "account_mail": "[box@example.com][10]", + "site_name": "Drupal 8", + "site_mail": "[box@example.com][10]", + "vhost": { + "document_root": "drupal8", + "url": "drupal8.dev", + "alias": ["www.drupal8.dev"] + } + }, + "drupal7": { + "account_name": "root", + "account_pass": "root", + "account_mail": "[box@example.com][10]", + "site_name": "Drupal 7", + "site_mail": "[box@example.com][10]", + "vhost": { + "document_root": "drupal7", + "url": "drupal7.dev", + "alias": ["www.drupal7.dev"] + } + } + } + } +} +``` + +这是一个漂亮的、复杂的 JSON 文件，有几层结构，如： + + +``` +`<>.vdd.sites.drupal8.account_name` +``` + +和一些列表，如： + + +``` +`<>.vm.synced_folders` +``` + +这里，`<>` 代表未命名的顶层。让我们看看 Groovy 是如何处理的。 + +### 用 Groovy 解析 JSON + +Groovy 自带的 `groovy.json` 包，里面有各种很酷的东西。其中最好的部分是 `JsonSlurper` 类，它包括几个 `parse()` 方法，可以将 JSON 转换为 Groovy 的 `Map`，一种根据键值存储的数据结构。 + +下面是一个简短的 Groovy 程序，名为 `config1.groovy`，它创建了一个 `JsonSlurper` 实例，然后调用其中的 `parse()` 方法来解析文件中的 JSON，并将其转换名为 `config` 的 `Map` 实例，最后将该 map 输出： + + +``` +import groovy.json.JsonSlurper + +def jsonSlurper = new JsonSlurper() + +def config = jsonSlurper.parse(new File('config.json')) + +println "config = $config" +``` + +在终端的命令行上运行这个程序： + + +``` +$ groovy config1.groovy +config = [vm:[ip:192.168.44.44, memory:1024, synced_folders:[[host_path:data/, guest_path:/var/www, type:default]], forwarded_ports:[]], vdd:[sites:[drupal8:[account_name:root, account_pass:root, account_mail:[box@example.com][10], site_name:Drupal 8, site_mail:[box@example.com][10], vhost:[document_root:drupal8, url:drupal8.dev, alias:[www.drupal8.dev]]], drupal7:[account_name:root, account_pass:root, account_mail:[box@example.com][10], site_name:Drupal 7, site_mail:[box@example.com][10], vhost:[document_root:drupal7, url:drupal7.dev, alias:[www.drupal7.dev]]]]]] +$ +``` + +输出显示了一个有两个键的顶层 map：`vm` 和 `vdd`。每个键都引用了它自己的值的 map。注意 `forwarded_ports` 键所引用的空列表。 + +这很容易，但它所做的只是把东西打印出来。你是如何获得各种组件的呢？下面是另一个程序，显示如何访问存储在 `config.vm.ip` 的值： + + +``` +import groovy.json.JsonSlurper + +def jsonSlurper = new JsonSlurper() + +def config = jsonSlurper.parse(new File('config.json')) + +println "config.vm.ip = ${config.vm.ip}" +``` + +运行它： + + +``` +$ groovy config2.groovy +config.vm.ip = 192.168.44.44 +$ +``` + +是的，这也很容易。 这利用了 Groovy 速记，这意味着： + + +``` +`config.vm.ip` +``` + +在 Groovy 中等同于： + + +``` +`config['vm']['ip']` +``` + +当 `config `和 `config.vm` 都是 `Map` 的实例，并且都等同于: + + +``` +`config.get("vm").get("ip")` +``` + +在 Java 中。 + +仅仅是处理 JSON 就这么多了。如果你想有一个标准的配置并让用户覆盖它呢？在这种情况下，你可能想在程序中硬编码一个 JSON 配置，然后读取用户配置并覆盖任何标准配置的设置。 + +假设上面的配置是标准的，而用户只想覆盖其中的一点，只想覆盖 `vm` 结构中的 `ip` 和 `memory` 值，并把它放在 `userConfig.json` 文件中: + + +``` +{ + "vm": { + "ip": "201.201.201.201", + "memory": "4096", + } +} +``` + +你可以用这个程序来做： + +``` +import groovy.json.JsonSlurper + +def jsonSlurper = new JsonSlurper() + +// 使用parseText()来解析一个字符串，而不是从文件中读取。 +// 这给了我们一个“标准配置” + +def standardConfig = jsonSlurper.parseText(""" +{ + "vm": { + "ip": "192.168.44.44", + "memory": "1024", + "synced_folders": [ + { + "host_path": "data/", + "guest_path": "/var/www", + "type": "default" + } + ], + "forwarded_ports": [] + }, + "vdd": { + "sites": { + "drupal8": { + "account_name": "root", + "account_pass": "root", + "account_mail": "[box@example.com][10]", + "site_name": "Drupal 8", + "site_mail": "[box@example.com][10]", + "vhost": { + "document_root": "drupal8", + "url": "drupal8.dev", + "alias": ["www.drupal8.dev"] + } + }, + "drupal7": { + "account_name": "root", + "account_pass": "root", + "account_mail": "[box@example.com][10]", + "site_name": "Drupal 7", + "site_mail": "[box@example.com][10]", + "vhost": { + "document_root": "drupal7", + "url": "drupal7.dev", + "alias": ["www.drupal7.dev"] + } + } + } + } +} +""") + +// 打印标准配置 + +println "standardConfig = $standardConfig" + +//读入并解析用户配置信息 + +def userConfig = jsonSlurper.parse(new File('userConfig.json')) + +// 打印出用户配置信息 + +println "userConfig = $userConfig" + +// 一个将用户配置与标准配置合并的函数 + +def mergeMaps(Map input, Map merge) { + merge.each { k, v -> + if (v instanceof Map) + mergeMaps(input[k], v) + else + input[k] = v + } +} + +// 合并配置并打印出修改后的 +// 标准配置 + +mergeMaps(standardConfig, userConfig) + +println "modified standardConfig $standardConfig" +``` + +以下列方式运行： + + +``` +$ groovy config3.groovy +standardConfig = [vm:[ip:192.168.44.44, memory:1024, synced_folders:[[host_path:data/, guest_path:/var/www, type:default]], forwarded_ports:[]], vdd:[sites:[drupal8:[account_name:root, account_pass:root, account_mail:[box@example.com][10], site_name:Drupal 8, site_mail:[box@example.com][10], vhost:[document_root:drupal8, url:drupal8.dev, alias:[www.drupal8.dev]]], drupal7:[account_name:root, account_pass:root, account_mail:[box@example.com][10], site_name:Drupal 7, site_mail:[box@example.com][10], vhost:[document_root:drupal7, url:drupal7.dev, alias:[www.drupal7.dev]]]]]] +userConfig = [vm:[ip:201.201.201.201, memory:4096]] +modified standardConfig [vm:[ip:201.201.201.201, memory:4096, synced_folders:[[host_path:data/, guest_path:/var/www, type:default]], forwarded_ports:[]], vdd:[sites:[drupal8:[account_name:root, account_pass:root, account_mail:[box@example.com][10], site_name:Drupal 8, site_mail:[box@example.com][10], vhost:[document_root:drupal8, url:drupal8.dev, alias:[www.drupal8.dev]]], drupal7:[account_name:root, account_pass:root, account_mail:[box@example.com][10], site_name:Drupal 7, site_mail:[box@example.com][10], vhost:[document_root:drupal7, url:drupal7.dev, alias:[www.drupal7.dev]]]]]] +$ +``` + +以 `modified standardConfig` 开头的一行显示，`vm.ip` and `vm.memory` 的值被覆盖了。 + +眼尖的读者会注意到，我没有检查畸形的 JSON，也没有仔细确保用户的配置是有意义的（不创建新字段，提供合理的值，等等）。所以用这个递归方法来合并两个 map 在现实中可能并不那么实用。 + +好吧，我必须为家庭作业留下_一些_东西，不是吗？ + +### Groovy 资源 + +Apache Groovy 网站有很多很棒的[文档][11]。另一个很棒的 Groovy 资源是 [Mr. Haki][12]。学习 Groovy 的一个非常好的理由是继续学习 [Grails][13]，它是一个非常高效的全栈网络框架，建立在 Hibernate、Spring Boot 和 Micronaut 等优秀组件之上。 + +-------------------------------------------------------------------------------- + +via: https://opensource.com/article/21/6/groovy-parse-json + +作者：[Chris Hermansen][a] +选题：[lujun9972][b] +译者：[geekpi](https://github.com/geekpi) +校对：[校对者ID](https://github.com/校对者ID) + +本文由 [LCTT](https://github.com/LCTT/TranslateProject) 原创编译，[Linux中国](https://linux.cn/) 荣誉推出 + +[a]: https://opensource.com/users/clhermansen +[b]: https://github.com/lujun9972 +[1]: https://opensource.com/sites/default/files/styles/image-full-size/public/lead-images/look-binoculars-sight-see-review.png?itok=NOw2cm39 (Looking back with binoculars) +[2]: https://www.libreoffice.org/discover/writer/ +[3]: https://gitlab.gnome.org/GNOME/tracker +[4]: https://www.lucidchart.com/techblog/2018/07/16/why-json-isnt-a-good-configuration-language/ +[5]: https://medium.com/trabe/stop-using-json-config-files-ab9bc55d82fa +[6]: https://groovy-lang.org/ +[7]: https://groovy.apache.org/download.html +[8]: https://sdkman.io/ +[9]: https://www.drupal.org/node/2008800 +[10]: mailto:box@example.com +[11]: http://groovy-lang.org/documentation.html +[12]: https://blog.mrhaki.com/ +[13]: https://grails.org/