Class Config

    • Field Detail

      • DEFAULT_CLUSTER_NAME

        public static final java.lang.String DEFAULT_CLUSTER_NAME
        Default cluster name.
        See Also:
        Constant Field Values
    • Constructor Detail

      • Config

        public Config()
      • Config

        public Config​(java.lang.String instanceName)
    • Method Detail

      • load

        public static Config load()
        Populates Hazelcast Config object from an external configuration file.

        It tries to load Hazelcast configuration from a list of well-known locations, and then applies overrides found in environment variables/system properties When no location contains Hazelcast configuration then it returns default.

        Note that the same mechanism is used when calling Hazelcast.newHazelcastInstance().

        Returns:
        Config created from a file when exists, otherwise default.
      • loadDefault

        public static Config loadDefault()
        Same as load(), i.e., loads Config using the default lookup mechanism
        Returns:
        Config created from a file when exists, otherwise default.
      • loadDefault

        public static Config loadDefault​(java.util.Properties properties)
        Loads Config using the default lookup mechanism to locate the configuration file and applies variable resolution from the provided properties.
        Parameters:
        properties - properties to resolve variables in the XML or YAML
        Returns:
        Config created from a file when exists, otherwise default.
      • loadFromClasspath

        public static Config loadFromClasspath​(java.lang.ClassLoader classLoader,
                                               java.lang.String resource)
        Creates a Config which is loaded from a classpath resource. The System.properties are used for variable resolution in the configuration file
        Parameters:
        classLoader - the ClassLoader used to load the resource
        resource - the resource, an XML or YAML configuration file from the classpath, without the "classpath:" prefix
        Returns:
        Config created from the resource
        Throws:
        java.lang.IllegalArgumentException - if classLoader or resource is null, or if the resource is not found
        InvalidConfigurationException - if the resource content is invalid
      • loadFromClasspath

        public static Config loadFromClasspath​(java.lang.ClassLoader classLoader,
                                               java.lang.String resource,
                                               java.util.Properties properties)
        Creates a Config which is loaded from a classpath resource. Uses the given properties to resolve the variables in the resource.
        Parameters:
        classLoader - the ClassLoader used to load the resource
        resource - the resource, an XML or YAML configuration file from the classpath, without the "classpath:" prefix
        properties - the properties used to resolve variables in the resource
        Returns:
        Config created from the resource
        Throws:
        java.lang.IllegalArgumentException - if classLoader or resource is null, or if the resource is not found
        InvalidConfigurationException - if the resource content is invalid
      • loadFromFile

        public static Config loadFromFile​(java.io.File configFile)
                                   throws java.io.FileNotFoundException
        Creates a Config based on a the provided configuration file (XML or YAML) and uses the System.properties to resolve variables in the file.
        Parameters:
        configFile - the path of the configuration file
        Returns:
        Config created from the configFile
        Throws:
        java.io.FileNotFoundException - if the file doesn't exist
        InvalidConfigurationException - if the file content is invalid
      • loadFromFile

        public static Config loadFromFile​(java.io.File configFile,
                                          java.util.Properties properties)
                                   throws java.io.FileNotFoundException
        Creates a Config based on a the provided configuration file (XML or YAML) and uses the System.properties to resolve variables in the file.
        Parameters:
        configFile - the path of the configuration file
        properties - properties to use for variable resolution in the file
        Returns:
        Config created from the configFile
        Throws:
        java.io.FileNotFoundException - if the file doesn't exist
        InvalidConfigurationException - if the file content is invalid
      • loadFromString

        public static Config loadFromString​(java.lang.String source)
        Creates a Config from the provided string (XML or YAML content) and uses the System.properties for variable resolution.
        Parameters:
        source - the XML or YAML content
        Returns:
        Config created from the string
        Throws:
        java.lang.IllegalArgumentException - if the source is null or empty
        HazelcastException - if the source content is invalid
      • loadFromString

        public static Config loadFromString​(java.lang.String source,
                                            java.util.Properties properties)
        Creates a Config from the provided string (XML or YAML content).
        Parameters:
        source - the XML or YAML content
        properties - properties to use for variable resolution
        Returns:
        Config created from the string
        Throws:
        java.lang.IllegalArgumentException - if the source is null or empty
        HazelcastException - if the source content is invalid
      • loadFromStream

        public static Config loadFromStream​(java.io.InputStream source)
        Creates a Config from the provided stream (XML or YAML content) and uses the System.properties for variable resolution.
        Parameters:
        source - the XML or YAML stream
        Returns:
        Config created from the stream
        Throws:
        HazelcastException - if the source content is invalid
      • loadFromStream

        public static Config loadFromStream​(java.io.InputStream source,
                                            java.util.Properties properties)
        Creates a Config from the provided stream (XML or YAML content).
        Parameters:
        source - the XML or YAML stream
        properties - properties to use for variable resolution
        Returns:
        Config created from the stream
      • getClassLoader

        public java.lang.ClassLoader getClassLoader()
        Returns the class-loader that will be used in serialization.

        If null, then thread context class-loader will be used instead.

        Returns:
        the class-loader
      • setClassLoader

        public Config setClassLoader​(java.lang.ClassLoader classLoader)
        Sets the class-loader to be used during de-serialization and as context class-loader of Hazelcast internal threads.

        If not set (or set to null); thread context class-loader will be used in required places.

        Default value is null.

        Parameters:
        classLoader - class-loader to be used during de-serialization
        Returns:
        Config instance
      • setConfigPatternMatcher

        public Config setConfigPatternMatcher​(ConfigPatternMatcher configPatternMatcher)
        Sets the pattern matcher which is used to match item names to configuration objects. By default the MatchingPointConfigPatternMatcher is used.
        Parameters:
        configPatternMatcher - the pattern matcher
        Returns:
        this configuration
        Throws:
        java.lang.IllegalArgumentException - if the pattern matcher is null
      • getProperty

        public java.lang.String getProperty​(java.lang.String name)
        Returns the value for a named property. If it has not been previously set, it will try to get the value from the system properties.
        Parameters:
        name - property name
        Returns:
        property value
        See Also:
        setProperty(String, String), Hazelcast System Properties
      • setProperty

        public Config setProperty​(@Nonnull
                                  java.lang.String name,
                                  @Nonnull
                                  java.lang.String value)
        Sets the value of a named property.
        Parameters:
        name - property name
        value - value of the property
        Returns:
        this config instance
        Throws:
        java.lang.IllegalArgumentException - if either value is null or if name is empty or null
        See Also:
        Hazelcast System Properties
      • getMemberAttributeConfig

        public MemberAttributeConfig getMemberAttributeConfig()
        Returns the member attribute configuration. Unlike the config properties (see setProperties(Properties)), member attributes are exchanged with other members, e.g. on membership events.
        Returns:
        the member attribute configuration
      • setMemberAttributeConfig

        public Config setMemberAttributeConfig​(MemberAttributeConfig memberAttributeConfig)
        Sets the member attribute configuration. Unlike the config properties (see setProperties(Properties)), member attributes are exchanged with other members, e.g. on membership events.
        Parameters:
        memberAttributeConfig - the member attribute configuration
        Returns:
        this configuration
      • getProperties

        public java.util.Properties getProperties()
        Returns the properties set on this config instance. These properties are specific to this config and this hazelcast instance.
        Returns:
        the config properties
      • setProperties

        public Config setProperties​(java.util.Properties properties)
        Sets the properties for this config instance. These properties are specific to this config and this hazelcast instance.
        Parameters:
        properties - the config properties
        Returns:
        this config instance
      • getInstanceName

        public java.lang.String getInstanceName()
        Returns the instance name uniquely identifying the hazelcast instance created by this configuration. This name is used in different scenarios, such as identifying the hazelcast instance when running multiple instances in the same JVM.
        Returns:
        the hazelcast instance name
      • setInstanceName

        public Config setInstanceName​(java.lang.String instanceName)
        Sets the instance name uniquely identifying the hazelcast instance created by this configuration. This name is used in different scenarios, such as identifying the hazelcast instance when running multiple instances in the same JVM.
        Parameters:
        instanceName - the hazelcast instance name
        Returns:
        this config instance
      • getClusterName

        public java.lang.String getClusterName()
        Returns the cluster name uniquely identifying the hazelcast cluster. This name is used in different scenarios, such as identifying cluster for WAN publisher.
        Returns:
        the cluster name.
      • setClusterName

        public Config setClusterName​(java.lang.String clusterName)
        Sets the cluster name uniquely identifying the hazelcast cluster. This name is used in different scenarios, such as identifying cluster for WAN publisher.
        Parameters:
        clusterName - the new cluster name
        Returns:
        this config instance
        Throws:
        java.lang.IllegalArgumentException - if name is null
      • getNetworkConfig

        public NetworkConfig getNetworkConfig()
        Returns the network configuration for this hazelcast instance. The network configuration defines how a member will interact with other members or clients.
        Returns:
        the network configuration
      • setNetworkConfig

        public Config setNetworkConfig​(NetworkConfig networkConfig)
        Sets the network configuration for this hazelcast instance. The network configuration defines how a member will interact with other members or clients.
        Parameters:
        networkConfig - the network configuration
        Returns:
        this config instance
      • getMapConfig

        public MapConfig getMapConfig​(java.lang.String name)
        Returns the MapConfig for the given name, creating one if necessary and adding it to the collection of known configurations.

        The configuration is found by matching the configuration name pattern to the provided name without the partition qualifier (the part of the name after '@'). If no configuration matches, it will create one by cloning the "default" configuration and add it to the configuration collection.

        This method is intended to easily and fluently create and add configurations more specific than the default configuration without explicitly adding it by invoking addMapConfig(MapConfig).

        Because it adds new configurations if they are not already present, this method is intended to be used before this config is used to create a hazelcast instance. Afterwards, newly added configurations may be ignored.

        Parameters:
        name - name of the map config
        Returns:
        the map configuration
        Throws:
        InvalidConfigurationException - if ambiguous configurations are found
        See Also:
        StringPartitioningStrategy.getBaseName(java.lang.String), setConfigPatternMatcher(ConfigPatternMatcher), getConfigPatternMatcher()
      • addMapConfig

        public Config addMapConfig​(MapConfig mapConfig)
        Adds the map configuration. The configuration is saved under the config name, which may be a pattern with which the configuration will be obtained in the future.
        Parameters:
        mapConfig - the map configuration
        Returns:
        this config instance
      • getMapConfigs

        public java.util.Map<java.lang.String,​MapConfig> getMapConfigs()
        Returns the map of IMap configurations, mapped by config name. The config name may be a pattern with which the configuration was initially obtained.
        Returns:
        the map configurations mapped by config name
      • setMapConfigs

        public Config setMapConfigs​(java.util.Map<java.lang.String,​MapConfig> mapConfigs)
        Sets the map of IMap configurations, mapped by config name. The config name may be a pattern with which the configuration will be obtained in the future.
        Parameters:
        mapConfigs - the IMap configuration map to set
        Returns:
        this config instance
      • getCacheConfig

        public CacheSimpleConfig getCacheConfig​(java.lang.String name)
        Returns the CacheSimpleConfig for the given name, creating one if necessary and adding it to the collection of known configurations.

        The configuration is found by matching the configuration name pattern to the provided name without the partition qualifier (the part of the name after '@'). If no configuration matches, it will create one by cloning the "default" configuration and add it to the configuration collection.

        This method is intended to easily and fluently create and add configurations more specific than the default configuration without explicitly adding it by invoking addCacheConfig(CacheSimpleConfig).

        Because it adds new configurations if they are not already present, this method is intended to be used before this config is used to create a hazelcast instance. Afterwards, newly added configurations may be ignored.

        Parameters:
        name - name of the cache config
        Returns:
        the cache configuration
        Throws:
        InvalidConfigurationException - if ambiguous configurations are found
        See Also:
        StringPartitioningStrategy.getBaseName(java.lang.String), setConfigPatternMatcher(ConfigPatternMatcher), getConfigPatternMatcher()
      • addCacheConfig

        public Config addCacheConfig​(CacheSimpleConfig cacheConfig)
        Adds the cache configuration. The configuration is saved under the config name, which may be a pattern with which the configuration will be obtained in the future.
        Parameters:
        cacheConfig - the cache configuration
        Returns:
        this config instance
      • getCacheConfigs

        public java.util.Map<java.lang.String,​CacheSimpleConfig> getCacheConfigs()
        Returns the map of cache configurations, mapped by config name. The config name may be a pattern with which the configuration was initially obtained.
        Returns:
        the cache configurations mapped by config name
      • setCacheConfigs

        public Config setCacheConfigs​(java.util.Map<java.lang.String,​CacheSimpleConfig> cacheConfigs)
        Sets the map of cache configurations, mapped by config name. The config name may be a pattern with which the configuration was initially obtained.
        Parameters:
        cacheConfigs - the cacheConfigs to set
        Returns:
        this config instance
      • getQueueConfig

        public QueueConfig getQueueConfig​(java.lang.String name)
        Returns the QueueConfig for the given name, creating one if necessary and adding it to the collection of known configurations.

        The configuration is found by matching the configuration name pattern to the provided name without the partition qualifier (the part of the name after '@'). If no configuration matches, it will create one by cloning the "default" configuration and add it to the configuration collection.

        This method is intended to easily and fluently create and add configurations more specific than the default configuration without explicitly adding it by invoking addQueueConfig(QueueConfig).

        Because it adds new configurations if they are not already present, this method is intended to be used before this config is used to create a hazelcast instance. Afterwards, newly added configurations may be ignored.

        Parameters:
        name - name of the queue config
        Returns:
        the queue configuration
        Throws:
        InvalidConfigurationException - if ambiguous configurations are found
        See Also:
        StringPartitioningStrategy.getBaseName(java.lang.String), setConfigPatternMatcher(ConfigPatternMatcher), getConfigPatternMatcher()
      • addQueueConfig

        public Config addQueueConfig​(QueueConfig queueConfig)
        Adds the queue configuration. The configuration is saved under the config name, which may be a pattern with which the configuration will be obtained in the future.
        Parameters:
        queueConfig - the queue configuration
        Returns:
        this config instance
      • getQueueConfigs

        public java.util.Map<java.lang.String,​QueueConfig> getQueueConfigs()
        Returns the map of IQueue configurations, mapped by config name. The config name may be a pattern with which the configuration was initially obtained.
        Returns:
        the queue configurations mapped by config name
      • setQueueConfigs

        public Config setQueueConfigs​(java.util.Map<java.lang.String,​QueueConfig> queueConfigs)
        Sets the map of IQueue configurations, mapped by config name. The config name may be a pattern with which the configuration will be obtained in the future.
        Parameters:
        queueConfigs - the queue configuration map to set
        Returns:
        this config instance
      • getListConfig

        public ListConfig getListConfig​(java.lang.String name)
        Returns the ListConfig for the given name, creating one if necessary and adding it to the collection of known configurations.

        The configuration is found by matching the configuration name pattern to the provided name without the partition qualifier (the part of the name after '@'). If no configuration matches, it will create one by cloning the "default" configuration and add it to the configuration collection.

        This method is intended to easily and fluently create and add configurations more specific than the default configuration without explicitly adding it by invoking addListConfig(ListConfig).

        Because it adds new configurations if they are not already present, this method is intended to be used before this config is used to create a hazelcast instance. Afterwards, newly added configurations may be ignored.

        Parameters:
        name - name of the list config
        Returns:
        the list configuration
        Throws:
        InvalidConfigurationException - if ambiguous configurations are found
        See Also:
        StringPartitioningStrategy.getBaseName(java.lang.String), setConfigPatternMatcher(ConfigPatternMatcher), getConfigPatternMatcher()
      • addListConfig

        public Config addListConfig​(ListConfig listConfig)
        Adds the list configuration. The configuration is saved under the config name, which may be a pattern with which the configuration will be obtained in the future.
        Parameters:
        listConfig - the list configuration
        Returns:
        this config instance
      • getListConfigs

        public java.util.Map<java.lang.String,​ListConfig> getListConfigs()
        Returns the map of IList configurations, mapped by config name. The config name may be a pattern with which the configuration was initially obtained.
        Returns:
        the list configurations mapped by config name
      • setListConfigs

        public Config setListConfigs​(java.util.Map<java.lang.String,​ListConfig> listConfigs)
        Sets the map of IList configurations, mapped by config name. The config name may be a pattern with which the configuration will be obtained in the future.
        Parameters:
        listConfigs - the list configuration map to set
        Returns:
        this config instance
      • getSetConfig

        public SetConfig getSetConfig​(java.lang.String name)
        Returns the SetConfig for the given name, creating one if necessary and adding it to the collection of known configurations.

        The configuration is found by matching the configuration name pattern to the provided name without the partition qualifier (the part of the name after '@'). If no configuration matches, it will create one by cloning the "default" configuration and add it to the configuration collection.

        This method is intended to easily and fluently create and add configurations more specific than the default configuration without explicitly adding it by invoking addSetConfig(SetConfig).

        Because it adds new configurations if they are not already present, this method is intended to be used before this config is used to create a hazelcast instance. Afterwards, newly added configurations may be ignored.

        Parameters:
        name - name of the set config
        Returns:
        the set configuration
        Throws:
        InvalidConfigurationException - if ambiguous configurations are found
        See Also:
        StringPartitioningStrategy.getBaseName(java.lang.String), setConfigPatternMatcher(ConfigPatternMatcher), getConfigPatternMatcher()
      • addSetConfig

        public Config addSetConfig​(SetConfig setConfig)
        Adds the set configuration. The configuration is saved under the config name, which may be a pattern with which the configuration will be obtained in the future.
        Parameters:
        setConfig - the set configuration
        Returns:
        this config instance
      • getSetConfigs

        public java.util.Map<java.lang.String,​SetConfig> getSetConfigs()
        Returns the map of ISet configurations, mapped by config name. The config name may be a pattern with which the configuration was initially obtained.
        Returns:
        the set configurations mapped by config name
      • setSetConfigs

        public Config setSetConfigs​(java.util.Map<java.lang.String,​SetConfig> setConfigs)
        Sets the map of ISet configurations, mapped by config name. The config name may be a pattern with which the configuration will be obtained in the future.
        Parameters:
        setConfigs - the set configuration map to set
        Returns:
        this config instance
      • getMultiMapConfig

        public MultiMapConfig getMultiMapConfig​(java.lang.String name)
        Returns the MultiMapConfig for the given name, creating one if necessary and adding it to the collection of known configurations.

        The configuration is found by matching the configuration name pattern to the provided name without the partition qualifier (the part of the name after '@'). If no configuration matches, it will create one by cloning the "default" configuration and add it to the configuration collection.

        This method is intended to easily and fluently create and add configurations more specific than the default configuration without explicitly adding it by invoking addMultiMapConfig(MultiMapConfig).

        Because it adds new configurations if they are not already present, this method is intended to be used before this config is used to create a hazelcast instance. Afterwards, newly added configurations may be ignored.

        Parameters:
        name - name of the multimap config
        Returns:
        the multimap configuration
        Throws:
        InvalidConfigurationException - if ambiguous configurations are found
        See Also:
        StringPartitioningStrategy.getBaseName(java.lang.String), setConfigPatternMatcher(ConfigPatternMatcher), getConfigPatternMatcher()
      • addMultiMapConfig

        public Config addMultiMapConfig​(MultiMapConfig multiMapConfig)
        Adds the multimap configuration. The configuration is saved under the config name, which may be a pattern with which the configuration will be obtained in the future.
        Parameters:
        multiMapConfig - the multimap configuration
        Returns:
        this config instance
      • getMultiMapConfigs

        public java.util.Map<java.lang.String,​MultiMapConfig> getMultiMapConfigs()
        Returns the map of MultiMap configurations, mapped by config name. The config name may be a pattern with which the configuration was initially obtained.
        Returns:
        the multimap configurations mapped by config name
      • setMultiMapConfigs

        public Config setMultiMapConfigs​(java.util.Map<java.lang.String,​MultiMapConfig> multiMapConfigs)
        Sets the map of MultiMap configurations, mapped by config name. The config name may be a pattern with which the configuration will be obtained in the future.
        Parameters:
        multiMapConfigs - the multimap configuration map to set
        Returns:
        this config instance
      • getReplicatedMapConfig

        public ReplicatedMapConfig getReplicatedMapConfig​(java.lang.String name)
        Returns the ReplicatedMapConfig for the given name, creating one if necessary and adding it to the collection of known configurations.

        The configuration is found by matching the configuration name pattern to the provided name without the partition qualifier (the part of the name after '@'). If no configuration matches, it will create one by cloning the "default" configuration and add it to the configuration collection.

        This method is intended to easily and fluently create and add configurations more specific than the default configuration without explicitly adding it by invoking addReplicatedMapConfig(ReplicatedMapConfig).

        Because it adds new configurations if they are not already present, this method is intended to be used before this config is used to create a hazelcast instance. Afterwards, newly added configurations may be ignored.

        Parameters:
        name - name of the replicated map config
        Returns:
        the replicated map configuration
        Throws:
        InvalidConfigurationException - if ambiguous configurations are found
        See Also:
        StringPartitioningStrategy.getBaseName(java.lang.String), setConfigPatternMatcher(ConfigPatternMatcher), getConfigPatternMatcher()
      • addReplicatedMapConfig

        public Config addReplicatedMapConfig​(ReplicatedMapConfig replicatedMapConfig)
        Adds the replicated map configuration. The configuration is saved under the config name, which may be a pattern with which the configuration will be obtained in the future.
        Parameters:
        replicatedMapConfig - the replicated map configuration
        Returns:
        this config instance
      • getReplicatedMapConfigs

        public java.util.Map<java.lang.String,​ReplicatedMapConfig> getReplicatedMapConfigs()
        Returns the map of ReplicatedMap configurations, mapped by config name. The config name may be a pattern with which the configuration was initially obtained.
        Returns:
        the replicate map configurations mapped by config name
      • setReplicatedMapConfigs

        public Config setReplicatedMapConfigs​(java.util.Map<java.lang.String,​ReplicatedMapConfig> replicatedMapConfigs)
        Sets the map of ReplicatedMap configurations, mapped by config name. The config name may be a pattern with which the configuration will be obtained in the future.
        Parameters:
        replicatedMapConfigs - the replicated map configuration map to set
        Returns:
        this config instance
      • getRingbufferConfig

        public RingbufferConfig getRingbufferConfig​(java.lang.String name)
        Returns the RingbufferConfig for the given name, creating one if necessary and adding it to the collection of known configurations.

        The configuration is found by matching the configuration name pattern to the provided name without the partition qualifier (the part of the name after '@'). If no configuration matches, it will create one by cloning the "default" configuration and add it to the configuration collection.

        This method is intended to easily and fluently create and add configurations more specific than the default configuration without explicitly adding it by invoking addRingBufferConfig(RingbufferConfig).

        Because it adds new configurations if they are not already present, this method is intended to be used before this config is used to create a hazelcast instance. Afterwards, newly added configurations may be ignored.

        Parameters:
        name - name of the ringbuffer config
        Returns:
        the ringbuffer configuration
        Throws:
        InvalidConfigurationException - if ambiguous configurations are found
        See Also:
        StringPartitioningStrategy.getBaseName(java.lang.String), setConfigPatternMatcher(ConfigPatternMatcher), getConfigPatternMatcher()
      • addRingBufferConfig

        public Config addRingBufferConfig​(RingbufferConfig ringbufferConfig)
        Adds the ringbuffer configuration. The configuration is saved under the config name, which may be a pattern with which the configuration will be obtained in the future.
        Parameters:
        ringbufferConfig - the ringbuffer configuration
        Returns:
        this config instance
      • getRingbufferConfigs

        public java.util.Map<java.lang.String,​RingbufferConfig> getRingbufferConfigs()
        Returns the map of Ringbuffer configurations, mapped by config name. The config name may be a pattern with which the configuration was initially obtained.
        Returns:
        the ringbuffer configurations mapped by config name
      • setRingbufferConfigs

        public Config setRingbufferConfigs​(java.util.Map<java.lang.String,​RingbufferConfig> ringbufferConfigs)
        Sets the map of Ringbuffer configurations, mapped by config name. The config name may be a pattern with which the configuration will be obtained in the future.
        Parameters:
        ringbufferConfigs - the ringbuffer configuration map to set
        Returns:
        this config instance
      • getTopicConfig

        public TopicConfig getTopicConfig​(java.lang.String name)
        Returns the TopicConfig for the given name, creating one if necessary and adding it to the collection of known configurations.

        The configuration is found by matching the configuration name pattern to the provided name without the partition qualifier (the part of the name after '@'). If no configuration matches, it will create one by cloning the "default" configuration and add it to the configuration collection.

        This method is intended to easily and fluently create and add configurations more specific than the default configuration without explicitly adding it by invoking addTopicConfig(TopicConfig).

        Because it adds new configurations if they are not already present, this method is intended to be used before this config is used to create a hazelcast instance. Afterwards, newly added configurations may be ignored.

        Parameters:
        name - name of the topic config
        Returns:
        the topic configuration
        Throws:
        InvalidConfigurationException - if ambiguous configurations are found
        See Also:
        StringPartitioningStrategy.getBaseName(java.lang.String), setConfigPatternMatcher(ConfigPatternMatcher), getConfigPatternMatcher()
      • addTopicConfig

        public Config addTopicConfig​(TopicConfig topicConfig)
        Adds the topic configuration. The configuration is saved under the config name, which may be a pattern with which the configuration will be obtained in the future.
        Parameters:
        topicConfig - the topic configuration
        Returns:
        this config instance
      • getReliableTopicConfig

        public ReliableTopicConfig getReliableTopicConfig​(java.lang.String name)
        Returns the ReliableTopicConfig for the given name, creating one if necessary and adding it to the collection of known configurations.

        The configuration is found by matching the configuration name pattern to the provided name without the partition qualifier (the part of the name after '@'). If no configuration matches, it will create one by cloning the "default" configuration and add it to the configuration collection.

        This method is intended to easily and fluently create and add configurations more specific than the default configuration without explicitly adding it by invoking addReliableTopicConfig(ReliableTopicConfig).

        Because it adds new configurations if they are not already present, this method is intended to be used before this config is used to create a hazelcast instance. Afterwards, newly added configurations may be ignored.

        Parameters:
        name - name of the reliable topic config
        Returns:
        the reliable topic configuration
        Throws:
        InvalidConfigurationException - if ambiguous configurations are found
        See Also:
        StringPartitioningStrategy.getBaseName(java.lang.String), setConfigPatternMatcher(ConfigPatternMatcher), getConfigPatternMatcher()
      • getReliableTopicConfigs

        public java.util.Map<java.lang.String,​ReliableTopicConfig> getReliableTopicConfigs()
        Returns the map of reliable topic configurations, mapped by config name. The config name may be a pattern with which the configuration was initially obtained.
        Returns:
        the reliable topic configurations mapped by config name
      • addReliableTopicConfig

        public Config addReliableTopicConfig​(ReliableTopicConfig topicConfig)
        Adds the reliable topic configuration. The configuration is saved under the config name, which may be a pattern with which the configuration will be obtained in the future.
        Parameters:
        topicConfig - the reliable topic configuration
        Returns:
        this config instance
      • setReliableTopicConfigs

        public Config setReliableTopicConfigs​(java.util.Map<java.lang.String,​ReliableTopicConfig> reliableTopicConfigs)
        Sets the map of reliable topic configurations, mapped by config name. The config name may be a pattern with which the configuration will be obtained in the future.
        Parameters:
        reliableTopicConfigs - the reliable topic configuration map to set
        Returns:
        this config instance
      • getTopicConfigs

        public java.util.Map<java.lang.String,​TopicConfig> getTopicConfigs()
        Returns the map of reliable topic configurations, mapped by config name. The config name may be a pattern with which the configuration was initially obtained.
        Returns:
        the reliable topic configurations mapped by config name
      • setTopicConfigs

        public Config setTopicConfigs​(java.util.Map<java.lang.String,​TopicConfig> topicConfigs)
        Sets the map of ITopic configurations, mapped by config name. The config name may be a pattern with which the configuration will be obtained in the future.
        Parameters:
        topicConfigs - the topic configuration map to set
        Returns:
        this config instance
      • getExecutorConfig

        public ExecutorConfig getExecutorConfig​(java.lang.String name)
        Returns the ExecutorConfig for the given name, creating one if necessary and adding it to the collection of known configurations.

        The configuration is found by matching the configuration name pattern to the provided name without the partition qualifier (the part of the name after '@'). If no configuration matches, it will create one by cloning the "default" configuration and add it to the configuration collection.

        This method is intended to easily and fluently create and add configurations more specific than the default configuration without explicitly adding it by invoking addExecutorConfig(ExecutorConfig).

        Because it adds new configurations if they are not already present, this method is intended to be used before this config is used to create a hazelcast instance. Afterwards, newly added configurations may be ignored.

        Parameters:
        name - name of the executor config
        Returns:
        the executor configuration
        Throws:
        InvalidConfigurationException - if ambiguous configurations are found
        See Also:
        StringPartitioningStrategy.getBaseName(java.lang.String), setConfigPatternMatcher(ConfigPatternMatcher), getConfigPatternMatcher()
      • getDurableExecutorConfig

        public DurableExecutorConfig getDurableExecutorConfig​(java.lang.String name)
        Returns the DurableExecutorConfig for the given name, creating one if necessary and adding it to the collection of known configurations.

        The configuration is found by matching the configuration name pattern to the provided name without the partition qualifier (the part of the name after '@'). If no configuration matches, it will create one by cloning the "default" configuration and add it to the configuration collection.

        This method is intended to easily and fluently create and add configurations more specific than the default configuration without explicitly adding it by invoking addDurableExecutorConfig(DurableExecutorConfig).

        Because it adds new configurations if they are not already present, this method is intended to be used before this config is used to create a hazelcast instance. Afterwards, newly added configurations may be ignored.

        Parameters:
        name - name of the durable executor config
        Returns:
        the durable executor configuration
        Throws:
        InvalidConfigurationException - if ambiguous configurations are found
        See Also:
        StringPartitioningStrategy.getBaseName(java.lang.String), setConfigPatternMatcher(ConfigPatternMatcher), getConfigPatternMatcher()
      • getScheduledExecutorConfig

        public ScheduledExecutorConfig getScheduledExecutorConfig​(java.lang.String name)
        Returns the ScheduledExecutorConfig for the given name, creating one if necessary and adding it to the collection of known configurations.

        The configuration is found by matching the configuration name pattern to the provided name without the partition qualifier (the part of the name after '@'). If no configuration matches, it will create one by cloning the "default" configuration and add it to the configuration collection.

        This method is intended to easily and fluently create and add configurations more specific than the default configuration without explicitly adding it by invoking addScheduledExecutorConfig(ScheduledExecutorConfig).

        Because it adds new configurations if they are not already present, this method is intended to be used before this config is used to create a hazelcast instance. Afterwards, newly added configurations may be ignored.

        Parameters:
        name - name of the scheduled executor config
        Returns:
        the scheduled executor configuration
        Throws:
        InvalidConfigurationException - if ambiguous configurations are found
        See Also:
        StringPartitioningStrategy.getBaseName(java.lang.String), setConfigPatternMatcher(ConfigPatternMatcher), getConfigPatternMatcher()
      • getCardinalityEstimatorConfig

        public CardinalityEstimatorConfig getCardinalityEstimatorConfig​(java.lang.String name)
        Returns the CardinalityEstimatorConfig for the given name, creating one if necessary and adding it to the collection of known configurations.

        The configuration is found by matching the configuration name pattern to the provided name without the partition qualifier (the part of the name after '@'). If no configuration matches, it will create one by cloning the "default" configuration and add it to the configuration collection.

        This method is intended to easily and fluently create and add configurations more specific than the default configuration without explicitly adding it by invoking addCardinalityEstimatorConfig(CardinalityEstimatorConfig).

        Because it adds new configurations if they are not already present, this method is intended to be used before this config is used to create a hazelcast instance. Afterwards, newly added configurations may be ignored.

        Parameters:
        name - name of the cardinality estimator config
        Returns:
        the cardinality estimator configuration
        Throws:
        InvalidConfigurationException - if ambiguous configurations are found
        See Also:
        StringPartitioningStrategy.getBaseName(java.lang.String), setConfigPatternMatcher(ConfigPatternMatcher), getConfigPatternMatcher()
      • getPNCounterConfig

        public PNCounterConfig getPNCounterConfig​(java.lang.String name)
        Returns the PNCounterConfig for the given name, creating one if necessary and adding it to the collection of known configurations.

        The configuration is found by matching the configuration name pattern to the provided name without the partition qualifier (the part of the name after '@'). If no configuration matches, it will create one by cloning the "default" configuration and add it to the configuration collection.

        This method is intended to easily and fluently create and add configurations more specific than the default configuration without explicitly adding it by invoking addPNCounterConfig(PNCounterConfig).

        Because it adds new configurations if they are not already present, this method is intended to be used before this config is used to create a hazelcast instance. Afterwards, newly added configurations may be ignored.

        Parameters:
        name - name of the PN counter config
        Returns:
        the PN counter configuration
        Throws:
        InvalidConfigurationException - if ambiguous configurations are found
        See Also:
        StringPartitioningStrategy.getBaseName(java.lang.String), setConfigPatternMatcher(ConfigPatternMatcher), getConfigPatternMatcher()
      • addExecutorConfig

        public Config addExecutorConfig​(ExecutorConfig executorConfig)
        Adds the executor configuration. The configuration is saved under the config name, which may be a pattern with which the configuration will be obtained in the future.
        Parameters:
        executorConfig - executor config to add
        Returns:
        this config instance
      • addDurableExecutorConfig

        public Config addDurableExecutorConfig​(DurableExecutorConfig durableExecutorConfig)
        Adds the durable executor configuration. The configuration is saved under the config name, which may be a pattern with which the configuration will be obtained in the future.
        Parameters:
        durableExecutorConfig - durable executor config to add
        Returns:
        this config instance
      • addScheduledExecutorConfig

        public Config addScheduledExecutorConfig​(ScheduledExecutorConfig scheduledExecutorConfig)
        Adds the scheduled executor configuration. The configuration is saved under the config name, which may be a pattern with which the configuration will be obtained in the future.
        Parameters:
        scheduledExecutorConfig - scheduled executor config to add
        Returns:
        this config instance
      • addCardinalityEstimatorConfig

        public Config addCardinalityEstimatorConfig​(CardinalityEstimatorConfig cardinalityEstimatorConfig)
        Adds the cardinality estimator configuration. The configuration is saved under the config name, which may be a pattern with which the configuration will be obtained in the future.
        Parameters:
        cardinalityEstimatorConfig - cardinality estimator config to add
        Returns:
        this config instance
      • addPNCounterConfig

        public Config addPNCounterConfig​(PNCounterConfig pnCounterConfig)
        Adds the PN counter configuration. The configuration is saved under the config name, which may be a pattern with which the configuration will be obtained in the future.
        Parameters:
        pnCounterConfig - PN counter config to add
        Returns:
        this config instance
      • getExecutorConfigs

        public java.util.Map<java.lang.String,​ExecutorConfig> getExecutorConfigs()
        Returns the map of executor configurations, mapped by config name. The config name may be a pattern with which the configuration was initially obtained.
        Returns:
        the executor configurations mapped by config name
      • setExecutorConfigs

        public Config setExecutorConfigs​(java.util.Map<java.lang.String,​ExecutorConfig> executorConfigs)
        Sets the map of executor configurations, mapped by config name. The config name may be a pattern with which the configuration will be obtained in the future.
        Parameters:
        executorConfigs - the executor configuration map to set
        Returns:
        this config instance
      • getDurableExecutorConfigs

        public java.util.Map<java.lang.String,​DurableExecutorConfig> getDurableExecutorConfigs()
        Returns the map of durable executor configurations, mapped by config name. The config name may be a pattern with which the configuration was initially obtained.
        Returns:
        the durable executor configurations mapped by config name
      • setDurableExecutorConfigs

        public Config setDurableExecutorConfigs​(java.util.Map<java.lang.String,​DurableExecutorConfig> durableExecutorConfigs)
        Sets the map of durable executor configurations, mapped by config name. The config name may be a pattern with which the configuration will be obtained in the future.
        Parameters:
        durableExecutorConfigs - the durable executor configuration map to set
        Returns:
        this config instance
      • getScheduledExecutorConfigs

        public java.util.Map<java.lang.String,​ScheduledExecutorConfig> getScheduledExecutorConfigs()
        Returns the map of scheduled executor configurations, mapped by config name. The config name may be a pattern with which the configuration was initially obtained.
        Returns:
        the scheduled executor configurations mapped by config name
      • setScheduledExecutorConfigs

        public Config setScheduledExecutorConfigs​(java.util.Map<java.lang.String,​ScheduledExecutorConfig> scheduledExecutorConfigs)
        Sets the map of scheduled executor configurations, mapped by config name. The config name may be a pattern with which the configuration will be obtained in the future.
        Parameters:
        scheduledExecutorConfigs - the scheduled executor configuration map to set
        Returns:
        this config instance
      • getCardinalityEstimatorConfigs

        public java.util.Map<java.lang.String,​CardinalityEstimatorConfig> getCardinalityEstimatorConfigs()
        Returns the map of cardinality estimator configurations, mapped by config name. The config name may be a pattern with which the configuration was initially obtained.
        Returns:
        the cardinality estimator configurations mapped by config name
      • setCardinalityEstimatorConfigs

        public Config setCardinalityEstimatorConfigs​(java.util.Map<java.lang.String,​CardinalityEstimatorConfig> cardinalityEstimatorConfigs)
        Sets the map of cardinality estimator configurations, mapped by config name. The config name may be a pattern with which the configuration will be obtained in the future.
        Parameters:
        cardinalityEstimatorConfigs - the cardinality estimator configuration map to set
        Returns:
        this config instance
      • getPNCounterConfigs

        public java.util.Map<java.lang.String,​PNCounterConfig> getPNCounterConfigs()
        Returns the map of PN counter configurations, mapped by config name. The config name may be a pattern with which the configuration was initially obtained.
        Returns:
        the PN counter configurations mapped by config name
      • setPNCounterConfigs

        public Config setPNCounterConfigs​(java.util.Map<java.lang.String,​PNCounterConfig> pnCounterConfigs)
        Sets the map of PN counter configurations, mapped by config name. The config name may be a pattern with which the configuration will be obtained in the future.
        Parameters:
        pnCounterConfigs - the PN counter configuration map to set
        Returns:
        this config instance
      • getWanReplicationConfig

        public WanReplicationConfig getWanReplicationConfig​(java.lang.String name)
        Returns the WAN replication configuration with the given name.
        Parameters:
        name - the WAN replication config name
        Returns:
        the WAN replication config
      • addWanReplicationConfig

        public Config addWanReplicationConfig​(WanReplicationConfig wanReplicationConfig)
        Adds the WAN replication config under the name defined by WanReplicationConfig.getName().
        Parameters:
        wanReplicationConfig - the WAN replication config
        Returns:
        this config instance
      • getWanReplicationConfigs

        public java.util.Map<java.lang.String,​WanReplicationConfig> getWanReplicationConfigs()
        Returns the map of WAN replication configurations, mapped by config name.
        Returns:
        the WAN replication configurations mapped by config name
      • setWanReplicationConfigs

        public Config setWanReplicationConfigs​(java.util.Map<java.lang.String,​WanReplicationConfig> wanReplicationConfigs)
        Sets the map of WAN replication configurations, mapped by config name.
        Parameters:
        wanReplicationConfigs - the WAN replication configuration map to set
        Returns:
        this config instance
      • getSplitBrainProtectionConfigs

        public java.util.Map<java.lang.String,​SplitBrainProtectionConfig> getSplitBrainProtectionConfigs()
        Returns the map of split brain protection configurations, mapped by config name. The config name may be a pattern with which the configuration was initially obtained.
        Returns:
        the split-brain protection configurations mapped by config name
      • getSplitBrainProtectionConfig

        public SplitBrainProtectionConfig getSplitBrainProtectionConfig​(java.lang.String name)
        Returns the SplitBrainProtectionConfig for the given name, creating one if necessary and adding it to the collection of known configurations.

        The configuration is found by matching the configuration name pattern to the provided name without the partition qualifier (the part of the name after '@'). If no configuration matches, it will create one by cloning the "default" configuration and add it to the configuration collection.

        This method is intended to easily and fluently create and add configurations more specific than the default configuration without explicitly adding it by invoking addSplitBrainProtectionConfig(SplitBrainProtectionConfig).

        Because it adds new configurations if they are not already present, this method is intended to be used before this config is used to create a hazelcast instance. Afterwards, newly added configurations may be ignored.

        Parameters:
        name - name of the split-brain protection config
        Returns:
        the split-brain protection configuration
        Throws:
        InvalidConfigurationException - if ambiguous configurations are found
        See Also:
        StringPartitioningStrategy.getBaseName(java.lang.String), setConfigPatternMatcher(ConfigPatternMatcher), getConfigPatternMatcher()
      • setSplitBrainProtectionConfigs

        public Config setSplitBrainProtectionConfigs​(java.util.Map<java.lang.String,​SplitBrainProtectionConfig> splitBrainProtectionConfigs)
        Sets the map of split-brain protection configurations, mapped by config name. The config name may be a pattern with which the configuration will be obtained in the future.
        Parameters:
        splitBrainProtectionConfigs - the split-brain protection configuration map to set
        Returns:
        this config instance
      • addSplitBrainProtectionConfig

        public Config addSplitBrainProtectionConfig​(SplitBrainProtectionConfig splitBrainProtectionConfig)
        Adds the split-brain protection configuration. The configuration is saved under the config name defined by SplitBrainProtectionConfig.getName().
        Parameters:
        splitBrainProtectionConfig - split-brain protection config to add
        Returns:
        this config instance
      • getManagementCenterConfig

        public ManagementCenterConfig getManagementCenterConfig()
        Returns the management center configuration for this hazelcast instance.
        Returns:
        the management center configuration
      • setManagementCenterConfig

        public Config setManagementCenterConfig​(ManagementCenterConfig managementCenterConfig)
        Sets the management center configuration for this hazelcast instance.
        Parameters:
        managementCenterConfig - the management center configuration
        Returns:
        this config instance
      • getSecurityConfig

        public SecurityConfig getSecurityConfig()
        Returns the security configuration for this hazelcast instance. This includes configuration for security interceptors, permissions, etc.
        Returns:
        the security configuration
      • setSecurityConfig

        public Config setSecurityConfig​(SecurityConfig securityConfig)
        Sets the security configuration for this hazelcast instance. This includes configuration for security interceptors, permissions, etc.
        Parameters:
        securityConfig - the security configuration
        Returns:
        this config instance
      • addListenerConfig

        public Config addListenerConfig​(ListenerConfig listenerConfig)
        Adds a configuration for an EventListener. This includes listeners for events related to this instance/member or the cluster, such as partition, migration, cluster version listeners, etc. but not listeners on specific distributed data structures.
        Parameters:
        listenerConfig - the listener configuration
        Returns:
        this config instance
      • getListenerConfigs

        public java.util.List<ListenerConfig> getListenerConfigs()
        Returns the list of EventListener configurations. This includes listeners for events related to this instance/member or the cluster, such as partition, migration, cluster version listeners, etc. but not listeners on specific distributed data structures.
        Returns:
        the listener configurations
      • setListenerConfigs

        public Config setListenerConfigs​(java.util.List<ListenerConfig> listenerConfigs)
        Sets the list of EventListener configurations. This includes listeners for events related to this instance/member or the cluster, such as partition, migration, cluster version listeners, etc. but not listeners on specific distributed data structures.
        Parameters:
        listenerConfigs - the listener configurations
        Returns:
        this config instance
      • getFlakeIdGeneratorConfigs

        public java.util.Map<java.lang.String,​FlakeIdGeneratorConfig> getFlakeIdGeneratorConfigs()
        Returns the map of FlakeIdGenerator configurations, mapped by config name. The config name may be a pattern with which the configuration was initially obtained.
        Returns:
        the map configurations mapped by config name
      • getFlakeIdGeneratorConfig

        public FlakeIdGeneratorConfig getFlakeIdGeneratorConfig​(java.lang.String name)
        Returns the FlakeIdGeneratorConfig for the given name, creating one if necessary and adding it to the collection of known configurations.

        The configuration is found by matching the configuration name pattern to the provided name without the partition qualifier (the part of the name after '@'). If no configuration matches, it will create one by cloning the "default" configuration and add it to the configuration collection.

        This method is intended to easily and fluently create and add configurations more specific than the default configuration without explicitly adding it by invoking addFlakeIdGeneratorConfig(FlakeIdGeneratorConfig).

        Because it adds new configurations if they are not already present, this method is intended to be used before this config is used to create a hazelcast instance. Afterwards, newly added configurations may be ignored.

        Parameters:
        name - name of the flake ID generator config
        Returns:
        the cache configuration
        Throws:
        InvalidConfigurationException - if ambiguous configurations are found
        See Also:
        StringPartitioningStrategy.getBaseName(java.lang.String), setConfigPatternMatcher(ConfigPatternMatcher), getConfigPatternMatcher()
      • addFlakeIdGeneratorConfig

        public Config addFlakeIdGeneratorConfig​(FlakeIdGeneratorConfig config)
        Adds a flake ID generator configuration. The configuration is saved under the config name, which may be a pattern with which the configuration will be obtained in the future.
        Parameters:
        config - the flake ID generator configuration
        Returns:
        this config instance
      • setFlakeIdGeneratorConfigs

        public Config setFlakeIdGeneratorConfigs​(java.util.Map<java.lang.String,​FlakeIdGeneratorConfig> map)
        Sets the map of FlakeIdGenerator configurations, mapped by config name. The config name may be a pattern with which the configuration will be obtained in the future.
        Parameters:
        map - the FlakeIdGenerator configuration map to set
        Returns:
        this config instance
      • getSerializationConfig

        public SerializationConfig getSerializationConfig()
        Returns the serialization configuration for this hazelcast instance. The serialization configuration defines how objects are serialized and deserialized on this instance.
        Returns:
        the serialization configuration
      • setSerializationConfig

        public Config setSerializationConfig​(SerializationConfig serializationConfig)
        Sets the serialization configuration for this hazelcast instance. The serialization configuration defines how objects are serialized and deserialized on this instance.
        Parameters:
        serializationConfig - the serialization configuration
        Returns:
        this config instance
      • getPartitionGroupConfig

        public PartitionGroupConfig getPartitionGroupConfig()
        Returns the partition group configuration for this hazelcast instance. The partition group configuration defines how partitions are mapped to members.
        Returns:
        the partition group configuration
      • setPartitionGroupConfig

        public Config setPartitionGroupConfig​(PartitionGroupConfig partitionGroupConfig)
        Sets the partition group configuration for this hazelcast instance. The partition group configuration defines how partitions are mapped to members.
        Parameters:
        partitionGroupConfig - the partition group configuration
        Returns:
        this config instance
      • getHotRestartPersistenceConfig

        public HotRestartPersistenceConfig getHotRestartPersistenceConfig()
        Returns the Hot Restart configuration for this hazelcast instance
        Returns:
        hot restart configuration
      • getPersistenceConfig

        public PersistenceConfig getPersistenceConfig()
        Returns the Persistence configuration for this hazelcast instance
        Returns:
        persistence configuration
      • setHotRestartPersistenceConfig

        @Deprecated
        public Config setHotRestartPersistenceConfig​(HotRestartPersistenceConfig hrConfig)
        Deprecated.
        Sets the Hot Restart configuration.
        Parameters:
        hrConfig - Hot Restart configuration
        Returns:
        this config instance
        Throws:
        java.lang.NullPointerException - if the hrConfig parameter is null
      • setPersistenceConfig

        public Config setPersistenceConfig​(PersistenceConfig persistenceConfig)
        Sets the Persistence configuration.
        Parameters:
        persistenceConfig - Persistence configuration
        Returns:
        this config instance
        Throws:
        java.lang.NullPointerException - if the persistenceConfig parameter is null
      • getDeviceConfigs

        public java.util.Map<java.lang.String,​DeviceConfig> getDeviceConfigs()
        Returns the map of LocalDeviceConfigs mapped by device name.
        Returns:
        the device configurations mapped by device name
      • setDeviceConfigs

        public Config setDeviceConfigs​(java.util.Map<java.lang.String,​DeviceConfig> deviceConfigs)
        Sets the map of DeviceConfigs mapped by device name.
        Parameters:
        deviceConfigs - device configuration map
        Returns:
        this config instance
      • getDeviceConfig

        @Nullable
        public <T extends DeviceConfig> T getDeviceConfig​(java.lang.String name)
        Returns the device config mapped by the provided device name.
        Parameters:
        name - the device name
        Returns:
        device config or null if absent
      • getDeviceConfig

        @Nullable
        public <T extends DeviceConfig> T getDeviceConfig​(java.lang.Class<T> clazz,
                                                          java.lang.String name)
        Returns the device config mapped by the provided device name.
        Parameters:
        name - the device name
        clazz - desired device implementation class
        Returns:
        device config or null if absent
      • addDeviceConfig

        public Config addDeviceConfig​(DeviceConfig deviceConfig)
        Adds the device configuration.
        Parameters:
        deviceConfig - device config
        Returns:
        this config instance
      • setCRDTReplicationConfig

        public Config setCRDTReplicationConfig​(CRDTReplicationConfig crdtReplicationConfig)
        Sets the replication configuration for CRDT implementations.
        Parameters:
        crdtReplicationConfig - the replication configuration
        Returns:
        this config instance
        Throws:
        java.lang.NullPointerException - if the crdtReplicationConfig parameter is null
      • getManagedContext

        public ManagedContext getManagedContext()
        Returns the external managed context. This context is used to initialize user supplied objects.
        Returns:
        the managed context
      • setManagedContext

        public Config setManagedContext​(ManagedContext managedContext)
        Sets the external managed context. This context is used to initialize user supplied objects.
        Parameters:
        managedContext - the managed context
        Returns:
        this config instance
      • getUserContext

        public java.util.concurrent.ConcurrentMap<java.lang.String,​java.lang.Object> getUserContext()
        Returns the user supplied context. This context can then be obtained from an instance of HazelcastInstance.
        Returns:
        the user supplied context
        See Also:
        HazelcastInstance.getUserContext()
      • setUserContext

        public Config setUserContext​(java.util.concurrent.ConcurrentMap<java.lang.String,​java.lang.Object> userContext)
        Sets the user supplied context. This context can then be obtained from an instance of HazelcastInstance.
        Parameters:
        userContext - the user supplied context
        Returns:
        this config instance
        See Also:
        HazelcastInstance.getUserContext()
      • getNativeMemoryConfig

        public NativeMemoryConfig getNativeMemoryConfig()
        Returns the native memory configuration for this hazelcast instance. The native memory configuration defines the how native memory is used and the limits on its usage.
        Returns:
        the native memory configuration
      • setNativeMemoryConfig

        public Config setNativeMemoryConfig​(NativeMemoryConfig nativeMemoryConfig)
        Sets the native memory configuration for this hazelcast instance. The native memory configuration defines the how native memory is used and the limits on its usage.
        Parameters:
        nativeMemoryConfig - the native memory configuration
        Returns:
        this config instance
      • getConfigurationUrl

        public java.net.URL getConfigurationUrl()
        Returns the URL to the declarative configuration, which has been parsed to create this Config instance.
        Returns:
        the configuration URL if the configuration loaded from a URL or null otherwise
      • setConfigurationUrl

        public Config setConfigurationUrl​(java.net.URL configurationUrl)
        Sets the URL from which this configuration has been retrieved and created.

        Is set by the XmlConfigBuilder, when the XML configuration was retrieved from a URL.

        Parameters:
        configurationUrl - the configuration URL to set
        Returns:
        this config instance
      • getConfigurationFile

        public java.io.File getConfigurationFile()
        Returns the File to the declarative configuration, which has been parsed to create this Config instance.
        Returns:
        the configuration file if the configuration loaded from a file or null otherwise
      • setConfigurationFile

        public Config setConfigurationFile​(java.io.File configurationFile)
        Sets the File from which this configuration has been retrieved and created.

        Is set by the XmlConfigBuilder, when the XML configuration was retrieved from a file.

        Parameters:
        configurationFile - the configuration file to set
      • getLicenseKey

        public java.lang.String getLicenseKey()
        Returns the license key for this hazelcast instance. The license key is used to enable enterprise features.
        Returns:
        the license key
        Throws:
        java.lang.SecurityException - If a security manager exists and the calling method doesn't have corresponding HazelcastRuntimePermission
      • setLicenseKey

        public Config setLicenseKey​(java.lang.String licenseKey)
        Sets the license key for this hazelcast instance. The license key is used to enable enterprise features.
        Parameters:
        licenseKey - the license key
        Returns:
        this config instance
      • isLiteMember

        public boolean isLiteMember()
        Returns true if this member is a lite member. A lite member does not own any partitions.
        Returns:
        true if this member is a lite member
      • setLiteMember

        public Config setLiteMember​(boolean liteMember)
        Sets the flag to indicate if this member is a lite member. A lite member does not own any partitions.
        Parameters:
        liteMember - if this member is a lite member
        Returns:
        this config instance
      • getUserCodeDeploymentConfig

        public UserCodeDeploymentConfig getUserCodeDeploymentConfig()
        Get current configuration of User Code Deployment.
        Returns:
        User Code Deployment configuration
        Since:
        3.8
      • setUserCodeDeploymentConfig

        public Config setUserCodeDeploymentConfig​(UserCodeDeploymentConfig userCodeDeploymentConfig)
        Set User Code Deployment configuration
        Parameters:
        userCodeDeploymentConfig - the user code deployment configuration
        Returns:
        this config instance
        Since:
        3.8
      • getCPSubsystemConfig

        public CPSubsystemConfig getCPSubsystemConfig()
        Get current configuration for the CP subsystem
        Returns:
        CP subsystem configuration
        Since:
        3.12
      • setCPSubsystemConfig

        public Config setCPSubsystemConfig​(CPSubsystemConfig cpSubsystemConfig)
        Set CP subsystem configuration
        Parameters:
        cpSubsystemConfig - the CP subsystem configuration
        Returns:
        this config instance
        Since:
        3.12
      • getMetricsConfig

        @Nonnull
        public MetricsConfig getMetricsConfig()
        Returns the metrics collection config.
      • setMetricsConfig

        @Nonnull
        public Config setMetricsConfig​(@Nonnull
                                       MetricsConfig metricsConfig)
        Sets the metrics collection config.
      • getAuditlogConfig

        @Nonnull
        public AuditlogConfig getAuditlogConfig()
      • setAuditlogConfig

        @Nonnull
        public Config setAuditlogConfig​(@Nonnull
                                        AuditlogConfig auditlogConfig)
      • getSqlConfig

        @Nonnull
        public SqlConfig getSqlConfig()
        Returns:
        Return SQL config.
      • setSqlConfig

        @Nonnull
        public Config setSqlConfig​(@Nonnull
                                   SqlConfig sqlConfig)
        Sets SQL config.
      • getInstanceTrackingConfig

        @Nonnull
        public InstanceTrackingConfig getInstanceTrackingConfig()
        Returns the configuration for tracking use of this Hazelcast instance.
      • setInstanceTrackingConfig

        @Nonnull
        public Config setInstanceTrackingConfig​(@Nonnull
                                                InstanceTrackingConfig instanceTrackingConfig)
        Sets the configuration for tracking use of this Hazelcast instance.
      • getJetConfig

        @Nonnull
        public JetConfig getJetConfig()
        Returns the Jet config
      • setJetConfig

        @Nonnull
        public Config setJetConfig​(JetConfig jetConfig)
        Sets the Jet config
      • getDynamicConfigurationConfig

        public DynamicConfigurationConfig getDynamicConfigurationConfig()
        Returns the dynamic configuration config.
      • setDynamicConfigurationConfig

        public Config setDynamicConfigurationConfig​(DynamicConfigurationConfig dynamicConfigurationConfig)
        Sets the dynamic configuration config.
      • getIntegrityCheckerConfig

        @Nonnull
        public IntegrityCheckerConfig getIntegrityCheckerConfig()
        Returns the IntegrityChecker config
        Since:
        5.1
      • setIntegrityCheckerConfig

        @Nonnull
        public Config setIntegrityCheckerConfig​(IntegrityCheckerConfig integrityCheckerConfig)
        Sets the Integrity Checker config
        Since:
        5.1
      • getDataConnectionConfigs

        @Beta
        public java.util.Map<java.lang.String,​DataConnectionConfig> getDataConnectionConfigs()
        Returns the map of data connection configurations, mapped by config name.
        Since:
        5.3
      • addDataConnectionConfig

        @Beta
        public Config addDataConnectionConfig​(DataConnectionConfig dataConnectionConfig)
        Adds a data connection configuration.

        Example:

        
              Config config = new Config();
              Properties properties = new Properties();
              properties.put("jdbcUrl", jdbcUrl);
              properties.put("username", username);
              properties.put("password", password);
              DataConnectionConfig dataConnectionConfig = new DataConnectionConfig()
                      .setName("my-jdbc-data-connection")
                      .setType("Jdbc")
                      .setProperties(properties);
              config.addDataConnectionConfig(dataConnectionConfig);
         
        Since:
        5.3
      • getDataConnectionConfig

        @Beta
        public DataConnectionConfig getDataConnectionConfig​(java.lang.String name)
        Returns the data connection configuration for the given name, creating one if necessary and adding it to the collection of known configurations.

        The configuration is found by matching the configuration name pattern to the provided name without the partition qualifier (the part of the name after '@'). If no configuration matches, it will create one by cloning the "default" configuration and add it to the configuration collection.

        This method is intended to easily and fluently create and add configurations more specific than the default configuration without explicitly adding it by invoking addDataConnectionConfig(DataConnectionConfig).

        Because it adds new configurations if they are not already present, this method is intended to be used before this config is used to create a hazelcast instance. Afterwards, newly added configurations may be ignored.

        Parameters:
        name - data connection name
        Returns:
        data connection configuration
        Throws:
        InvalidConfigurationException - if ambiguous configurations are found
        Since:
        5.3
        See Also:
        StringPartitioningStrategy.getBaseName(java.lang.String), setConfigPatternMatcher(ConfigPatternMatcher), getConfigPatternMatcher()
      • getTpcConfig

        @Beta
        @Nonnull
        public TpcConfig getTpcConfig()
        Gets the TpcConfig. Can't return null.
        Returns:
        the TpcConfig.
        Since:
        5.3
      • setTpcConfig

        @Beta
        @Nonnull
        public Config setTpcConfig​(@Nonnull
                                   TpcConfig tpcConfig)
        Sets the TpcConfig.
        Parameters:
        tpcConfig - the TpcConfig.
        Returns:
        this config
        Throws:
        java.lang.NullPointerException - if tpcConfig is null
        Since:
        5.3
      • getServicesConfig

        @PrivateApi
        protected com.hazelcast.internal.config.ServicesConfig getServicesConfig()
        Returns the configuration for the user services managed by this hazelcast instance.
        Returns:
        the user services configuration
      • toString

        public java.lang.String toString()
        Overrides:
        toString in class java.lang.Object