You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@tamaya.apache.org by pl...@apache.org on 2015/03/10 22:58:26 UTC
incubator-tamaya git commit: TAMAYA-60 JavaDoc..
Repository: incubator-tamaya
Updated Branches:
refs/heads/master afdd6c8c0 -> 5e598cb96
TAMAYA-60 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/5e598cb9
Tree: http://git-wip-us.apache.org/repos/asf/incubator-tamaya/tree/5e598cb9
Diff: http://git-wip-us.apache.org/repos/asf/incubator-tamaya/diff/5e598cb9
Branch: refs/heads/master
Commit: 5e598cb9677dc9f1f31302512036ec4f678e3830
Parents: afdd6c8
Author: Oliver B. Fischer <pl...@apache.org>
Authored: Tue Mar 10 22:57:55 2015 +0100
Committer: Oliver B. Fischer <pl...@apache.org>
Committed: Tue Mar 10 22:57:55 2015 +0100
----------------------------------------------------------------------
.../modules/builder/ConfigurationBuilder.java | 52 ++++++++++++++++++--
1 file changed, 49 insertions(+), 3 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/incubator-tamaya/blob/5e598cb9/modules/builder/src/main/java/org/apache/tamaya/modules/builder/ConfigurationBuilder.java
----------------------------------------------------------------------
diff --git a/modules/builder/src/main/java/org/apache/tamaya/modules/builder/ConfigurationBuilder.java b/modules/builder/src/main/java/org/apache/tamaya/modules/builder/ConfigurationBuilder.java
index 173117a..ce26aad 100644
--- a/modules/builder/src/main/java/org/apache/tamaya/modules/builder/ConfigurationBuilder.java
+++ b/modules/builder/src/main/java/org/apache/tamaya/modules/builder/ConfigurationBuilder.java
@@ -122,7 +122,23 @@ public class ConfigurationBuilder {
}
/**
+ * Adds one resources with properties in an arbitrary format
+ * to the configuration to be build.
+ *
+ * <p>If a specific format is supported depends on the available
+ * {@link org.apache.tamaya.format.ConfigurationFormat} implementations.</p>
+ *
+ * <pre>{@code URL resource = new URL("file:/etc/service/config.json");
+ *
+ * builder.addPropertySources(resource);}
+ * </pre>
+ *
+ * @param url resource with properties for the the configuration to be build.
+ *
* @return the builder instance currently used
+ *
+ * @see org.apache.tamaya.format.ConfigurationFormat
+ * @see org.apache.tamaya.format.ConfigurationFormats#getFormats()
*/
public ConfigurationBuilder addPropertySource(URL url) {
try {
@@ -325,7 +341,7 @@ public class ConfigurationBuilder {
}
/**
- * Disables the loading of all {@link org.apache.tamaya.PropertyConverter}
+ * Disables the automatic loading of all {@link org.apache.tamaya.PropertyConverter}
* service providers.
*
* @return the builder instance currently used
@@ -343,7 +359,13 @@ public class ConfigurationBuilder {
/**
+ * Enables the automatic loading of all {@link org.apache.tamaya.spi.PropertySource}
+ * service providers.
+ *
* @return the builder instance currently used
+ *
+ * @see org.apache.tamaya.spi.PropertySource
+ * @see #disableProvidedPropertySources()
*/
public ConfigurationBuilder enableProvidedPropertySources() {
checkBuilderState();
@@ -353,11 +375,25 @@ public class ConfigurationBuilder {
return this;
}
+ /**
+ * Checks if the automatic loading of all {@link org.apache.tamaya.spi.PropertySource
+ * PropertySource} service providers is enabled or disabled.
+ *
+ * @return {@code true} if the automatic loading is enabled,
+ * otherwise {@code false}.
+ */
public boolean isPropertySourcesLoadingEnabled() {
return loadProvidedPropertySources;
}
+ /**
+ * Checks if the automatic loading of all {@link org.apache.tamaya.spi.PropertyFilter
+ * PropertyFilter} service providers is enabled or disabled.
+ *
+ * @return {@code true} if the automatic loading is enabled,
+ * otherwise {@code false}.
+ */
public boolean isPropertyFilterLoadingEnabled() {
return isLoadProvidedPropertyFilters;
}
@@ -375,7 +411,7 @@ public class ConfigurationBuilder {
}
/**
- * Disables the loading of all {@link org.apache.tamaya.spi.PropertyFilter}
+ * Disables the automatic loading of all {@link org.apache.tamaya.spi.PropertyFilter}
* service providers.
*
* @return the builder instance currently used
@@ -394,7 +430,13 @@ public class ConfigurationBuilder {
}
/**
+ * Disables the automatic loading of all {@link org.apache.tamaya.spi.PropertySource}
+ * service providers.
+ *
* @return the builder instance currently used
+ *
+ * @see org.apache.tamaya.spi.PropertySource
+ * @see #enableProvidedPropertySources()
*/
public ConfigurationBuilder disableProvidedPropertySources() {
checkBuilderState();
@@ -405,9 +447,13 @@ public class ConfigurationBuilder {
}
/**
- *
+ * Enables the automatic loading of {@link org.apache.tamaya.spi.PropertySourceProvider
+ * property source providers} provided via the SPI API.
*
* @return the builder instance currently used
+ *
+ * @see org.apache.tamaya.spi.PropertySourceProvider
+ * @see
*/
public ConfigurationBuilder enableProvidedPropertySourceProviders() {
checkBuilderState();