You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@tamaya.apache.org by po...@apache.org on 2018/01/25 22:04:27 UTC
[01/12] incubator-tamaya git commit: TAMAYA-321: Fix javadoc.
Repository: incubator-tamaya
Updated Branches:
refs/heads/configjsr 97bd06a71 -> cd37ae9c4
TAMAYA-321: Fix javadoc.
Project: http://git-wip-us.apache.org/repos/asf/incubator-tamaya/repo
Commit: http://git-wip-us.apache.org/repos/asf/incubator-tamaya/commit/61845038
Tree: http://git-wip-us.apache.org/repos/asf/incubator-tamaya/tree/61845038
Diff: http://git-wip-us.apache.org/repos/asf/incubator-tamaya/diff/61845038
Branch: refs/heads/configjsr
Commit: 61845038374217f1029adcf6ab36162b33479145
Parents: 27c0d76
Author: Phil Ottlinger <po...@apache.org>
Authored: Mon Nov 27 21:40:42 2017 +0100
Committer: Phil Ottlinger <po...@apache.org>
Committed: Mon Nov 27 21:40:42 2017 +0100
----------------------------------------------------------------------
.../java/org/apache/tamaya/Configuration.java | 32 ++++++++++----------
1 file changed, 16 insertions(+), 16 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/incubator-tamaya/blob/61845038/code/api/src/main/java/org/apache/tamaya/Configuration.java
----------------------------------------------------------------------
diff --git a/code/api/src/main/java/org/apache/tamaya/Configuration.java b/code/api/src/main/java/org/apache/tamaya/Configuration.java
index b891d43..b00eebd 100644
--- a/code/api/src/main/java/org/apache/tamaya/Configuration.java
+++ b/code/api/src/main/java/org/apache/tamaya/Configuration.java
@@ -25,13 +25,13 @@ import java.util.Map;
/**
- * <p>A configuration models a aggregated set current properties, identified by
+ * <p>A configuration models an aggregated set of current properties, identified by
* a unique key, but adds higher level access functions to
* a {@link org.apache.tamaya.spi.PropertySource}. Hereby in most
* cases a configuration is a wrapper around a composite
* {@link org.apache.tamaya.spi.PropertySource} instance, which may combine
- * multiple child config in well defined tree like structure,
- * where nodes define logically the rules current priority, filtering,
+ * multiple child configurations in a well defined tree like structure,
+ * where nodes define logically the rules' current priority, filtering,
* combination and overriding.
* </p>
* <h3>Implementation Requirements</h3>
@@ -43,7 +43,7 @@ import java.util.Map;
*
* <p>It is not recommended that implementations also are serializable, since the any configuration can be <i>frozen</i>
* by reading out its complete configuration map into a serializable and remotable structure. This helps significantly
- * simplifying the development current this interface, e.g. for being backed up by systems and stores that are not part current
+ * simplifying the development of this interface, e.g. for being backed up by systems and stores that are not part
* this library at all.</p>
*/
public interface Configuration {
@@ -70,12 +70,12 @@ public interface Configuration {
}
/**
- * Get the property keys as type T. This will implicitly require a corresponding {@link
- * org.apache.tamaya.spi.PropertyConverter} to be available that is capable current providing type T
- * fromMap the given String keys.
+ * Gets the property keys as type T. This will implicitly require a corresponding {@link
+ * org.apache.tamaya.spi.PropertyConverter} to be available that is capable of providing type T
+ * fromMap for the given String keys.
*
* @param <T> the type of the class modeled by the type parameter
- * @param key the property's absolute, or relative path, e.g. @code
+ * @param key the property's absolute, or relative path, e.g. {@code
* a/b/c/d.myProperty}, not {@code null}.
* @param type The target type required, not {@code null}.
* @param defaultValue value to be used, if no value is present, not {@code null}
@@ -87,9 +87,9 @@ public interface Configuration {
}
/**
- * Get the property keys as type T. This will implicitly require a corresponding {@link
- * org.apache.tamaya.spi.PropertyConverter} to be available that is capable current providing type T
- * fromMap the given String keys.
+ * Gets the property keys as type T. This will implicitly require a corresponding {@link
+ * org.apache.tamaya.spi.PropertyConverter} to be available that is capable of providing type T
+ * fromMap for the given String keys.
*
* @param <T> the type of the class modeled by the type parameter
* @param key the property's absolute, or relative path, e.g. @code
@@ -104,8 +104,8 @@ public interface Configuration {
/**
* Get the property keys as type T. This will implicitly require a corresponding {@link
- * org.apache.tamaya.spi.PropertyConverter} to be available that is capable current providing type T
- * fromMap the given String keys.
+ * org.apache.tamaya.spi.PropertyConverter} to be available that is capable of providing type T
+ * literals for the given key.
*
* @param <T> the type of the type literal
* @param key the property's absolute, or relative path, e.g. @code
@@ -118,8 +118,8 @@ public interface Configuration {
/**
* Get the property keys as type T. This will implicitly require a corresponding {@link
- * org.apache.tamaya.spi.PropertyConverter} to be available that is capable current providing type T
- * fromMap the given String keys.
+ * org.apache.tamaya.spi.PropertyConverter} to be available that is capable of providing type T
+ * literals for the given key.
*
* @param <T> the type of the type literal
* @param key the property's absolute, or relative path, e.g.
@@ -134,7 +134,7 @@ public interface Configuration {
/**
* Access all currently known configuration properties as a full {@code Map<String,String>}.
* Be aware that entries from non scannable parts of the registered {@link org.apache.tamaya.spi.PropertySource}
- * instances may not be contained in the result, but nevertheless be accessible calling one of the
+ * instances may not be contained in the result, but nevertheless be accessible by calling one of the
* {@code get(...)} methods.
* @return all currently known configuration properties.
*/
[06/12] incubator-tamaya git commit: Show Travis baadge on github.
Posted by po...@apache.org.
Show Travis baadge on github.
Project: http://git-wip-us.apache.org/repos/asf/incubator-tamaya/repo
Commit: http://git-wip-us.apache.org/repos/asf/incubator-tamaya/commit/0af44807
Tree: http://git-wip-us.apache.org/repos/asf/incubator-tamaya/tree/0af44807
Diff: http://git-wip-us.apache.org/repos/asf/incubator-tamaya/diff/0af44807
Branch: refs/heads/configjsr
Commit: 0af44807200ea61f4891e516fb59cbcbab7f75b3
Parents: 30506a4
Author: Phil Ottlinger <po...@apache.org>
Authored: Thu Jan 4 23:18:44 2018 +0100
Committer: Phil Ottlinger <po...@apache.org>
Committed: Thu Jan 4 23:18:44 2018 +0100
----------------------------------------------------------------------
README.md | 7 +++++++
1 file changed, 7 insertions(+)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/incubator-tamaya/blob/0af44807/README.md
----------------------------------------------------------------------
diff --git a/README.md b/README.md
index 22bb2e6..6802567 100644
--- a/README.md
+++ b/README.md
@@ -22,9 +22,16 @@ More information on Tamaya can be found on the [homepage of Apache Tamaya](https
The Apache Tamaya project is built with [Maven 3](https://maven.apache.org/) and [Java 8](https://java.sun.com/), so you need JDK >=1.8 and a reasonable version of maven
installed on your computer.
+## Local builds
Then you can build Tamaya via:
```
$ export MAVEN_OPTS="-Xmx512m -XX:PermGenSpace=200m"
$ mvn
```
+
+### Travis / CI
+
+Apart from integration into ASF CI there's a travis build:
+
+[![Build Status](https://travis-ci.org/apache/incubator-tamaya.svg?branch=master)](https://travis-ci.org/apache/incubator-tamaya/branches)
[10/12] incubator-tamaya git commit: Merge branch 'master' of
https://git-wip-us.apache.org/repos/asf/incubator-tamaya
Posted by po...@apache.org.
Merge branch 'master' of https://git-wip-us.apache.org/repos/asf/incubator-tamaya
Project: http://git-wip-us.apache.org/repos/asf/incubator-tamaya/repo
Commit: http://git-wip-us.apache.org/repos/asf/incubator-tamaya/commit/3f525044
Tree: http://git-wip-us.apache.org/repos/asf/incubator-tamaya/tree/3f525044
Diff: http://git-wip-us.apache.org/repos/asf/incubator-tamaya/diff/3f525044
Branch: refs/heads/configjsr
Commit: 3f52504407ad4f3d1806fb1e684475069da7962f
Parents: 3f6b34a 014001b
Author: Phil Ottlinger <po...@apache.org>
Authored: Mon Jan 8 20:33:25 2018 +0100
Committer: Phil Ottlinger <po...@apache.org>
Committed: Mon Jan 8 20:33:25 2018 +0100
----------------------------------------------------------------------
----------------------------------------------------------------------
[09/12] incubator-tamaya git commit: TAMAYA-258: Downgrade to pitest
1.2
Posted by po...@apache.org.
TAMAYA-258: Downgrade to pitest 1.2
v1.3 gives strange test errors.
Project: http://git-wip-us.apache.org/repos/asf/incubator-tamaya/repo
Commit: http://git-wip-us.apache.org/repos/asf/incubator-tamaya/commit/3f6b34a0
Tree: http://git-wip-us.apache.org/repos/asf/incubator-tamaya/tree/3f6b34a0
Diff: http://git-wip-us.apache.org/repos/asf/incubator-tamaya/diff/3f6b34a0
Branch: refs/heads/configjsr
Commit: 3f6b34a0246b752a443f576c1ac94db4a2614350
Parents: adc1096
Author: Phil Ottlinger <po...@apache.org>
Authored: Mon Jan 8 20:24:59 2018 +0100
Committer: Phil Ottlinger <po...@apache.org>
Committed: Mon Jan 8 20:33:12 2018 +0100
----------------------------------------------------------------------
pom.xml | 3 ++-
1 file changed, 2 insertions(+), 1 deletion(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/incubator-tamaya/blob/3f6b34a0/pom.xml
----------------------------------------------------------------------
diff --git a/pom.xml b/pom.xml
index 18adb6a..8169ba5 100644
--- a/pom.xml
+++ b/pom.xml
@@ -55,7 +55,8 @@
<asciidoctor-diagramm.version>1.2.1</asciidoctor-diagramm.version>
<asciidoctorj.version>1.5.2</asciidoctorj.version>
<checkstyle.version>2.15</checkstyle.version>
- <pitest-plugin.version>1.3.1</pitest-plugin.version>
+ <!-- 201801: v1.3.x gives strange test errors -->
+ <pitest-plugin.version>1.2.5</pitest-plugin.version>
<enforcer.version>1.4.1</enforcer.version>
<gem.plugin>1.0.7</gem.plugin>
<sources.plugin>3.0.1</sources.plugin>
[08/12] incubator-tamaya git commit: TAMAYA-258: Downgrad to pitest
1.2
Posted by po...@apache.org.
TAMAYA-258: Downgrad to pitest 1.2
v1.3 gives strange test errors.
Project: http://git-wip-us.apache.org/repos/asf/incubator-tamaya/repo
Commit: http://git-wip-us.apache.org/repos/asf/incubator-tamaya/commit/014001b5
Tree: http://git-wip-us.apache.org/repos/asf/incubator-tamaya/tree/014001b5
Diff: http://git-wip-us.apache.org/repos/asf/incubator-tamaya/diff/014001b5
Branch: refs/heads/configjsr
Commit: 014001b52fbd915dd4d2b76fa11f247cb4098e0c
Parents: adc1096
Author: Phil Ottlinger <po...@apache.org>
Authored: Mon Jan 8 20:24:59 2018 +0100
Committer: Phil Ottlinger <po...@apache.org>
Committed: Mon Jan 8 20:24:59 2018 +0100
----------------------------------------------------------------------
pom.xml | 3 ++-
1 file changed, 2 insertions(+), 1 deletion(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/incubator-tamaya/blob/014001b5/pom.xml
----------------------------------------------------------------------
diff --git a/pom.xml b/pom.xml
index 18adb6a..8169ba5 100644
--- a/pom.xml
+++ b/pom.xml
@@ -55,7 +55,8 @@
<asciidoctor-diagramm.version>1.2.1</asciidoctor-diagramm.version>
<asciidoctorj.version>1.5.2</asciidoctorj.version>
<checkstyle.version>2.15</checkstyle.version>
- <pitest-plugin.version>1.3.1</pitest-plugin.version>
+ <!-- 201801: v1.3.x gives strange test errors -->
+ <pitest-plugin.version>1.2.5</pitest-plugin.version>
<enforcer.version>1.4.1</enforcer.version>
<gem.plugin>1.0.7</gem.plugin>
<sources.plugin>3.0.1</sources.plugin>
[04/12] incubator-tamaya git commit: TAMAYA-321: Adapt threshold to
current state.
Posted by po...@apache.org.
TAMAYA-321: Adapt threshold to current state.
Project: http://git-wip-us.apache.org/repos/asf/incubator-tamaya/repo
Commit: http://git-wip-us.apache.org/repos/asf/incubator-tamaya/commit/502444fa
Tree: http://git-wip-us.apache.org/repos/asf/incubator-tamaya/tree/502444fa
Diff: http://git-wip-us.apache.org/repos/asf/incubator-tamaya/diff/502444fa
Branch: refs/heads/configjsr
Commit: 502444fa18e2ab6ea61db34b7f2b900a327d3cb0
Parents: a2bdb02
Author: Phil Ottlinger <po...@apache.org>
Authored: Mon Nov 27 21:48:59 2017 +0100
Committer: Phil Ottlinger <po...@apache.org>
Committed: Mon Nov 27 21:48:59 2017 +0100
----------------------------------------------------------------------
pom.xml | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/incubator-tamaya/blob/502444fa/pom.xml
----------------------------------------------------------------------
diff --git a/pom.xml b/pom.xml
index 6865c09..76ba4cb 100644
--- a/pom.xml
+++ b/pom.xml
@@ -325,7 +325,7 @@
<artifactId>pitest-maven</artifactId>
<version>${pitest-plugin.version}</version>
<configuration>
- <mutationThreshold>42</mutationThreshold>
+ <mutationThreshold>38</mutationThreshold>
<timestampedReports>false</timestampedReports>
<targetClasses>
<param>org.apache.tamaya.*</param>
[12/12] incubator-tamaya git commit: Merge remote-tracking branch
'origin/master' into configjsr
Posted by po...@apache.org.
Merge remote-tracking branch 'origin/master' into configjsr
Project: http://git-wip-us.apache.org/repos/asf/incubator-tamaya/repo
Commit: http://git-wip-us.apache.org/repos/asf/incubator-tamaya/commit/cd37ae9c
Tree: http://git-wip-us.apache.org/repos/asf/incubator-tamaya/tree/cd37ae9c
Diff: http://git-wip-us.apache.org/repos/asf/incubator-tamaya/diff/cd37ae9c
Branch: refs/heads/configjsr
Commit: cd37ae9c4aae265a5dd2435240b8ca93759c4fd6
Parents: 97bd06a d6229de
Author: Phil Ottlinger <po...@apache.org>
Authored: Thu Jan 25 23:04:16 2018 +0100
Committer: Phil Ottlinger <po...@apache.org>
Committed: Thu Jan 25 23:04:16 2018 +0100
----------------------------------------------------------------------
README.md | 7 +++++
.../apache/tamaya/ConfigurationProvider.java | 4 +--
.../java/org/apache/tamaya/Configuration.java | 32 ++++++++++----------
.../apache/tamaya/spi/ConfigurationBuilder.java | 9 +++---
pom.xml | 18 +++++------
5 files changed, 38 insertions(+), 32 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/incubator-tamaya/blob/cd37ae9c/code/compat/src/main/java/org/apache/tamaya/ConfigurationProvider.java
----------------------------------------------------------------------
diff --cc code/compat/src/main/java/org/apache/tamaya/ConfigurationProvider.java
index bacb944,0000000..9eae5af
mode 100644,000000..100644
--- a/code/compat/src/main/java/org/apache/tamaya/ConfigurationProvider.java
+++ b/code/compat/src/main/java/org/apache/tamaya/ConfigurationProvider.java
@@@ -1,138 -1,0 +1,138 @@@
+/*
+ * 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.
+ */
+package org.apache.tamaya;
+
+import org.apache.tamaya.spi.*;
+
+import java.util.logging.Logger;
+
+/**
- * Static access to the {@link Configuration} for the very application.
++ * Static access to the {@link Configuration} of the whole application.
+ */
+public final class ConfigurationProvider {
+
+ private static final Logger LOG = Logger.getLogger(ConfigurationProvider.class.getName());
+
+ private static ConfigurationProviderSpi spi() {
+ ConfigurationProviderSpi spi = ServiceContextManager.getServiceContext()
+ .getService(ConfigurationProviderSpi.class);
+ if(spi==null){
+ throw new IllegalStateException("ConfigurationProviderSpi not available.");
+ }
+ return spi;
+ }
+
+ private ConfigurationProvider() {
+ // just to prevent initialisation
+ }
+
+ /**
+ * Access the current configuration.
+ *
+ * @return the corresponding Configuration instance, never {@code null}.
+ */
+ public static Configuration getConfiguration() {
+ return spi().getConfiguration();
+ }
+
+ /**
+ * Creates a new configuration instance based on the given context.
+ *
+ * @param context the configuration context, not {@code null}.
+ * @return a new Configuration instance, never {@code null}.
+ */
+ public static Configuration createConfiguration(ConfigurationContext context) {
+ return spi().createConfiguration(context);
+ }
+
+ /**
+ * Get access to the current ConfigurationContext.
+ *
+ * @return the current ConfigurationContext, never null.
- * @deprecated Use {@link Configuration#getContext()} instead of.
++ * @deprecated Use {@link Configuration#getContext()} instead.
+ */
+ @Deprecated
+ public static ConfigurationContext getConfigurationContext() {
+ return spi().getConfigurationContext();
+ }
+
+ /**
+ * This method allows to replace the current {@link org.apache.tamaya.spi.ConfigurationContext} with a new
+ * instance. This can be used to update the context with a new one, e.g. because some of the configuration
+ * data has changed and should be updated. It is the responsibility of the ConfigurationProvider to trigger
+ * corresponding update events for the current {@link org.apache.tamaya.Configuration}, so observing
+ * listeners can do whatever is appropriate to react to any given configuration changes.
+ *
+ * @param context the new ConfigurationContext to be applied.
+ * @throws java.lang.UnsupportedOperationException if the current provider is read-only and does not support
+ * applying a new ConfigurationContext.
+ * @deprecated Use #setConfiguration(Configuration) instead of.
+ */
+ @Deprecated
+ public static void setConfigurationContext(ConfigurationContext context) {
+ spi().setConfigurationContext(context);
+ }
+
+ /**
+ * This method allows to replace the current default {@link org.apache.tamaya.Configuration} with a new
+ * instance. It is the responsibility of the ConfigurationProvider to trigger
+ * corresponding update events for the current {@link org.apache.tamaya.Configuration}, so observing
+ * listeners can do whatever is appropriate to react to any given configuration change.
+ *
+ * @param config the new Configuration to be applied, not {@code null}
+ * @throws java.lang.UnsupportedOperationException if the current provider is read-only and
+ * does not support
+ * applying a new Configuration.
+ */
+ public static void setConfiguration(Configuration config) {
+ LOG.info("TAMAYA Applying new Configuration: " + config);
+ spi().setConfiguration(config);
+ }
+
+ /**
+ * Create a new {@link ConfigurationBuilder} instance. This method creates
+ * a new builder instance that is not related to any concrete {@link org.apache.tamaya.spi.ConfigurationContext}.
+ * You can use {@link #setConfigurationContext(org.apache.tamaya.spi.ConfigurationContext)} to change the
+ * current configuration context.
+ *
+ * @return a new, empty {@link ConfigurationBuilder}, never null.
+ * @see #setConfigurationContext(org.apache.tamaya.spi.ConfigurationContext)
+ * @see org.apache.tamaya.spi.ConfigurationContext
+ * @deprecated Will be removed.
+ */
+ @Deprecated
+ public static ConfigurationContextBuilder getConfigurationContextBuilder() {
+ return spi().getConfigurationContextBuilder();
+ }
+
+ /**
+ * Create a new {@link ConfigurationBuilder} instance. This method creates
+ * a new builder instance that is not related to any concrete {@link org.apache.tamaya.spi.ConfigurationContext}.
+ * You can use {@link #setConfigurationContext(org.apache.tamaya.spi.ConfigurationContext)} to change the
+ * current configuration context.
+ *
+ * @return a new, empty {@link ConfigurationBuilder}, never null.
+ * @see #setConfigurationContext(org.apache.tamaya.spi.ConfigurationContext)
+ * @see org.apache.tamaya.spi.ConfigurationContext
+ */
+ public static ConfigurationBuilder getConfigurationBuilder() {
+ return spi().getConfigurationBuilder();
+ }
+
+}
http://git-wip-us.apache.org/repos/asf/incubator-tamaya/blob/cd37ae9c/code/old/api/src/main/java/org/apache/tamaya/Configuration.java
----------------------------------------------------------------------
diff --cc code/old/api/src/main/java/org/apache/tamaya/Configuration.java
index b891d43,0000000..b00eebd
mode 100644,000000..100644
--- a/code/old/api/src/main/java/org/apache/tamaya/Configuration.java
+++ b/code/old/api/src/main/java/org/apache/tamaya/Configuration.java
@@@ -1,179 -1,0 +1,179 @@@
+/*
+ * 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.
+ */
+package org.apache.tamaya;
+
+import org.apache.tamaya.spi.ConfigurationBuilder;
+import org.apache.tamaya.spi.ConfigurationContext;
+
+import java.util.Map;
+
+
+/**
- * <p>A configuration models a aggregated set current properties, identified by
++ * <p>A configuration models an aggregated set of current properties, identified by
+ * a unique key, but adds higher level access functions to
+ * a {@link org.apache.tamaya.spi.PropertySource}. Hereby in most
+ * cases a configuration is a wrapper around a composite
+ * {@link org.apache.tamaya.spi.PropertySource} instance, which may combine
- * multiple child config in well defined tree like structure,
- * where nodes define logically the rules current priority, filtering,
++ * multiple child configurations in a well defined tree like structure,
++ * where nodes define logically the rules' current priority, filtering,
+ * combination and overriding.
+ * </p>
+ * <h3>Implementation Requirements</h3>
+ * Implementations current this interface must be
+ * <ul>
+ * <li>Thread safe</li>
+ * <li>Immutable</li>
+ * </ul>
+ *
+ * <p>It is not recommended that implementations also are serializable, since the any configuration can be <i>frozen</i>
+ * by reading out its complete configuration map into a serializable and remotable structure. This helps significantly
- * simplifying the development current this interface, e.g. for being backed up by systems and stores that are not part current
++ * simplifying the development of this interface, e.g. for being backed up by systems and stores that are not part
+ * this library at all.</p>
+ */
+public interface Configuration {
+
+ /**
+ * Access a property.
+ *
+ * @param key the property's key, not {@code null}.
+ * @return the property's value.
+ */
+ default String get(String key){
+ return get(key, TypeLiteral.of(String.class));
+ }
+
+ /**
+ * Access a property.
+ *
+ * @param key the property's key, not {@code null}.
+ * @param defaultValue value to be returned, if no value is present, not {@code null}
+ * @return the property's keys.
+ */
+ default String getOrDefault(String key, String defaultValue){
+ return getOrDefault(key, TypeLiteral.of(String.class), defaultValue);
+ }
+
+ /**
- * Get the property keys as type T. This will implicitly require a corresponding {@link
- * org.apache.tamaya.spi.PropertyConverter} to be available that is capable current providing type T
- * fromMap the given String keys.
++ * Gets the property keys as type T. This will implicitly require a corresponding {@link
++ * org.apache.tamaya.spi.PropertyConverter} to be available that is capable of providing type T
++ * fromMap for the given String keys.
+ *
+ * @param <T> the type of the class modeled by the type parameter
- * @param key the property's absolute, or relative path, e.g. @code
++ * @param key the property's absolute, or relative path, e.g. {@code
+ * a/b/c/d.myProperty}, not {@code null}.
+ * @param type The target type required, not {@code null}.
+ * @param defaultValue value to be used, if no value is present, not {@code null}
+ * @return the property value, never {@code null}.
+ * @throws ConfigException if the keys could not be converted to the required target type.
+ */
+ default <T> T getOrDefault(String key, Class<T> type, T defaultValue){
+ return getOrDefault(key, TypeLiteral.of(type), defaultValue);
+ }
+
+ /**
- * Get the property keys as type T. This will implicitly require a corresponding {@link
- * org.apache.tamaya.spi.PropertyConverter} to be available that is capable current providing type T
- * fromMap the given String keys.
++ * Gets the property keys as type T. This will implicitly require a corresponding {@link
++ * org.apache.tamaya.spi.PropertyConverter} to be available that is capable of providing type T
++ * fromMap for the given String keys.
+ *
+ * @param <T> the type of the class modeled by the type parameter
+ * @param key the property's absolute, or relative path, e.g. @code
+ * a/b/c/d.myProperty}.
+ * @param type The target type required, not {@code null}.
+ * @return the property value, never {@code null}.
+ * @throws ConfigException if the keys could not be converted to the required target type.
+ */
+ default <T> T get(String key, Class<T> type){
+ return get(key, TypeLiteral.of(type));
+ }
+
+ /**
+ * Get the property keys as type T. This will implicitly require a corresponding {@link
- * org.apache.tamaya.spi.PropertyConverter} to be available that is capable current providing type T
- * fromMap the given String keys.
++ * org.apache.tamaya.spi.PropertyConverter} to be available that is capable of providing type T
++ * literals for the given key.
+ *
+ * @param <T> the type of the type literal
+ * @param key the property's absolute, or relative path, e.g. @code
+ * a/b/c/d.myProperty}, not {@code null}.
+ * @param type The target type required, not {@code null}.
+ * @return the property value, never {@code null}.
+ * @throws ConfigException if the keys could not be converted to the required target type.
+ */
+ <T> T get(String key, TypeLiteral<T> type);
+
+ /**
+ * Get the property keys as type T. This will implicitly require a corresponding {@link
- * org.apache.tamaya.spi.PropertyConverter} to be available that is capable current providing type T
- * fromMap the given String keys.
++ * org.apache.tamaya.spi.PropertyConverter} to be available that is capable of providing type T
++ * literals for the given key.
+ *
+ * @param <T> the type of the type literal
+ * @param key the property's absolute, or relative path, e.g.
+ * {@code a/b/c/d.myProperty}, not {@code null}.
+ * @param type The target type required, not {@code null}.
+ * @param defaultValue default value to be used, if no value is present.
+ * @return the property value, never null.
+ * @throws ConfigException if the keys could not be converted to the required target type.
+ */
+ <T> T getOrDefault(String key, TypeLiteral<T> type, T defaultValue);
+
+ /**
+ * Access all currently known configuration properties as a full {@code Map<String,String>}.
+ * Be aware that entries from non scannable parts of the registered {@link org.apache.tamaya.spi.PropertySource}
- * instances may not be contained in the result, but nevertheless be accessible calling one of the
++ * instances may not be contained in the result, but nevertheless be accessible by calling one of the
+ * {@code get(...)} methods.
+ * @return all currently known configuration properties.
+ */
+ Map<String,String> getProperties();
+
+ /**
+ * Extension point for adjusting configuration.
+ *
+ * @param operator A configuration operator, e.g. a filter, or an adjuster
+ * combining configurations, never {@code null}.
+ * @return the new adjusted configuration returned by the {@code operator}, never {@code null}.
+ */
+ default Configuration with(ConfigOperator operator){
+ return operator.operate(this);
+ }
+
+ /**
+ * Query a configuration.
+ *
+ * @param <T> the type of the configuration.
+ * @param query the query, not {@code null}.
+ * @return the result returned by the {@code query}.
+ */
+ default <T> T query(ConfigQuery<T> query){
+ return query.query(this);
+ }
+
+ /**
+ * Access a configuration's context.
+ * @return the configuration context, never null.
+ */
+ ConfigurationContext getContext();
+
+ /**
+ * Create a new builder using this instance as it's base.
+ * @return a new builder, never null.
+ */
+ default ConfigurationBuilder toBuilder() {
+ return ConfigurationProvider.getConfigurationBuilder().setConfiguration(this);
+ }
+
+}
http://git-wip-us.apache.org/repos/asf/incubator-tamaya/blob/cd37ae9c/code/old/api/src/main/java/org/apache/tamaya/spi/ConfigurationBuilder.java
----------------------------------------------------------------------
diff --cc code/old/api/src/main/java/org/apache/tamaya/spi/ConfigurationBuilder.java
index a2b3257,0000000..3511abe
mode 100644,000000..100644
--- a/code/old/api/src/main/java/org/apache/tamaya/spi/ConfigurationBuilder.java
+++ b/code/old/api/src/main/java/org/apache/tamaya/spi/ConfigurationBuilder.java
@@@ -1,348 -1,0 +1,347 @@@
+/*
+ * 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.
+ */
+package org.apache.tamaya.spi;
+
+import org.apache.tamaya.Configuration;
+import org.apache.tamaya.TypeLiteral;
+
+import java.util.Collection;
+import java.util.Comparator;
+import java.util.List;
+import java.util.Map;
+
+/**
- * A builder for creating new instance of {@link Configuration}.
++ * A builder for creating new instances of {@link Configuration}.
+ * Builders can be obtained in exactly two ways:
+ * <ol>
+ * <li>By accessing a preinitialized builder from an existing {@link Configuration},
+ * by calling {@link org.apache.tamaya.spi.Configuration#toBuilder()}.</li>
+ * <li>By accessing an empty builder instance from
+ * {@link org.apache.tamaya.ConfigurationProvider#getConfigurationBuilder()}.</li>
+ * </ol>
+ * After all changes are applied to a builder a new {@link Configuration} instance can
+ * be created and can be applied by calling
+ * {@link #build()}}.
+ *
+ */
+public interface ConfigurationBuilder {
+
+ /**
+ * Init this builder instance with the given {@link Configuration} instance. This
+ * method will use any existing property sources, filters, converters and the combination
+ * policy of the given {@link Configuration} and initialize the current builder
+ * with them. All previous property sources, filters, converters and the combination
+ * policy of this instance will be replaced.
+ *
+ * @param config the {@link Configuration} instance to be used, not {@code null}.
+ * @return this builder, for chaining, never null.
+ */
+ ConfigurationBuilder setConfiguration(Configuration config);
+
+ /**
+ * Init this builder instance with the given {@link ConfigurationContext} instance. This
+ * method will use any existing property sources, filters, converters and the combination
+ * policy of the given {@link ConfigurationContext} and initialize the current builder
+ * with them. All previous property sources, filters, converters and the combination
+ * policy of this instance will be replaced.
+ *
+ * @param context the {@link ConfigurationContext} instance to be used, not {@code null}.
+ * @return this builder, for chaining, never null.
+ */
+ ConfigurationBuilder setContext(ConfigurationContext context);
+
+ /**
+ * This method can be used for adding {@link PropertySource}s.
+ * Hereby the property source is added to the tail of property sources with
+ * lowest priority regardless of its current ordinal value. To sort the property
+ * sources based on their ordinals call {@link #sortPropertySources}.
+ *
+ * @param propertySources the PropertySources to add
+ * @return this builder, for chaining, never null.
+ * @throws IllegalArgumentException If a property source with a given name already
+ * exists.
+ */
+ ConfigurationBuilder addPropertySources(PropertySource... propertySources);
+
+ /**
+ * This method can be used for programmatically adding {@link PropertySource}s.
+ * Hereby the property source is added to the tail of property sources with
+ * lowest priority regardless of its current ordinal value. To sort the property
+ * sources based on their ordinals call {@link #sortPropertySources}.
+ *
+ * @param propertySources the PropertySources to add
+ * @return this builder, for chaining, never null.
+ * @throws IllegalArgumentException If a property source with a given name already
+ * exists.
+ */
+ ConfigurationBuilder addPropertySources(Collection<PropertySource> propertySources);
+
+ /**
- * Add all registered (default) property sources to the context built. The sources are ordered
++ * Adds all registered (default) property sources to the context built. The sources are ordered
+ * based on their ordinal values and added to the chain of property sources with
+ * higher priority.
+ * @return this builder, for chaining, never null.
+ */
+ ConfigurationBuilder addDefaultPropertySources();
+
+ /**
+ * Removes the given property sources, if existing. The existing order of property
+ * sources is preserved.
+ *
+ * @param propertySources the property sources to remove, not {@code null}.
+ * @return the builder for chaining.
+ */
+ ConfigurationBuilder removePropertySources(PropertySource... propertySources);
+
+ /**
+ * Removes the given property sources, if existing. The existing order of property
+ * sources is preserved.
+ *
+ * @param propertySources the property sources to remove, not {@code null}.
+ * @return the builder for chaining.
+ */
+ ConfigurationBuilder removePropertySources(Collection<PropertySource> propertySources);
+
+ /**
+ * Access the current chain of property sources. Items at the end of the list have
- * precedence/more significance.
++ * precedence/higher significance.
+ *
+ * @return the property source chain, never {@code null}.
+ */
+ List<PropertySource> getPropertySources();
+
+ /**
+ * Access the current chain of property filters. Items at the end of the list have
- * precedence/more significance.
++ * precedence/higher significance.
+ *
+ * @return the property filter chain, never {@code null}.
+ */
+ List<PropertyFilter> getPropertyFilters();
+
+ /**
+ * Access the current registered property converters.
+ *
+ * @return the current registered property converters.
+ */
+ Map<TypeLiteral<?>, Collection<PropertyConverter<?>>> getPropertyConverter();
+
+ /**
+ * Increases the priority of the given property source, by moving it towards the end
+ * of the chain of property sources. If the property source given is already at the end
+ * this method has no effect. This operation does not change any ordinal values.
+ *
+ * @param propertySource the property source to be incresed regarding its significance.
+ * @return the builder for chaining.
+ * @throws IllegalArgumentException If no such property source exists in the current
+ * chain.
+ */
+ ConfigurationBuilder increasePriority(PropertySource propertySource);
+
+ /**
+ * Decreases the priority of the given property source, by moving it towards the start
+ * of the chain of property sources. If the property source given is already the first
+ * this method has no effect. This operation does not change any ordinal values.
+ *
+ * @param propertySource the property source to be decresed regarding its significance.
+ * @return the builder for chaining.
+ * @throws IllegalArgumentException If no such property source exists in the current
+ * chain.
+ */
+ ConfigurationBuilder decreasePriority(PropertySource propertySource);
+
+ /**
+ * Increases the priority of the given property source to be maximal, by moving it to
+ * the tail of the of property source chain. If the property source given is
+ * already the last item this method has no effect. This operation does not change
+ * any ordinal values.
+ *
+ * @param propertySource the property source to be maximized regarding its significance.
+ * @return the builder for chaining.
+ * @throws IllegalArgumentException If no such property source exists in the current
+ * chain.
+ */
+ ConfigurationBuilder highestPriority(PropertySource propertySource);
+
+ /**
+ * Decreases the priority of the given property source to be minimal, by moving it to
+ * the start of the chain of property source chain. If the property source given is
+ * already the first item this method has no effect. This operation does not change
+ * any ordinal values.
+ *
+ * @param propertySource the property source to be minimized regarding its significance.
+ * @return the builder for chaining.
+ * @throws IllegalArgumentException If no such property source exists in the current
+ * chain.
+ */
+ ConfigurationBuilder lowestPriority(PropertySource propertySource);
+
+ /**
+ * Adds the given PropertyFilter instances, hereby the instances are added
+ * to the end of the list with highest priority. The ordering of existing
+ * property filters remains unchanged. To sort the property
+ * filters call {@link #sortPropertyFilter}.
+ *
+ * @param filters the filters to add
+ * @return this builder, for chaining, never null.
+ */
+ ConfigurationBuilder addPropertyFilters(PropertyFilter... filters);
+
+ /**
+ * Adds the given PropertyFilter instances, hereby the instances are added
+ * to the end of the list with highest priority. The ordering of existing
+ * property filters remains unchanged. To sort the property
+ * filters call {@link #sortPropertyFilter}.
+ *
+ * @param filters the filters to add
+ * @return this builder, for chaining, never null.
+ */
+ ConfigurationBuilder addPropertyFilters(Collection<PropertyFilter> filters);
+
+ /**
+ * Add all auto-discoverable property filters to the context built.
+ * @return this builder, for chaining, never null.
+ */
+ ConfigurationBuilder addDefaultPropertyFilters();
+
-
+ /**
+ * Removes the given PropertyFilter instances, if existing. The order of the remaining
+ * filters is preserved.
+ *
+ * @param filters the filter to remove
+ * @return this builder, for chaining, never null.
+ */
+ ConfigurationBuilder removePropertyFilters(PropertyFilter... filters);
+
+ /**
+ * Removes the given PropertyFilter instances, if existing. The order of the remaining
+ * filters is preserved.
+ *
+ * @param filters the filter to remove
+ * @return this builder, for chaining, never null.
+ */
+ ConfigurationBuilder removePropertyFilters(Collection<PropertyFilter> filters);
+
+ /**
+ * This method can be used for adding {@link PropertyConverter}s.
+ * Converters are added at the end after any existing converters.
+ * For converters already registered for the current target type the
+ * method has no effect.
+ *
+ * @param typeToConvert the type for which the converter is for
+ * @param propertyConverters the PropertyConverters to add for this type
+ * @param <T> the target type.
+ * @return this builder, for chaining, never null.
+ */
+ <T> ConfigurationBuilder addPropertyConverters(TypeLiteral<T> typeToConvert,
+ @SuppressWarnings("unchecked") PropertyConverter<T>... propertyConverters);
+
+ /**
+ * This method can be used for adding {@link PropertyConverter}s.
+ * Converters are added at the end after any existing converters.
+ * For converters already registered for the current target type the
+ * method has no effect.
+ *
+ * @param typeToConvert the type for which the converter is for
+ * @param propertyConverters the PropertyConverters to add for this type
+ * @param <T> the target type.
+ * @return this builder, for chaining, never null.
+ */
+ <T> ConfigurationBuilder addPropertyConverters(TypeLiteral<T> typeToConvert,
+ Collection<PropertyConverter<T>> propertyConverters);
+
+ /**
+ * Add all auto-discoverable property converters to the context built.
+ * @return this builder, for chaining, never null.
+ */
+ ConfigurationBuilder addDefaultPropertyConverters();
+
+ /**
+ * Removes the given PropertyConverter instances for the given type,
+ * if existing.
+ *
+ * @param typeToConvert the type which the converter is for
+ * @param propertyConverters the converter to remove
+ * @param <T> the target type.
+ * @return this builder, for chaining, never null.
+ */
+ <T> ConfigurationBuilder removePropertyConverters(TypeLiteral<T> typeToConvert,
+ @SuppressWarnings("unchecked") PropertyConverter<T>... propertyConverters);
+
+ /**
+ * Removes the given PropertyConverter instances for the given type,
+ * if existing.
+ *
+ * @param typeToConvert the type which the converter is for
+ * @param propertyConverters the converter to remove
+ * @param <T> the target type.
+ * @return this builder, for chaining, never null.
+ */
+ <T> ConfigurationBuilder removePropertyConverters(TypeLiteral<T> typeToConvert,
+ Collection<PropertyConverter<T>> propertyConverters);
+
+ /**
+ * Removes all converters for the given type, which actually renders a given type
+ * unsupported for type conversion.
+ *
+ * @param typeToConvert the type which the converter is for
+ * @return this builder, for chaining, never null.
+ */
+ ConfigurationBuilder removePropertyConverters(TypeLiteral<?> typeToConvert);
+
+ /**
+ * Sorts the current registered property sources using the given comparator.
+ *
+ * NOTE: property sources at the beginning have minimal significance.
+ *
+ * @param comparator the comparator to be used, not {@code null}.
+ * @return this instance for chaining.
+ */
+ ConfigurationBuilder sortPropertySources(Comparator<PropertySource> comparator);
+
+ /**
+ * Sorts the current registered property filters using the given comparator.
+ *
+ * NOTE: property filters at the beginning have minimal significance.
+ *
+ * @param comparator the comparator to be used, not {@code null}.
+ * @return this instance for chaining.
+ */
+ ConfigurationBuilder sortPropertyFilter(Comparator<PropertyFilter> comparator);
+
+ /**
+ * Sets the {@link PropertyValueCombinationPolicy} used to evaluate the final
+ * property values.
+ *
+ * @param policy the {@link PropertyValueCombinationPolicy} used, not {@code null}.
+ * @return this builder, for chaining, never null.
+ */
+ ConfigurationBuilder setPropertyValueCombinationPolicy(PropertyValueCombinationPolicy policy);
+
+ /**
+ * Builds a new {@link Configuration} based on the data in this builder. The ordering of property
+ * sources and property filters is not changed, regardless of their ordinals. For ensure a certain
+ * ordering/significance use {@link #sortPropertyFilter(Comparator)} and/or {@link #sortPropertySources(Comparator)}
+ * before building the context.
+ *
+ * @return the final configuration, never null.
+ */
+ Configuration build();
+
+}
+
http://git-wip-us.apache.org/repos/asf/incubator-tamaya/blob/cd37ae9c/pom.xml
----------------------------------------------------------------------
[07/12] incubator-tamaya git commit: Try to change pitest config
Posted by po...@apache.org.
Try to change pitest config
Project: http://git-wip-us.apache.org/repos/asf/incubator-tamaya/repo
Commit: http://git-wip-us.apache.org/repos/asf/incubator-tamaya/commit/adc10963
Tree: http://git-wip-us.apache.org/repos/asf/incubator-tamaya/tree/adc10963
Diff: http://git-wip-us.apache.org/repos/asf/incubator-tamaya/diff/adc10963
Branch: refs/heads/configjsr
Commit: adc10963ebceb0e7cc6cc3187eeac3f1a8cb4c9b
Parents: 0af4480
Author: Phil Ottlinger <po...@apache.org>
Authored: Thu Jan 4 23:20:24 2018 +0100
Committer: Phil Ottlinger <po...@apache.org>
Committed: Thu Jan 4 23:20:24 2018 +0100
----------------------------------------------------------------------
pom.xml | 3 ++-
1 file changed, 2 insertions(+), 1 deletion(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/incubator-tamaya/blob/adc10963/pom.xml
----------------------------------------------------------------------
diff --git a/pom.xml b/pom.xml
index 2932c9b..18adb6a 100644
--- a/pom.xml
+++ b/pom.xml
@@ -331,10 +331,11 @@
<param>org.apache.tamaya.*</param>
</targetClasses>
<excludedClasses>
+ <param>org.apache.tamaya.core.internal.BannerManager</param>
<param>org.apache.tamaya.core.internal.BannerManagerTest</param>
</excludedClasses>
<excludedMethods>
- <param>toString</param>
+ <param>toString</param>
</excludedMethods>
<verbose>true</verbose>
</configuration>
[05/12] incubator-tamaya git commit: Update to latest pitest.
Posted by po...@apache.org.
Update to latest pitest.
Project: http://git-wip-us.apache.org/repos/asf/incubator-tamaya/repo
Commit: http://git-wip-us.apache.org/repos/asf/incubator-tamaya/commit/30506a48
Tree: http://git-wip-us.apache.org/repos/asf/incubator-tamaya/tree/30506a48
Diff: http://git-wip-us.apache.org/repos/asf/incubator-tamaya/diff/30506a48
Branch: refs/heads/configjsr
Commit: 30506a4874b103e4e867f00ac395e274c487cc15
Parents: 502444f
Author: Phil Ottlinger <po...@apache.org>
Authored: Wed Dec 27 22:13:08 2017 +0100
Committer: Phil Ottlinger <po...@apache.org>
Committed: Wed Dec 27 22:13:08 2017 +0100
----------------------------------------------------------------------
pom.xml | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/incubator-tamaya/blob/30506a48/pom.xml
----------------------------------------------------------------------
diff --git a/pom.xml b/pom.xml
index 76ba4cb..2932c9b 100644
--- a/pom.xml
+++ b/pom.xml
@@ -55,7 +55,7 @@
<asciidoctor-diagramm.version>1.2.1</asciidoctor-diagramm.version>
<asciidoctorj.version>1.5.2</asciidoctorj.version>
<checkstyle.version>2.15</checkstyle.version>
- <pitest-plugin.version>1.2.4</pitest-plugin.version>
+ <pitest-plugin.version>1.3.1</pitest-plugin.version>
<enforcer.version>1.4.1</enforcer.version>
<gem.plugin>1.0.7</gem.plugin>
<sources.plugin>3.0.1</sources.plugin>
[02/12] incubator-tamaya git commit: TAMAYA-321: Fix javadocs.
Posted by po...@apache.org.
TAMAYA-321: Fix javadocs.
Project: http://git-wip-us.apache.org/repos/asf/incubator-tamaya/repo
Commit: http://git-wip-us.apache.org/repos/asf/incubator-tamaya/commit/24e09135
Tree: http://git-wip-us.apache.org/repos/asf/incubator-tamaya/tree/24e09135
Diff: http://git-wip-us.apache.org/repos/asf/incubator-tamaya/diff/24e09135
Branch: refs/heads/configjsr
Commit: 24e091355c04c2e5532d49c1695014be26d2045c
Parents: 6184503
Author: Phil Ottlinger <po...@apache.org>
Authored: Mon Nov 27 21:43:01 2017 +0100
Committer: Phil Ottlinger <po...@apache.org>
Committed: Mon Nov 27 21:43:01 2017 +0100
----------------------------------------------------------------------
.../src/main/java/org/apache/tamaya/ConfigurationProvider.java | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/incubator-tamaya/blob/24e09135/code/api/src/main/java/org/apache/tamaya/ConfigurationProvider.java
----------------------------------------------------------------------
diff --git a/code/api/src/main/java/org/apache/tamaya/ConfigurationProvider.java b/code/api/src/main/java/org/apache/tamaya/ConfigurationProvider.java
index bacb944..9eae5af 100644
--- a/code/api/src/main/java/org/apache/tamaya/ConfigurationProvider.java
+++ b/code/api/src/main/java/org/apache/tamaya/ConfigurationProvider.java
@@ -23,7 +23,7 @@ import org.apache.tamaya.spi.*;
import java.util.logging.Logger;
/**
- * Static access to the {@link Configuration} for the very application.
+ * Static access to the {@link Configuration} of the whole application.
*/
public final class ConfigurationProvider {
@@ -65,7 +65,7 @@ public final class ConfigurationProvider {
* Get access to the current ConfigurationContext.
*
* @return the current ConfigurationContext, never null.
- * @deprecated Use {@link Configuration#getContext()} instead of.
+ * @deprecated Use {@link Configuration#getContext()} instead.
*/
@Deprecated
public static ConfigurationContext getConfigurationContext() {
[03/12] incubator-tamaya git commit: TAMAYA-321: Fix javadocs
Posted by po...@apache.org.
TAMAYA-321: Fix javadocs
Project: http://git-wip-us.apache.org/repos/asf/incubator-tamaya/repo
Commit: http://git-wip-us.apache.org/repos/asf/incubator-tamaya/commit/a2bdb02a
Tree: http://git-wip-us.apache.org/repos/asf/incubator-tamaya/tree/a2bdb02a
Diff: http://git-wip-us.apache.org/repos/asf/incubator-tamaya/diff/a2bdb02a
Branch: refs/heads/configjsr
Commit: a2bdb02a8c699ab8a2c03e75122280bfeeddd6a4
Parents: 24e0913
Author: Phil Ottlinger <po...@apache.org>
Authored: Mon Nov 27 21:47:05 2017 +0100
Committer: Phil Ottlinger <po...@apache.org>
Committed: Mon Nov 27 21:47:05 2017 +0100
----------------------------------------------------------------------
.../java/org/apache/tamaya/spi/ConfigurationBuilder.java | 9 ++++-----
1 file changed, 4 insertions(+), 5 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/incubator-tamaya/blob/a2bdb02a/code/api/src/main/java/org/apache/tamaya/spi/ConfigurationBuilder.java
----------------------------------------------------------------------
diff --git a/code/api/src/main/java/org/apache/tamaya/spi/ConfigurationBuilder.java b/code/api/src/main/java/org/apache/tamaya/spi/ConfigurationBuilder.java
index a2b3257..3511abe 100644
--- a/code/api/src/main/java/org/apache/tamaya/spi/ConfigurationBuilder.java
+++ b/code/api/src/main/java/org/apache/tamaya/spi/ConfigurationBuilder.java
@@ -27,7 +27,7 @@ import java.util.List;
import java.util.Map;
/**
- * A builder for creating new instance of {@link Configuration}.
+ * A builder for creating new instances of {@link Configuration}.
* Builders can be obtained in exactly two ways:
* <ol>
* <li>By accessing a preinitialized builder from an existing {@link Configuration},
@@ -93,7 +93,7 @@ public interface ConfigurationBuilder {
ConfigurationBuilder addPropertySources(Collection<PropertySource> propertySources);
/**
- * Add all registered (default) property sources to the context built. The sources are ordered
+ * Adds all registered (default) property sources to the context built. The sources are ordered
* based on their ordinal values and added to the chain of property sources with
* higher priority.
* @return this builder, for chaining, never null.
@@ -120,7 +120,7 @@ public interface ConfigurationBuilder {
/**
* Access the current chain of property sources. Items at the end of the list have
- * precedence/more significance.
+ * precedence/higher significance.
*
* @return the property source chain, never {@code null}.
*/
@@ -128,7 +128,7 @@ public interface ConfigurationBuilder {
/**
* Access the current chain of property filters. Items at the end of the list have
- * precedence/more significance.
+ * precedence/higher significance.
*
* @return the property filter chain, never {@code null}.
*/
@@ -219,7 +219,6 @@ public interface ConfigurationBuilder {
*/
ConfigurationBuilder addDefaultPropertyFilters();
-
/**
* Removes the given PropertyFilter instances, if existing. The order of the remaining
* filters is preserved.
[11/12] incubator-tamaya git commit: TAMAYA-296: Update dependencies
Posted by po...@apache.org.
TAMAYA-296: Update dependencies
Project: http://git-wip-us.apache.org/repos/asf/incubator-tamaya/repo
Commit: http://git-wip-us.apache.org/repos/asf/incubator-tamaya/commit/d6229de3
Tree: http://git-wip-us.apache.org/repos/asf/incubator-tamaya/tree/d6229de3
Diff: http://git-wip-us.apache.org/repos/asf/incubator-tamaya/diff/d6229de3
Branch: refs/heads/configjsr
Commit: d6229de3594538bd30727dfdaabeb4444e11b83f
Parents: 3f52504
Author: Phil Ottlinger <po...@apache.org>
Authored: Wed Jan 24 22:52:25 2018 +0100
Committer: Phil Ottlinger <po...@apache.org>
Committed: Wed Jan 24 22:52:25 2018 +0100
----------------------------------------------------------------------
pom.xml | 10 ++++------
1 file changed, 4 insertions(+), 6 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/incubator-tamaya/blob/d6229de3/pom.xml
----------------------------------------------------------------------
diff --git a/pom.xml b/pom.xml
index 8169ba5..2844479 100644
--- a/pom.xml
+++ b/pom.xml
@@ -51,9 +51,9 @@
<!-- Keep the JRuby version in sync with the one used by Asciidoctor -->
<assembly.version>3.1.0</assembly.version>
- <asciidoctor.version>1.5.2</asciidoctor.version>
+ <asciidoctor.version>1.5.6</asciidoctor.version>
<asciidoctor-diagramm.version>1.2.1</asciidoctor-diagramm.version>
- <asciidoctorj.version>1.5.2</asciidoctorj.version>
+ <asciidoctorj.version>1.5.6</asciidoctorj.version>
<checkstyle.version>2.15</checkstyle.version>
<!-- 201801: v1.3.x gives strange test errors -->
<pitest-plugin.version>1.2.5</pitest-plugin.version>
@@ -63,7 +63,7 @@
<hamcrest.version>2.0.0.0</hamcrest.version>
<javadoc.version>2.10.4</javadoc.version>
<!-- Must/should match the JRuby version used by AsciidoctorJ -->
- <jruby.version>1.7.20</jruby.version>
+ <jruby.version>1.7.26</jruby.version>
<findbugs.version>3.0.4</findbugs.version>
<mockito.version>1.10.19</mockito.version>
<rat.version>0.12</rat.version>
@@ -534,9 +534,7 @@
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-site-plugin</artifactId>
- <!-- 20160816: 3.5.1 generates a broken site, maybe due
- to old asciidoc version?! -->
- <version>3.4</version>
+ <version>3.7</version>
<inherited>true</inherited>
<dependencies>
<dependency><!-- add support for ssh/scp -->