[1/2] incubator-tamaya git commit: Added release notes.
Repository: incubator-tamaya Updated Branches: refs/heads/0.1-incubating 5b0860fbc - 498093dd1 Added release notes. Project: http://git-wip-us.apache.org/repos/asf/incubator-tamaya/repo Commit: http://git-wip-us.apache.org/repos/asf/incubator-tamaya/commit/37a5de04 Tree: http://git-wip-us.apache.org/repos/asf/incubator-tamaya/tree/37a5de04 Diff: http://git-wip-us.apache.org/repos/asf/incubator-tamaya/diff/37a5de04 Branch: refs/heads/0.1-incubating Commit: 37a5de043888ceb3d8f0ac2b2161dc58a8a826e2 Parents: fa127c9 Author: anatole atsti...@gmail.com Authored: Thu Aug 6 01:53:18 2015 +0200 Committer: anatole atsti...@gmail.com Committed: Thu Aug 6 01:53:18 2015 +0200 -- readme/ReleaseNotes-0.1-incubating.html | 167 +++ 1 file changed, 167 insertions(+) -- http://git-wip-us.apache.org/repos/asf/incubator-tamaya/blob/37a5de04/readme/ReleaseNotes-0.1-incubating.html -- diff --git a/readme/ReleaseNotes-0.1-incubating.html b/readme/ReleaseNotes-0.1-incubating.html new file mode 100644 index 000..c37484c --- /dev/null +++ b/readme/ReleaseNotes-0.1-incubating.html @@ -0,0 +1,167 @@ +html +head +titleApache Tamaya 0.1-incubating Release Notes/title +/head +body +h1Apache Tamaya 0.1-incubating Release Notes/h1 + +h2Release Summary (6th August 2015)/h2 + +pThis is the first release of Apache Tamaya. It contains basically a rather complete base set of functionality for +use of Apache Tamaya in a Java SE context. Further support for Java EE is planned to be added within the next +releases. +Summarizing this release provides: +ul +liA complete SE based API for Java 7 and Java 8/li +liAn implementation of the API for Java 7 and Java 8./li +liNumerous extension modules that mainly depend on the Java 7 API only. So they are usable in both usage +environments. +/li +liA set of documentation./li +liA couple of simple examples for usage and extension./li +/ul +Feel free to give any kind of feedback to our team. Visit our project site a + href=http://tamaya.incubator.apache.org;http://tamaya.incubator.apache.org/a +for further details. +/p +h2 Sub-task +/h2 +ul +li[a href='https://issues.apache.org/jira/browse/TAMAYA-12'TAMAYA-12/a] - Integrate Tamaya in Apache#39;s +Sonarcube instance +/li +li[a href='https://issues.apache.org/jira/browse/TAMAYA-13'TAMAYA-13/a] - Integrate FindBugs in Tamaya#39;s +build chain +/li +li[a href='https://issues.apache.org/jira/browse/TAMAYA-17'TAMAYA-17/a] - Integrate RAT in Tamaya#39;s +build chain +/li +li[a href='https://issues.apache.org/jira/browse/TAMAYA-78'TAMAYA-78/a] - Adapt the jQAssistant rules for +services and service providers +/li +/ul + +h2 Bug +/h2 +ul +li[a href='https://issues.apache.org/jira/browse/TAMAYA-8'TAMAYA-8/a] - Add missing JavaDoc. +/li +li[a href='https://issues.apache.org/jira/browse/TAMAYA-14'TAMAYA-14/a] - Resource resolution does not +support ant path style +/li +li[a href='https://issues.apache.org/jira/browse/TAMAYA-15'TAMAYA-15/a] - Move PropertyProviders into API +part and add SPI +/li +li[a href='https://issues.apache.org/jira/browse/TAMAYA-16'TAMAYA-16/a] - Change AggregationPolicy to +functional interface +/li +li[a href='https://issues.apache.org/jira/browse/TAMAYA-26'TAMAYA-26/a] - PropertySourceBuilder creation +methods should be named #39;of#39; +/li +li[a href='https://issues.apache.org/jira/browse/TAMAYA-27'TAMAYA-27/a] - Problem when the OptionalBoolean +is used +/li +li[a href='https://issues.apache.org/jira/browse/TAMAYA-53'TAMAYA-53/a] - Build fails because of issues +found by FindBugs +/li +li[a href='https://issues.apache.org/jira/browse/TAMAYA-55'TAMAYA-55/a] - Parent POM should not assume +Java 8 +/li +li[a href='https://issues.apache.org/jira/browse/TAMAYA-57'TAMAYA-57/a] - Store URLs in a Collection may +result in performance issue +/li +li[a href='https://issues.apache.org/jira/browse/TAMAYA-64'TAMAYA-64/a] - JSON format module introduces +its own InputResource model +/li +li[a href='https://issues.apache.org/jira/browse/TAMAYA-68'TAMAYA-68/a] - Add ConfigurationContextBuilder +to being able to apply context changes. +/li +/ul + +h2 Improvement +/h2 +ul +li[a href='https://issues.apache.org/jira/browse/TAMAYA-1'TAMAYA-1/a] - Initial code dump +/li +li[a href='https://issues.apache.org/jira/browse/TAMAYA-5'TAMAYA-5/a] - Remove hard dependency on weld. +/li +li[a href='https://issues.apache.org/jira/browse/TAMAYA-6'TAMAYA-6/a] - Update to Apache Parent POM +
[2/2] incubator-tamaya git commit: Merge branch '0.1-incubating' of https://git-wip-us.apache.org/repos/asf/incubator-tamaya into 0.1-incubating
Merge branch '0.1-incubating' of https://git-wip-us.apache.org/repos/asf/incubator-tamaya into 0.1-incubating Project: http://git-wip-us.apache.org/repos/asf/incubator-tamaya/repo Commit: http://git-wip-us.apache.org/repos/asf/incubator-tamaya/commit/498093dd Tree: http://git-wip-us.apache.org/repos/asf/incubator-tamaya/tree/498093dd Diff: http://git-wip-us.apache.org/repos/asf/incubator-tamaya/diff/498093dd Branch: refs/heads/0.1-incubating Commit: 498093dd119e9531035b99675cac180a3919bfe5 Parents: 37a5de0 5b0860f Author: anatole atsti...@gmail.com Authored: Thu Aug 6 07:23:13 2015 +0200 Committer: anatole atsti...@gmail.com Committed: Thu Aug 6 07:23:13 2015 +0200 -- --
incubator-tamaya git commit: Added/updated missing documentation for JSON/builder extensions.
Repository: incubator-tamaya Updated Branches: refs/heads/0.1-incubating 2910da468 - fa127c9b5 Added/updated missing documentation for JSON/builder extensions. Project: http://git-wip-us.apache.org/repos/asf/incubator-tamaya/repo Commit: http://git-wip-us.apache.org/repos/asf/incubator-tamaya/commit/fa127c9b Tree: http://git-wip-us.apache.org/repos/asf/incubator-tamaya/tree/fa127c9b Diff: http://git-wip-us.apache.org/repos/asf/incubator-tamaya/diff/fa127c9b Branch: refs/heads/0.1-incubating Commit: fa127c9b5ef06ec37eed5929202d5afe8dc1f549 Parents: 2910da4 Author: anatole atsti...@gmail.com Authored: Thu Aug 6 01:24:28 2015 +0200 Committer: anatole atsti...@gmail.com Committed: Thu Aug 6 01:24:28 2015 +0200 -- docs/src/main/asciidoc/mod_builder.adoc | 75 - docs/src/main/asciidoc/mod_json.adoc| 98 docs/src/main/asciidoc/modules.adoc | 1 + 3 files changed, 172 insertions(+), 2 deletions(-) -- http://git-wip-us.apache.org/repos/asf/incubator-tamaya/blob/fa127c9b/docs/src/main/asciidoc/mod_builder.adoc -- diff --git a/docs/src/main/asciidoc/mod_builder.adoc b/docs/src/main/asciidoc/mod_builder.adoc index 02c3026..5e3d66c 100644 --- a/docs/src/main/asciidoc/mod_builder.adoc +++ b/docs/src/main/asciidoc/mod_builder.adoc @@ -41,8 +41,79 @@ toc::[] :numbered!: -[[Core]] +[[BuilderCore]] == Tamaya Builder (Extension Module) === Overview -TBW \ No newline at end of file +The Tamaya builder module provides a generic (one time) builder for creating +Configuration+ instances, +e.g. as follows: + +[source,java] +--- +ConfigurationBuilder builder = new ConfigurationBuilder(); +// do something +Configuration config = builder.build(); +--- + +Basically the builder allows to create configuration instances completely independent of the current configuration +setup. This gives you full control on the +Configuration+ setup. + +=== Compatibility + +The module is based on Java 8, so it will not run on Java 7. This might be not that bad, since the ++ConfigurationProvider+ as defined by the API, provides a builder instance for +ConfigurationContext+ +in a similar way. A +Configuration+ can also be created by passing an instance of a +ConfigurationContext+: + + +=== Installation + +To benefit from configuration builder support you only must add the corresponding dependency to your module: + +[source, xml] +--- +dependency + groupIdorg.apache.tamaya.ext/groupId + artifactIdtamaya-builder/artifactId + version{tamayaVersion}/version +/dependency +--- + +=== Supported Functionality + +The builder allows you to add +PropertySource+ instances: + +[source,java] + +ConfigurationBuilder builder = new ConfigurationBuilder(); +builder.addPropertySources(sourceOne).addPropertySources(sourceTwo); +Configuration config = builder.build(); + + +Similarly you can add filters: + +[source,java] + +builder.addPropertyFilters(new MyConfigFilter()); + + +...or +PropertySourceProvider+ instances: + +[source,java] + +builder.addPropertySourceProvider(new MyPropertySourceProvider()); + + +Also the builder module allows to include/exclude any filters and property source already known to the current ++ConfigurationContext+: + +[source,java] + +builder.disableProvidedPropertyConverters(); +builder.enableProvidedPropertyConverters(); + +builder.disableProvidedPropertyFilters(); +builder.enableProvidedPropertyFilters(); + +builder.disableProvidedPropertySources(); +builder.enableProvidedPropertySources(); + \ No newline at end of file http://git-wip-us.apache.org/repos/asf/incubator-tamaya/blob/fa127c9b/docs/src/main/asciidoc/mod_json.adoc -- diff --git a/docs/src/main/asciidoc/mod_json.adoc b/docs/src/main/asciidoc/mod_json.adoc new file mode 100644 index 000..8b2eace --- /dev/null +++ b/docs/src/main/asciidoc/mod_json.adoc @@ -0,0 +1,98 @@ += Apache Tamaya -- Extension: Builder + +:name: Tamaya +:rootpackage: org.apache.tamaya.builder +:title: Apache Tamaya Extension: JSON +:revnumber:
incubator-tamaya git commit: Added release notes.
Repository: incubator-tamaya Updated Branches: refs/heads/0.1-incubating fa127c9b5 - 5b0860fbc Added release notes. Project: http://git-wip-us.apache.org/repos/asf/incubator-tamaya/repo Commit: http://git-wip-us.apache.org/repos/asf/incubator-tamaya/commit/5b0860fb Tree: http://git-wip-us.apache.org/repos/asf/incubator-tamaya/tree/5b0860fb Diff: http://git-wip-us.apache.org/repos/asf/incubator-tamaya/diff/5b0860fb Branch: refs/heads/0.1-incubating Commit: 5b0860fbc74abfa885844b53254e1983ac14aaa5 Parents: fa127c9 Author: anatole atsti...@gmail.com Authored: Thu Aug 6 01:47:51 2015 +0200 Committer: anatole atsti...@gmail.com Committed: Thu Aug 6 01:47:51 2015 +0200 -- readme/ReleaseNotes-0.1-incubating.html | 167 +++ 1 file changed, 167 insertions(+) -- http://git-wip-us.apache.org/repos/asf/incubator-tamaya/blob/5b0860fb/readme/ReleaseNotes-0.1-incubating.html -- diff --git a/readme/ReleaseNotes-0.1-incubating.html b/readme/ReleaseNotes-0.1-incubating.html new file mode 100644 index 000..c37484c --- /dev/null +++ b/readme/ReleaseNotes-0.1-incubating.html @@ -0,0 +1,167 @@ +html +head +titleApache Tamaya 0.1-incubating Release Notes/title +/head +body +h1Apache Tamaya 0.1-incubating Release Notes/h1 + +h2Release Summary (6th August 2015)/h2 + +pThis is the first release of Apache Tamaya. It contains basically a rather complete base set of functionality for +use of Apache Tamaya in a Java SE context. Further support for Java EE is planned to be added within the next +releases. +Summarizing this release provides: +ul +liA complete SE based API for Java 7 and Java 8/li +liAn implementation of the API for Java 7 and Java 8./li +liNumerous extension modules that mainly depend on the Java 7 API only. So they are usable in both usage +environments. +/li +liA set of documentation./li +liA couple of simple examples for usage and extension./li +/ul +Feel free to give any kind of feedback to our team. Visit our project site a + href=http://tamaya.incubator.apache.org;http://tamaya.incubator.apache.org/a +for further details. +/p +h2 Sub-task +/h2 +ul +li[a href='https://issues.apache.org/jira/browse/TAMAYA-12'TAMAYA-12/a] - Integrate Tamaya in Apache#39;s +Sonarcube instance +/li +li[a href='https://issues.apache.org/jira/browse/TAMAYA-13'TAMAYA-13/a] - Integrate FindBugs in Tamaya#39;s +build chain +/li +li[a href='https://issues.apache.org/jira/browse/TAMAYA-17'TAMAYA-17/a] - Integrate RAT in Tamaya#39;s +build chain +/li +li[a href='https://issues.apache.org/jira/browse/TAMAYA-78'TAMAYA-78/a] - Adapt the jQAssistant rules for +services and service providers +/li +/ul + +h2 Bug +/h2 +ul +li[a href='https://issues.apache.org/jira/browse/TAMAYA-8'TAMAYA-8/a] - Add missing JavaDoc. +/li +li[a href='https://issues.apache.org/jira/browse/TAMAYA-14'TAMAYA-14/a] - Resource resolution does not +support ant path style +/li +li[a href='https://issues.apache.org/jira/browse/TAMAYA-15'TAMAYA-15/a] - Move PropertyProviders into API +part and add SPI +/li +li[a href='https://issues.apache.org/jira/browse/TAMAYA-16'TAMAYA-16/a] - Change AggregationPolicy to +functional interface +/li +li[a href='https://issues.apache.org/jira/browse/TAMAYA-26'TAMAYA-26/a] - PropertySourceBuilder creation +methods should be named #39;of#39; +/li +li[a href='https://issues.apache.org/jira/browse/TAMAYA-27'TAMAYA-27/a] - Problem when the OptionalBoolean +is used +/li +li[a href='https://issues.apache.org/jira/browse/TAMAYA-53'TAMAYA-53/a] - Build fails because of issues +found by FindBugs +/li +li[a href='https://issues.apache.org/jira/browse/TAMAYA-55'TAMAYA-55/a] - Parent POM should not assume +Java 8 +/li +li[a href='https://issues.apache.org/jira/browse/TAMAYA-57'TAMAYA-57/a] - Store URLs in a Collection may +result in performance issue +/li +li[a href='https://issues.apache.org/jira/browse/TAMAYA-64'TAMAYA-64/a] - JSON format module introduces +its own InputResource model +/li +li[a href='https://issues.apache.org/jira/browse/TAMAYA-68'TAMAYA-68/a] - Add ConfigurationContextBuilder +to being able to apply context changes. +/li +/ul + +h2 Improvement +/h2 +ul +li[a href='https://issues.apache.org/jira/browse/TAMAYA-1'TAMAYA-1/a] - Initial code dump +/li +li[a href='https://issues.apache.org/jira/browse/TAMAYA-5'TAMAYA-5/a] - Remove hard dependency on weld. +/li +li[a href='https://issues.apache.org/jira/browse/TAMAYA-6'TAMAYA-6/a] - Update to Apache Parent POM +
incubator-tamaya git commit: Added release notes for 0.1-incubating.
Repository: incubator-tamaya Updated Branches: refs/heads/master c1c1122ce - 7011d5de0 Added release notes for 0.1-incubating. Project: http://git-wip-us.apache.org/repos/asf/incubator-tamaya/repo Commit: http://git-wip-us.apache.org/repos/asf/incubator-tamaya/commit/7011d5de Tree: http://git-wip-us.apache.org/repos/asf/incubator-tamaya/tree/7011d5de Diff: http://git-wip-us.apache.org/repos/asf/incubator-tamaya/diff/7011d5de Branch: refs/heads/master Commit: 7011d5de053d7acb915a8ef8597df3c11e24d972 Parents: c1c1122 Author: anatole atsti...@gmail.com Authored: Thu Aug 6 01:49:07 2015 +0200 Committer: anatole atsti...@gmail.com Committed: Thu Aug 6 01:49:07 2015 +0200 -- readme/ReleaseNotes-0.1-incubating.html | 167 +++ 1 file changed, 167 insertions(+) -- http://git-wip-us.apache.org/repos/asf/incubator-tamaya/blob/7011d5de/readme/ReleaseNotes-0.1-incubating.html -- diff --git a/readme/ReleaseNotes-0.1-incubating.html b/readme/ReleaseNotes-0.1-incubating.html new file mode 100644 index 000..c37484c --- /dev/null +++ b/readme/ReleaseNotes-0.1-incubating.html @@ -0,0 +1,167 @@ +html +head +titleApache Tamaya 0.1-incubating Release Notes/title +/head +body +h1Apache Tamaya 0.1-incubating Release Notes/h1 + +h2Release Summary (6th August 2015)/h2 + +pThis is the first release of Apache Tamaya. It contains basically a rather complete base set of functionality for +use of Apache Tamaya in a Java SE context. Further support for Java EE is planned to be added within the next +releases. +Summarizing this release provides: +ul +liA complete SE based API for Java 7 and Java 8/li +liAn implementation of the API for Java 7 and Java 8./li +liNumerous extension modules that mainly depend on the Java 7 API only. So they are usable in both usage +environments. +/li +liA set of documentation./li +liA couple of simple examples for usage and extension./li +/ul +Feel free to give any kind of feedback to our team. Visit our project site a + href=http://tamaya.incubator.apache.org;http://tamaya.incubator.apache.org/a +for further details. +/p +h2 Sub-task +/h2 +ul +li[a href='https://issues.apache.org/jira/browse/TAMAYA-12'TAMAYA-12/a] - Integrate Tamaya in Apache#39;s +Sonarcube instance +/li +li[a href='https://issues.apache.org/jira/browse/TAMAYA-13'TAMAYA-13/a] - Integrate FindBugs in Tamaya#39;s +build chain +/li +li[a href='https://issues.apache.org/jira/browse/TAMAYA-17'TAMAYA-17/a] - Integrate RAT in Tamaya#39;s +build chain +/li +li[a href='https://issues.apache.org/jira/browse/TAMAYA-78'TAMAYA-78/a] - Adapt the jQAssistant rules for +services and service providers +/li +/ul + +h2 Bug +/h2 +ul +li[a href='https://issues.apache.org/jira/browse/TAMAYA-8'TAMAYA-8/a] - Add missing JavaDoc. +/li +li[a href='https://issues.apache.org/jira/browse/TAMAYA-14'TAMAYA-14/a] - Resource resolution does not +support ant path style +/li +li[a href='https://issues.apache.org/jira/browse/TAMAYA-15'TAMAYA-15/a] - Move PropertyProviders into API +part and add SPI +/li +li[a href='https://issues.apache.org/jira/browse/TAMAYA-16'TAMAYA-16/a] - Change AggregationPolicy to +functional interface +/li +li[a href='https://issues.apache.org/jira/browse/TAMAYA-26'TAMAYA-26/a] - PropertySourceBuilder creation +methods should be named #39;of#39; +/li +li[a href='https://issues.apache.org/jira/browse/TAMAYA-27'TAMAYA-27/a] - Problem when the OptionalBoolean +is used +/li +li[a href='https://issues.apache.org/jira/browse/TAMAYA-53'TAMAYA-53/a] - Build fails because of issues +found by FindBugs +/li +li[a href='https://issues.apache.org/jira/browse/TAMAYA-55'TAMAYA-55/a] - Parent POM should not assume +Java 8 +/li +li[a href='https://issues.apache.org/jira/browse/TAMAYA-57'TAMAYA-57/a] - Store URLs in a Collection may +result in performance issue +/li +li[a href='https://issues.apache.org/jira/browse/TAMAYA-64'TAMAYA-64/a] - JSON format module introduces +its own InputResource model +/li +li[a href='https://issues.apache.org/jira/browse/TAMAYA-68'TAMAYA-68/a] - Add ConfigurationContextBuilder +to being able to apply context changes. +/li +/ul + +h2 Improvement +/h2 +ul +li[a href='https://issues.apache.org/jira/browse/TAMAYA-1'TAMAYA-1/a] - Initial code dump +/li +li[a href='https://issues.apache.org/jira/browse/TAMAYA-5'TAMAYA-5/a] - Remove hard dependency on weld. +/li +li[a href='https://issues.apache.org/jira/browse/TAMAYA-6'TAMAYA-6/a] - Update to Apache Parent POM +
[1/2] incubator-tamaya git commit: TAMAYA-82: Added doc for builder module.
Repository: incubator-tamaya Updated Branches: refs/heads/master d0682eae6 - c1c1122ce TAMAYA-82: Added doc for builder module. Project: http://git-wip-us.apache.org/repos/asf/incubator-tamaya/repo Commit: http://git-wip-us.apache.org/repos/asf/incubator-tamaya/commit/96d8066f Tree: http://git-wip-us.apache.org/repos/asf/incubator-tamaya/tree/96d8066f Diff: http://git-wip-us.apache.org/repos/asf/incubator-tamaya/diff/96d8066f Branch: refs/heads/master Commit: 96d8066f7bad48cf6b52de35e2926f3f1af65390 Parents: d0682ea Author: anatole atsti...@gmail.com Authored: Thu Aug 6 00:38:13 2015 +0200 Committer: anatole atsti...@gmail.com Committed: Thu Aug 6 00:38:13 2015 +0200 -- docs/src/main/asciidoc/mod_builder.adoc | 75 +++- 1 file changed, 73 insertions(+), 2 deletions(-) -- http://git-wip-us.apache.org/repos/asf/incubator-tamaya/blob/96d8066f/docs/src/main/asciidoc/mod_builder.adoc -- diff --git a/docs/src/main/asciidoc/mod_builder.adoc b/docs/src/main/asciidoc/mod_builder.adoc index 02c3026..5e3d66c 100644 --- a/docs/src/main/asciidoc/mod_builder.adoc +++ b/docs/src/main/asciidoc/mod_builder.adoc @@ -41,8 +41,79 @@ toc::[] :numbered!: -[[Core]] +[[BuilderCore]] == Tamaya Builder (Extension Module) === Overview -TBW \ No newline at end of file +The Tamaya builder module provides a generic (one time) builder for creating +Configuration+ instances, +e.g. as follows: + +[source,java] +--- +ConfigurationBuilder builder = new ConfigurationBuilder(); +// do something +Configuration config = builder.build(); +--- + +Basically the builder allows to create configuration instances completely independent of the current configuration +setup. This gives you full control on the +Configuration+ setup. + +=== Compatibility + +The module is based on Java 8, so it will not run on Java 7. This might be not that bad, since the ++ConfigurationProvider+ as defined by the API, provides a builder instance for +ConfigurationContext+ +in a similar way. A +Configuration+ can also be created by passing an instance of a +ConfigurationContext+: + + +=== Installation + +To benefit from configuration builder support you only must add the corresponding dependency to your module: + +[source, xml] +--- +dependency + groupIdorg.apache.tamaya.ext/groupId + artifactIdtamaya-builder/artifactId + version{tamayaVersion}/version +/dependency +--- + +=== Supported Functionality + +The builder allows you to add +PropertySource+ instances: + +[source,java] + +ConfigurationBuilder builder = new ConfigurationBuilder(); +builder.addPropertySources(sourceOne).addPropertySources(sourceTwo); +Configuration config = builder.build(); + + +Similarly you can add filters: + +[source,java] + +builder.addPropertyFilters(new MyConfigFilter()); + + +...or +PropertySourceProvider+ instances: + +[source,java] + +builder.addPropertySourceProvider(new MyPropertySourceProvider()); + + +Also the builder module allows to include/exclude any filters and property source already known to the current ++ConfigurationContext+: + +[source,java] + +builder.disableProvidedPropertyConverters(); +builder.enableProvidedPropertyConverters(); + +builder.disableProvidedPropertyFilters(); +builder.enableProvidedPropertyFilters(); + +builder.disableProvidedPropertySources(); +builder.enableProvidedPropertySources(); + \ No newline at end of file
[2/2] incubator-tamaya git commit: TAMAYA-82: Added doc for json module.
TAMAYA-82: Added doc for json module. Project: http://git-wip-us.apache.org/repos/asf/incubator-tamaya/repo Commit: http://git-wip-us.apache.org/repos/asf/incubator-tamaya/commit/c1c1122c Tree: http://git-wip-us.apache.org/repos/asf/incubator-tamaya/tree/c1c1122c Diff: http://git-wip-us.apache.org/repos/asf/incubator-tamaya/diff/c1c1122c Branch: refs/heads/master Commit: c1c1122cec6fde37c9bed5b6b96e2a7e38a0a602 Parents: 96d8066 Author: anatole atsti...@gmail.com Authored: Thu Aug 6 00:50:06 2015 +0200 Committer: anatole atsti...@gmail.com Committed: Thu Aug 6 00:50:06 2015 +0200 -- docs/src/main/asciidoc/mod_json.adoc | 98 +++ docs/src/main/asciidoc/modules.adoc | 1 + 2 files changed, 99 insertions(+) -- http://git-wip-us.apache.org/repos/asf/incubator-tamaya/blob/c1c1122c/docs/src/main/asciidoc/mod_json.adoc -- diff --git a/docs/src/main/asciidoc/mod_json.adoc b/docs/src/main/asciidoc/mod_json.adoc new file mode 100644 index 000..8b2eace --- /dev/null +++ b/docs/src/main/asciidoc/mod_json.adoc @@ -0,0 +1,98 @@ += Apache Tamaya -- Extension: Builder + +:name: Tamaya +:rootpackage: org.apache.tamaya.builder +:title: Apache Tamaya Extension: JSON +:revnumber: 0.1.1 +:revremark: Incubator +:revdate: March 2015 +:longversion: {revnumber} ({revremark}) {revdate} +:authorinitials: ATR +:author: Anatole Tresch +:email: anat...@apache.org +:source-highlighter: coderay +:website: http://tamaya.incubator.apache.org/ +:toc: +:toc-placement: manual +:encoding: UTF-8 +:numbered: +// Licensed to the Apache Software Foundation (ASF) under one +// or more contributor license agreements. See the NOTICE file +// distributed with this work for additional information +// regarding copyright ownership. The ASF licenses this file +// to you under the Apache License, Version 2.0 (the +// License); you may not use this file except in compliance +// with the License. You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, +// software distributed under the License is distributed on an +// AS IS BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +// KIND, either express or implied. See the License for the +// specific language governing permissions and limitations +// under the License. +''' + + + +toc::[] + + +:numbered!: + +[[BuilderCore]] +== Tamaya JSON (Extension Module) +=== Overview + +The Tamaya json module provides support for reading configuration using the JSON format: + + +=== Compatibility + +The module is based on Java 7, so it will not run on Java 7 and beyond. + + +=== Installation + +To benefit from configuration builder support you only must add the corresponding dependency to your module: + +[source, xml] +--- +dependency + groupIdorg.apache.tamaya.ext/groupId + artifactIdtamaya-json/artifactId + version{tamayaVersion}/version +/dependency +--- + + +=== Reading configuration in JSON + +For reading JSON based onfiguration most easily a +JSONFormat+ can be provided: + +[source, java] +--- +ConfigurationData dataRead = ConfigurationFormats.readConfig( +getClassLoader().getResource(myFileConfig.json), new JSonFOrmat())); +--- + +=== Examples + +The JSON module adds instances of +ConfigurationFormat+ so JSON configuration can be read and mapped to the +according property maps. E.g. the following file is a simple and correct JSON configuration: + +[source,listing] + +{ + a : A, + b : B, + c : C, + d : { + o : O, + p : P +} +} + + + http://git-wip-us.apache.org/repos/asf/incubator-tamaya/blob/c1c1122c/docs/src/main/asciidoc/modules.adoc -- diff --git a/docs/src/main/asciidoc/modules.adoc b/docs/src/main/asciidoc/modules.adoc index e76c408..064560b 100644 --- a/docs/src/main/asciidoc/modules.adoc +++ b/docs/src/main/asciidoc/modules.adoc @@ -61,6 +61,7 @@ NOTE All extensions, despite the _tamaya-builder_ module, currently run on Java |+org.apache.tamaya.ext:tamaya-events+|Provides support for publishing configuration changes |link:mod_events.html[Documentation] |+org.apache.tamaya.ext:tamaya-formats+ |Provides an abstract model for configuration formats |link:mod_formats.html[Documentation] |+org.apache.tamaya.ext:tamaya-injection+ |Provides configuration injection services and congiruation template support. |link:mod_injection.html[Documentation]
Build failed in Jenkins: Tamaya-Master-branch #347
See https://builds.apache.org/job/Tamaya-Master-branch/347/changes Changes: [anatole] Added release notes for 0.1-incubating. -- [...truncated 354 lines...] [INFO] Exclude: **/*.md [INFO] 3 resources included (use -debug for more details) [INFO] Rat check: Summary of files. Unapproved: 0 unknown: 0 generated: 0 approved: 3 licence. [WARNING] Failed to getClass for org.apache.maven.plugin.source.SourceJarMojo [INFO] [INFO] maven-source-plugin:2.4:jar (source-jar) @ buildconfigurations [INFO] [INFO] --- maven-source-plugin:2.4:jar (source-jar) @ buildconfigurations --- [INFO] Building jar: https://builds.apache.org/job/Tamaya-Master-branch/ws/buildconfigurations/target/buildconfigurations-0.1-incubating-SNAPSHOT-sources.jar [INFO] [INFO] --- maven-failsafe-plugin:2.18.1:integration-test (default) @ buildconfigurations --- [INFO] Tests are skipped. [INFO] [INFO] --- maven-failsafe-plugin:2.18.1:verify (default) @ buildconfigurations --- [INFO] Tests are skipped. [INFO] [INFO] --- maven-install-plugin:2.5.2:install (default-install) @ buildconfigurations --- [INFO] Installing https://builds.apache.org/job/Tamaya-Master-branch/ws/buildconfigurations/target/buildconfigurations-0.1-incubating-SNAPSHOT.jar to /home/jenkins/jenkins-slave/maven-repositories/0/org/apache/tamaya/buildconfigurations/0.1-incubating-SNAPSHOT/buildconfigurations-0.1-incubating-SNAPSHOT.jar [INFO] Installing https://builds.apache.org/job/Tamaya-Master-branch/ws/buildconfigurations/pom.xml to /home/jenkins/jenkins-slave/maven-repositories/0/org/apache/tamaya/buildconfigurations/0.1-incubating-SNAPSHOT/buildconfigurations-0.1-incubating-SNAPSHOT.pom [INFO] Installing https://builds.apache.org/job/Tamaya-Master-branch/ws/buildconfigurations/target/buildconfigurations-0.1-incubating-SNAPSHOT-sources.jar to /home/jenkins/jenkins-slave/maven-repositories/0/org/apache/tamaya/buildconfigurations/0.1-incubating-SNAPSHOT/buildconfigurations-0.1-incubating-SNAPSHOT-sources.jar [INFO] [INFO] --- maven-deploy-plugin:2.8.2:deploy (default-deploy) @ buildconfigurations --- [INFO] Downloading: https://repository.apache.org/content/repositories/snapshots/org/apache/tamaya/buildconfigurations/0.1-incubating-SNAPSHOT/maven-metadata.xml [INFO] Downloaded: https://repository.apache.org/content/repositories/snapshots/org/apache/tamaya/buildconfigurations/0.1-incubating-SNAPSHOT/maven-metadata.xml (2 KB at 6.6 KB/sec) [INFO] Uploading: https://repository.apache.org/content/repositories/snapshots/org/apache/tamaya/buildconfigurations/0.1-incubating-SNAPSHOT/buildconfigurations-0.1-incubating-20150806.001412-200.jar [INFO] Uploaded: https://repository.apache.org/content/repositories/snapshots/org/apache/tamaya/buildconfigurations/0.1-incubating-SNAPSHOT/buildconfigurations-0.1-incubating-20150806.001412-200.jar (9 KB at 105.6 KB/sec) [INFO] Uploading: https://repository.apache.org/content/repositories/snapshots/org/apache/tamaya/buildconfigurations/0.1-incubating-SNAPSHOT/buildconfigurations-0.1-incubating-20150806.001412-200.pom [INFO] Uploaded: https://repository.apache.org/content/repositories/snapshots/org/apache/tamaya/buildconfigurations/0.1-incubating-SNAPSHOT/buildconfigurations-0.1-incubating-20150806.001412-200.pom (2 KB at 32.4 KB/sec) [INFO] Downloading: https://repository.apache.org/content/repositories/snapshots/org/apache/tamaya/buildconfigurations/maven-metadata.xml [INFO] Downloaded: https://repository.apache.org/content/repositories/snapshots/org/apache/tamaya/buildconfigurations/maven-metadata.xml (354 B at 1.4 KB/sec) [INFO] Uploading: https://repository.apache.org/content/repositories/snapshots/org/apache/tamaya/buildconfigurations/0.1-incubating-SNAPSHOT/maven-metadata.xml [INFO] Uploaded: https://repository.apache.org/content/repositories/snapshots/org/apache/tamaya/buildconfigurations/0.1-incubating-SNAPSHOT/maven-metadata.xml (2 KB at 23.7 KB/sec) [INFO] Uploading: https://repository.apache.org/content/repositories/snapshots/org/apache/tamaya/buildconfigurations/maven-metadata.xml [INFO] Uploaded: https://repository.apache.org/content/repositories/snapshots/org/apache/tamaya/buildconfigurations/maven-metadata.xml (354 B at 7.9 KB/sec) [INFO] Uploading: https://repository.apache.org/content/repositories/snapshots/org/apache/tamaya/buildconfigurations/0.1-incubating-SNAPSHOT/buildconfigurations-0.1-incubating-20150806.001412-200-sources.jar [INFO] Uploaded: https://repository.apache.org/content/repositories/snapshots/org/apache/tamaya/buildconfigurations/0.1-incubating-SNAPSHOT/buildconfigurations-0.1-incubating-20150806.001412-200-sources.jar (9 KB at 177.2 KB/sec) [INFO] Uploading: https://repository.apache.org/content/repositories/snapshots/org/apache/tamaya/buildconfigurations/0.1-incubating-SNAPSHOT/maven-metadata.xml [INFO] Uploaded: