org.elasticsearch.common.settings

Class Settings.Builder

java.lang.Object

org.elasticsearch.common.settings.Settings.Builder

Enclosing class:

Settings

public static class Settings.Builder
extends java.lang.Object

A builder allowing to put different settings and then build() an immutable settings implementation. Use Settings.builder() in order to construct it.

Field Summary

Fields

Modifier and Type	Field and Description
static Settings	EMPTY_SETTINGS

Method Summary

Modifier and Type	Method and Description
Settings	build() Builds a Settings (underlying uses Settings) based on everything set on this builder.
Settings.Builder	extendArray(java.lang.String setting, java.lang.String... values) Sets the setting as an array of values, but keeps existing elements for the key.
java.lang.String	get(java.lang.String key) Returns a setting value based on the setting key.
java.util.Map<java.lang.String,java.lang.String>	internalMap()
Settings.Builder	loadFromPath(java.nio.file.Path path) Loads settings from a url that represents them using the SettingsLoaderFactory.loaderFromResource(String).
Settings.Builder	loadFromSource(java.lang.String source) Deprecated. use loadFromSource(String, XContentType) to avoid content type detection
Settings.Builder	loadFromSource(java.lang.String source, XContentType xContentType) Loads settings from the actual string content that represents them using the SettingsLoaderFactory.loaderFromXContentType(XContentType) method to obtain a loader
Settings.Builder	loadFromStream(java.lang.String resourceName, java.io.InputStream is) Loads settings from a stream that represents them using the SettingsLoaderFactory.loaderFromResource(String).
Settings.Builder	normalizePrefix(java.lang.String prefix) Checks that all settings in the builder start with the specified prefix.
Settings.Builder	put(java.util.Dictionary<java.lang.Object,java.lang.Object> properties) Sets all the provided settings.
Settings.Builder	put(java.util.Map<java.lang.String,java.lang.String> settings) Sets all the provided settings.
Settings.Builder	put(java.lang.Object... settings) Puts tuples of key value pairs of settings.
Settings.Builder	put(Settings settings) Sets all the provided settings.
Settings.Builder	put(java.lang.String setting, boolean value) Sets the setting with the provided setting key and the boolean value.
Settings.Builder	put(java.lang.String key, java.lang.Class clazz) Sets a setting with the provided setting key and class as value.
Settings.Builder	put(java.lang.String setting, double value) Sets the setting with the provided setting key and the double value.
Settings.Builder	put(java.lang.String setting, float value) Sets the setting with the provided setting key and the float value.
Settings.Builder	put(java.lang.String setting, int value) Sets the setting with the provided setting key and the int value.
Settings.Builder	put(java.lang.String setting, long value) Sets the setting with the provided setting key and the long value.
Settings.Builder	put(java.lang.String setting, long value, ByteSizeUnit sizeUnit) Sets the setting with the provided setting key and the size value.
Settings.Builder	put(java.lang.String setting, long value, java.util.concurrent.TimeUnit timeUnit) Sets the setting with the provided setting key and the time value.
Settings.Builder	put(java.lang.String key, java.lang.String value) Sets a setting with the provided setting key and value.
Settings.Builder	put(java.lang.String settingPrefix, java.lang.String groupName, java.lang.String[] settings, java.lang.String[] values) Sets the setting group.
Settings.Builder	put(java.lang.String setting, Version version)
Settings.Builder	putArray(java.lang.String setting, java.util.List<java.lang.String> values) Sets the setting with the provided setting key and a list of values.
Settings.Builder	putArray(java.lang.String setting, java.lang.String... values) Sets the setting with the provided setting key and an array of values.
Settings.Builder	putNull(java.lang.String key)
Settings.Builder	putProperties(java.util.Map<java.lang.String,java.lang.String> esSettings, java.util.function.Function<java.lang.String,java.lang.String> keyFunction)
java.lang.String	remove(java.lang.String key) Removes the provided setting from the internal map holding the current list of settings.
Settings.Builder	replacePropertyPlaceholders() Runs across all the settings set on this builder and replaces ${...} elements in each setting with another setting already set on this builder.
Settings.Builder	setSecureSettings(SecureSettings secureSettings)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

EMPTY_SETTINGS

public static final Settings EMPTY_SETTINGS

Method Detail

internalMap

public java.util.Map<java.lang.String,java.lang.String> internalMap()

remove

public java.lang.String remove(java.lang.String key)

Removes the provided setting from the internal map holding the current list of settings.

get

public java.lang.String get(java.lang.String key)

Returns a setting value based on the setting key.

setSecureSettings

public Settings.Builder setSecureSettings(SecureSettings secureSettings)

put

public Settings.Builder put(java.lang.Object... settings)

Puts tuples of key value pairs of settings. Simplified version instead of repeating calling put for each one.

put

public Settings.Builder put(java.lang.String key,
                            java.lang.String value)

Sets a setting with the provided setting key and value.

Parameters:

key - The setting key

value - The setting value

Returns:

The builder

putNull

public Settings.Builder putNull(java.lang.String key)

put

public Settings.Builder put(java.lang.String key,
                            java.lang.Class clazz)

Sets a setting with the provided setting key and class as value.

Parameters:

key - The setting key

clazz - The setting class value

Returns:

The builder

put

public Settings.Builder put(java.lang.String setting,
                            boolean value)

Sets the setting with the provided setting key and the boolean value.

Parameters:

setting - The setting key

value - The boolean value

Returns:

The builder

put

public Settings.Builder put(java.lang.String setting,
                            int value)

Sets the setting with the provided setting key and the int value.

Parameters:

setting - The setting key

value - The int value

Returns:

The builder

put

public Settings.Builder put(java.lang.String setting,
                            Version version)

put

public Settings.Builder put(java.lang.String setting,
                            long value)

Sets the setting with the provided setting key and the long value.

Parameters:

setting - The setting key

value - The long value

Returns:

The builder

put

public Settings.Builder put(java.lang.String setting,
                            float value)

Sets the setting with the provided setting key and the float value.

Parameters:

setting - The setting key

value - The float value

Returns:

The builder

put

public Settings.Builder put(java.lang.String setting,
                            double value)

Sets the setting with the provided setting key and the double value.

Parameters:

setting - The setting key

value - The double value

Returns:

The builder

put

public Settings.Builder put(java.lang.String setting,
                            long value,
                            java.util.concurrent.TimeUnit timeUnit)

Sets the setting with the provided setting key and the time value.

Parameters:

setting - The setting key

value - The time value

Returns:

The builder

put

public Settings.Builder put(java.lang.String setting,
                            long value,
                            ByteSizeUnit sizeUnit)

Sets the setting with the provided setting key and the size value.

Parameters:

setting - The setting key

value - The size value

Returns:

The builder

putArray

public Settings.Builder putArray(java.lang.String setting,
                                 java.lang.String... values)

Sets the setting with the provided setting key and an array of values.

Parameters:

setting - The setting key

values - The values

Returns:

The builder

putArray

public Settings.Builder putArray(java.lang.String setting,
                                 java.util.List<java.lang.String> values)

Sets the setting with the provided setting key and a list of values.

Parameters:

setting - The setting key

values - The values

Returns:

The builder

extendArray

public Settings.Builder extendArray(java.lang.String setting,
                                    java.lang.String... values)

Sets the setting as an array of values, but keeps existing elements for the key.

put

public Settings.Builder put(java.lang.String settingPrefix,
                            java.lang.String groupName,
                            java.lang.String[] settings,
                            java.lang.String[] values)
                     throws SettingsException

Sets the setting group.

Throws:

SettingsException

put

public Settings.Builder put(Settings settings)

Sets all the provided settings.

put

public Settings.Builder put(java.util.Map<java.lang.String,java.lang.String> settings)

Sets all the provided settings.

put

public Settings.Builder put(java.util.Dictionary<java.lang.Object,java.lang.Object> properties)

Sets all the provided settings.

loadFromSource

@Deprecated
public Settings.Builder loadFromSource(java.lang.String source)

Deprecated. use loadFromSource(String, XContentType) to avoid content type detection

Loads settings from the actual string content that represents them using the SettingsLoaderFactory.loaderFromSource(String).

loadFromSource

public Settings.Builder loadFromSource(java.lang.String source,
                                       XContentType xContentType)

Loads settings from the actual string content that represents them using the SettingsLoaderFactory.loaderFromXContentType(XContentType) method to obtain a loader

loadFromPath

public Settings.Builder loadFromPath(java.nio.file.Path path)
                              throws java.io.IOException

Loads settings from a url that represents them using the SettingsLoaderFactory.loaderFromResource(String).

Throws:

java.io.IOException

loadFromStream

public Settings.Builder loadFromStream(java.lang.String resourceName,
                                       java.io.InputStream is)
                                throws java.io.IOException

Loads settings from a stream that represents them using the SettingsLoaderFactory.loaderFromResource(String).

Throws:

java.io.IOException

putProperties

public Settings.Builder putProperties(java.util.Map<java.lang.String,java.lang.String> esSettings,
                                      java.util.function.Function<java.lang.String,java.lang.String> keyFunction)

replacePropertyPlaceholders

public Settings.Builder replacePropertyPlaceholders()

Runs across all the settings set on this builder and replaces ${...} elements in each setting with another setting already set on this builder.

normalizePrefix

public Settings.Builder normalizePrefix(java.lang.String prefix)

Checks that all settings in the builder start with the specified prefix. If a setting doesn't start with the prefix, the builder appends the prefix to such setting.

build

public Settings build()

Builds a Settings (underlying uses Settings) based on everything set on this builder.