Package com.azure.core.util

Class ConfigurationBuilder

  • public final class ConfigurationBuilder
extends Object
    Builds Configuration with external source.

    • Constructor Detail

      • ConfigurationBuilder

        public ConfigurationBuilder()
        Creates ConfigurationBuilder. 
         configuration = new ConfigurationBuilder()
     .putProperty("azure.sdk.client-name.connection-string", "...")
     .root("azure.sdk")
     .buildSection("client-name");

 ConfigurationProperty<String> connectionStringProperty = ConfigurationPropertyBuilder.ofString("connection-string")
     .build();

 System.out.println(configuration.get(connectionStringProperty));

      • ConfigurationBuilder

        public ConfigurationBuilder​(ConfigurationSource source)
        Creates ConfigurationBuilder with configuration source. 
         Configuration configuration = new ConfigurationBuilder(new SampleSource(properties))
     .root("azure.sdk")
     .buildSection("client-name");

 ConfigurationProperty<String> proxyHostnameProperty = ConfigurationPropertyBuilder.ofString("http.proxy.hostname")
     .shared(true)
     .build();
 System.out.println(configuration.get(proxyHostnameProperty));
        Parameters:
        source - Custom ConfigurationSource containing known Azure SDK configuration properties.

      • ConfigurationBuilder

        public ConfigurationBuilder​(ConfigurationSource source,
                            ConfigurationSource systemPropertiesConfigurationSource,
                            ConfigurationSource environmentConfigurationSource)
        Creates ConfigurationBuilder with configuration sources for explicit configuration, system properties and environment configuration sources. Use this constructor to customize known Azure SDK system properties and environment variables retrieval.
        Parameters:
        source - Custom ConfigurationSource containing known Azure SDK configuration properties
        systemPropertiesConfigurationSource - ConfigurationSource containing known Azure SDK system properties.
        environmentConfigurationSource - ConfigurationSource containing known Azure SDK environment variables.

    • Method Detail

      • putProperty

        public ConfigurationBuilder putProperty​(String name,
                                        String value)
        Adds property to the configuration source. In case the source already contains property with the same name, the value will be overwritten with the new value passed. 
         configuration = new ConfigurationBuilder()
     .putProperty("azure.sdk.client-name.connection-string", "...")
     .root("azure.sdk")
     .buildSection("client-name");

 ConfigurationProperty<String> connectionStringProperty = ConfigurationPropertyBuilder.ofString("connection-string")
     .build();

 System.out.println(configuration.get(connectionStringProperty));
        Parameters:
        name - Property name.
        value - Property value.
        Returns:
        ConfigurationBuilder instance for chaining.

      • root

        public ConfigurationBuilder root​(String rootPath)
        Sets path to root configuration properties where shared Azure SDK properties are defined. When local per-client property is missing, Configuration falls back to shared properties. 
         Configuration configuration = new ConfigurationBuilder(new SampleSource(properties))
     .root("azure.sdk")
     .buildSection("client-name");

 ConfigurationProperty<String> proxyHostnameProperty = ConfigurationPropertyBuilder.ofString("http.proxy.hostname")
     .shared(true)
     .build();
 System.out.println(configuration.get(proxyHostnameProperty));
        Parameters:
        rootPath - absolute root path, can be null.
        Returns:
        ConfigurationBuilder instance for chaining.

      • build

        public Configuration build()
        Builds root Configuration section. Use it for shared properties only. To read client-specific configuration, use buildSection(String) which can read per-client and shared properties. 
         // Builds shared Configuration only.
 Configuration sharedConfiguration = new ConfigurationBuilder(new SampleSource(properties))
     .root("azure.sdk")
     .build();
        Returns:
        Root Configuration with shared properties.

      • buildSection

        public Configuration buildSection​(String path)
        Builds Configuration section that supports retrieving properties from client-specific section with fallback to root section for properties that can be shared between clients. 
         // Builds Configuration for <client-name> with fallback to shared properties.
 configuration = new ConfigurationBuilder(new SampleSource(properties))
     .root("azure.sdk")
     .buildSection("client-name");
        Parameters:
        path - relative path from root(String) to client section.
        Returns:
        Client Configuration capable of reading client-specific and shared properties.