com.electronwill.nightconfig.core

Interface CommentedConfig

All Superinterfaces:

Config, UnmodifiableCommentedConfig, UnmodifiableConfig

All Known Subinterfaces:

CommentedFileConfig, ConcurrentCommentedConfig

All Known Implementing Classes:

AbstractCommentedConfig, CommentedConfigWrapper, ConcurrentCommentedConfigWrapper, ConvertedCommentedConfig, ConvertedCommentedFileConfig, FakeCommentedConfig, StampedConfig, StampedConfig.Accumulator, SynchronizedConfig

public interface CommentedConfig
extends UnmodifiableCommentedConfig, Config

A modifiable config that supports comments.

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static interface	CommentedConfig.Entry A modifiable commented config entry.

Nested classes/interfaces inherited from interface com.electronwill.nightconfig.core.UnmodifiableCommentedConfig

UnmodifiableCommentedConfig.CommentNode

Method Summary

Modifier and Type	Method and Description
default CommentedConfig	checked() Returns a checked view of the config.
void	clearComments() Removes all the comments from the config.
java.util.Map<java.lang.String,java.lang.String>	commentMap() Deprecated. commentMap() may not be supported by some config types, in particular ConcurrentConfig, and may be removed in a future version. Prefer to use entrySet() instead.
static CommentedConfig	concurrentCopy(UnmodifiableCommentedConfig config) Deprecated. A concurrent HashMap is not enough to make the whole configuration robust to multi-threaded use. Prefer to use a ConcurrentConfig instead.
static CommentedConfig	concurrentCopy(UnmodifiableCommentedConfig config, ConfigFormat<?> format) Deprecated. A concurrent HashMap is not enough to make the whole configuration robust to multi-threaded use. Prefer to use a ConcurrentConfig instead.
static CommentedConfig	concurrentCopy(UnmodifiableConfig config) Deprecated. A concurrent HashMap is not enough to make the whole configuration robust to multi-threaded use. Prefer to use a ConcurrentConfig instead.
static CommentedConfig	concurrentCopy(UnmodifiableConfig config, ConfigFormat<?> format) Deprecated. A concurrent HashMap is not enough to make the whole configuration robust to multi-threaded use. Prefer to use a ConcurrentConfig instead.
static CommentedConfig	copy(UnmodifiableCommentedConfig config) Creates a new CommentedConfig with the content of the given config.
static CommentedConfig	copy(UnmodifiableCommentedConfig config, ConfigFormat<?> format) Creates a new CommentedConfig with the content of the given config.
static CommentedConfig	copy(UnmodifiableCommentedConfig config, java.util.function.Supplier<java.util.Map<java.lang.String,java.lang.Object>> mapCreator) Creates a new CommentedConfig with the content of the given config.
static CommentedConfig	copy(UnmodifiableCommentedConfig config, java.util.function.Supplier<java.util.Map<java.lang.String,java.lang.Object>> mapCreator, ConfigFormat<? extends CommentedConfig> format) Creates a new CommentedConfig with the content of the given config.
static CommentedConfig	copy(UnmodifiableConfig config) Creates a new CommentedConfig with the content of the given config.
static CommentedConfig	copy(UnmodifiableConfig config, ConfigFormat<?> format) Creates a new CommentedConfig with the content of the given config.
static CommentedConfig	copy(UnmodifiableConfig config, java.util.function.Supplier<java.util.Map<java.lang.String,java.lang.Object>> mapCreator) Creates a new CommentedConfig with the content of the given config.
static CommentedConfig	copy(UnmodifiableConfig config, java.util.function.Supplier<java.util.Map<java.lang.String,java.lang.Object>> mapCreator, ConfigFormat<?> format) Creates a new CommentedConfig with the content of the given config.
CommentedConfig	createSubConfig() Creates a new sub config of this config, as created when a subconfig's creation is implied by Config.set(List, Object) or Config.add(List, Object).
java.util.Set<? extends CommentedConfig.Entry>	entrySet() Returns a Set view of the config's entries.
static CommentedConfig	fake(Config config) If the specified config is an instance of CommentedConfig, returns it.
static CommentedConfig	inMemory() Creates a CommentedConfig with format InMemoryCommentedFormat.defaultInstance().
static CommentedConfig	inMemoryConcurrent() Deprecated. A concurrent HashMap is not enough to make the whole configuration robust to multi-threaded use. Prefer to use a ConcurrentConfig instead.
static CommentedConfig	of(ConfigFormat<? extends CommentedConfig> format) Creates a CommentedConfig of the given format.
static CommentedConfig	of(java.util.function.Supplier<java.util.Map<java.lang.String,java.lang.Object>> mapCreator, ConfigFormat<? extends CommentedConfig> format) Creates a Config backed by a certain kind of map, given by a supplier.
static CommentedConfig	ofConcurrent(ConfigFormat<? extends CommentedConfig> format) Deprecated. A concurrent HashMap is not enough to make the whole configuration robust to multi-threaded use. Prefer to use a ConcurrentConfig instead.
default void	putAllComments(java.util.Map<java.lang.String,UnmodifiableCommentedConfig.CommentNode> comments) Puts the comments in the given map to this config.
default void	putAllComments(UnmodifiableCommentedConfig commentedConfig) Puts the comments in the given config to this config.
java.lang.String	removeComment(java.util.List<java.lang.String> path) Removes a comment from the config.
default java.lang.String	removeComment(java.lang.String path) Removes a comment from the config.
java.lang.String	setComment(java.util.List<java.lang.String> path, java.lang.String comment) Sets a config comment.
default java.lang.String	setComment(java.lang.String path, java.lang.String comment) Sets a config comment.
default UnmodifiableCommentedConfig	unmodifiable() Returns an Unmodifiable view of the config.
static CommentedConfig	wrap(java.util.Map<java.lang.String,java.lang.Object> map, ConfigFormat<?> format) Creates a CommentedConfig backed by a Map.

Methods inherited from interface com.electronwill.nightconfig.core.UnmodifiableCommentedConfig

containsComment, containsComment, fake, getComment, getComment, getComments, getComments, getOptionalComment, getOptionalComment

Methods inherited from interface com.electronwill.nightconfig.core.Config

add, add, addAll, clear, getDefaultMapCreator, getDefaultMapCreator, inMemoryUniversal, inMemoryUniversalConcurrent, isInsertionOrderPreserved, of, of, ofConcurrent, putAll, remove, remove, removeAll, set, set, setInsertionOrderPreserved, update, update, valueMap

Methods inherited from interface com.electronwill.nightconfig.core.UnmodifiableConfig

apply, apply, configFormat, contains, contains, get, get, getByte, getByte, getByteOrElse, getByteOrElse, getChar, getChar, getCharOrElse, getCharOrElse, getEnum, getEnum, getEnum, getEnum, getEnumOrElse, getEnumOrElse, getEnumOrElse, getEnumOrElse, getEnumOrElse, getEnumOrElse, getEnumOrElse, getEnumOrElse, getInt, getInt, getIntOrElse, getIntOrElse, getIntOrElse, getIntOrElse, getLong, getLong, getLongOrElse, getLongOrElse, getLongOrElse, getLongOrElse, getOptional, getOptional, getOptionalEnum, getOptionalEnum, getOptionalEnum, getOptionalEnum, getOptionalInt, getOptionalInt, getOptionalLong, getOptionalLong, getOrElse, getOrElse, getOrElse, getOrElse, getRaw, getRaw, getShort, getShort, getShortOrElse, getShortOrElse, isEmpty, isNull, isNull, size

Method Detail

setComment

default java.lang.String setComment(java.lang.String path,
                                    java.lang.String comment)

Sets a config comment.

Parameters:

path - the comment's path, each part separated by a dot. Example "a.b.c"

comment - the comment to set

Returns:

the old comment if any, or null

setComment

java.lang.String setComment(java.util.List<java.lang.String> path,
                            java.lang.String comment)

Sets a config comment.

Parameters:

path - the comment's path, each element of the list is a different part of the path.

comment - the comment to set

Returns:

the old comment if any, or null

removeComment

default java.lang.String removeComment(java.lang.String path)

Removes a comment from the config.

Parameters:

path - the comment's path, each part separated by a dot. Example "a.b.c"

Returns:

the old comment if any, or null

removeComment

java.lang.String removeComment(java.util.List<java.lang.String> path)

Removes a comment from the config.

Parameters:

path - the comment's path, each element of the list is a different part of the path.

Returns:

the old comment if any, or null

clearComments

void clearComments()

Removes all the comments from the config.

putAllComments

default void putAllComments(java.util.Map<java.lang.String,UnmodifiableCommentedConfig.CommentNode> comments)

Puts the comments in the given map to this config. Existing comments are replaced, missing comments are created.

Parameters:

comments - the comments to set

putAllComments

default void putAllComments(UnmodifiableCommentedConfig commentedConfig)

Puts the comments in the given config to this config. Existing comments are replaced, missing comments are created.

The comments are copied recursively, but missing sub-configurations are NOT created.

Parameters:

commentedConfig - the config to copy its comments

unmodifiable

default UnmodifiableCommentedConfig unmodifiable()

Description copied from interface: Config

Returns an Unmodifiable view of the config. Any change to the original (modifiable) config is still reflected to the returned UnmodifiableConfig, so it's unmodifiable but not immutable.

Specified by:

unmodifiable in interface Config

Returns:

an Unmodifiable view of the config.

checked

default CommentedConfig checked()

Description copied from interface: Config

Returns a checked view of the config. It checks that all the values put into the config are supported by the config's format (as per the ConfigFormat.supportsType(Class) method. Trying to insert an unsupported value throws an IllegalArgumentException.

The values that are in the config when this method is called are also checked.

Specified by:

checked in interface Config

Returns:

a checked view of the config.

commentMap

@Deprecated
java.util.Map<java.lang.String,java.lang.String> commentMap()

Deprecated. commentMap() may not be supported by some config types, in particular ConcurrentConfig, and may be removed in a future version. Prefer to use entrySet() instead.

Returns a Map view of the config's comments. Any change to the map is reflected in the config and vice-versa.

The comment map contains only the comments of the direct elements of the configuration, not the comments of their sub-elements.

Specified by:

commentMap in interface UnmodifiableCommentedConfig

Returns:

a Map view of the config's comments.

entrySet

java.util.Set<? extends CommentedConfig.Entry> entrySet()

Description copied from interface: UnmodifiableConfig

Returns a Set view of the config's entries. If the config is unmodifiable then the returned set is unmodifiable too.

Specified by:

entrySet in interface Config

Specified by:

entrySet in interface UnmodifiableCommentedConfig

Specified by:

entrySet in interface UnmodifiableConfig

Returns:

a Set view of the config's entries.

createSubConfig

CommentedConfig createSubConfig()

Description copied from interface: Config

Creates a new sub config of this config, as created when a subconfig's creation is implied by Config.set(List, Object) or Config.add(List, Object).

Specified by:

createSubConfig in interface Config

Returns:

a new sub config

of

static CommentedConfig of(ConfigFormat<? extends CommentedConfig> format)

Creates a CommentedConfig of the given format.

Parameters:

format - the config's format

Returns:

a new empty config

of

static CommentedConfig of(java.util.function.Supplier<java.util.Map<java.lang.String,java.lang.Object>> mapCreator,
                          ConfigFormat<? extends CommentedConfig> format)

Creates a Config backed by a certain kind of map, given by a supplier.

Parameters:

mapCreator - a supplier which will be called to create all backing maps for this config (including sub-configs)

format - the config's format

Returns:

a new empty config

ofConcurrent

@Deprecated
static CommentedConfig ofConcurrent(ConfigFormat<? extends CommentedConfig> format)

Deprecated. A concurrent HashMap is not enough to make the whole configuration robust to multi-threaded use. Prefer to use a ConcurrentConfig instead.

Creates a thread-safe CommentedConfig of the given format.

Parameters:

format - the config's format

Returns:

a new empty, thread-safe config

inMemory

static CommentedConfig inMemory()

Creates a CommentedConfig with format InMemoryCommentedFormat.defaultInstance().

Specified by:

inMemory in interface Config

Returns:

a new empty config

inMemoryConcurrent

@Deprecated
static CommentedConfig inMemoryConcurrent()

Deprecated. A concurrent HashMap is not enough to make the whole configuration robust to multi-threaded use. Prefer to use a ConcurrentConfig instead.

Creates a CommentedConfig with format InMemoryFormat.defaultInstance().

Specified by:

inMemoryConcurrent in interface Config

Returns:

a new empty config

wrap

static CommentedConfig wrap(java.util.Map<java.lang.String,java.lang.Object> map,
                            ConfigFormat<?> format)

Creates a CommentedConfig backed by a Map. Any change to the map is reflected in the config and vice-versa.

Specified by:

wrap in interface Config

Parameters:

map - the Map to use

format - the config's format

Returns:

a new config backed by the map

copy

static CommentedConfig copy(UnmodifiableConfig config)

Creates a new CommentedConfig with the content of the given config. The returned config will have the same format as the copied config.

Specified by:

copy in interface Config

Parameters:

config - the config to copy

Returns:

a copy of the config

copy

static CommentedConfig copy(UnmodifiableConfig config,
                            java.util.function.Supplier<java.util.Map<java.lang.String,java.lang.Object>> mapCreator)

Creates a new CommentedConfig with the content of the given config. The returned config will have the same format as the copied config, and be backed by the given supplier.

Specified by:

copy in interface Config

Parameters:

config - the config to copy

mapCreator - a supplier which will be called to create all backing maps for this config (including sub-configs)

Returns:

a copy of the config

See Also:

of(Supplier, ConfigFormat)

copy

static CommentedConfig copy(UnmodifiableConfig config,
                            ConfigFormat<?> format)

Creates a new CommentedConfig with the content of the given config.

Specified by:

copy in interface Config

Parameters:

config - the config to copy

format - the config's format

Returns:

a copy of the config

copy

static CommentedConfig copy(UnmodifiableConfig config,
                            java.util.function.Supplier<java.util.Map<java.lang.String,java.lang.Object>> mapCreator,
                            ConfigFormat<?> format)

Creates a new CommentedConfig with the content of the given config. The returned config will be backed by the given map supplier.

Specified by:

copy in interface Config

Parameters:

config - the config to copy

mapCreator - a supplier which will be called to create all backing maps for this config (including sub-configs)

format - the config's format

Returns:

a copy of the config

See Also:

of(Supplier, ConfigFormat)

copy

static CommentedConfig copy(UnmodifiableCommentedConfig config)

Creates a new CommentedConfig with the content of the given config. The returned config will have the same format as the copied config.

Parameters:

config - the config to copy

Returns:

a copy of the config

copy

static CommentedConfig copy(UnmodifiableCommentedConfig config,
                            java.util.function.Supplier<java.util.Map<java.lang.String,java.lang.Object>> mapCreator)

Creates a new CommentedConfig with the content of the given config. The returned config will have the same format as the copied config.

Parameters:

config - the config to copy

mapCreator - a supplier which will be called to create all backing maps for this config (including sub-configs)

Returns:

a copy of the config

copy

static CommentedConfig copy(UnmodifiableCommentedConfig config,
                            ConfigFormat<?> format)

Creates a new CommentedConfig with the content of the given config.

Parameters:

config - the config to copy

format - the config's format

Returns:

a copy of the config

copy

static CommentedConfig copy(UnmodifiableCommentedConfig config,
                            java.util.function.Supplier<java.util.Map<java.lang.String,java.lang.Object>> mapCreator,
                            ConfigFormat<? extends CommentedConfig> format)

Creates a new CommentedConfig with the content of the given config. The returned config will be backed by the given map supplier.

Parameters:

config - the config to copy

mapCreator - a supplier which will be called to create all backing maps for this config (including sub-configs)

format - the config's format

Returns:

a copy of the config

See Also:

of(Supplier, ConfigFormat)

concurrentCopy

@Deprecated
static CommentedConfig concurrentCopy(UnmodifiableConfig config)

Deprecated. A concurrent HashMap is not enough to make the whole configuration robust to multi-threaded use. Prefer to use a ConcurrentConfig instead.

Creates a new CommentedConfig with the content of the given config. The returned config will have the same format as the copied config.

Specified by:

concurrentCopy in interface Config

Parameters:

config - the config to copy

Returns:

a thread-safe copy of the config

concurrentCopy

@Deprecated
static CommentedConfig concurrentCopy(UnmodifiableConfig config,
                                                  ConfigFormat<?> format)

Deprecated. A concurrent HashMap is not enough to make the whole configuration robust to multi-threaded use. Prefer to use a ConcurrentConfig instead.

Creates a new CommentedConfig with the content of the given config.

Specified by:

concurrentCopy in interface Config

Parameters:

config - the config to copy

format - the config's format

Returns:

a thread-safe copy of the config

concurrentCopy

@Deprecated
static CommentedConfig concurrentCopy(UnmodifiableCommentedConfig config)

Deprecated. A concurrent HashMap is not enough to make the whole configuration robust to multi-threaded use. Prefer to use a ConcurrentConfig instead.

Creates a new CommentedConfig with the content of the given config. The returned config will have the same format as the copied config.

Parameters:

config - the config to copy

Returns:

a thread-safe copy of the config

concurrentCopy

@Deprecated
static CommentedConfig concurrentCopy(UnmodifiableCommentedConfig config,
                                                  ConfigFormat<?> format)

Deprecated. A concurrent HashMap is not enough to make the whole configuration robust to multi-threaded use. Prefer to use a ConcurrentConfig instead.

Creates a new CommentedConfig with the content of the given config.

Parameters:

config - the config to copy

format - the config's format

Returns:

a thread-safe copy of the config

fake

static CommentedConfig fake(Config config)

If the specified config is an instance of CommentedConfig, returns it. Else, returns a "fake" CommentedConfig instance with the same values (ie the valueMaps are equal) as the config. This fake CommentedConfig doesn't actually store nor process comments, it just provides the methods of CommentedConfig.

Parameters:

config - the config

Returns:

a CommentedConfig instance backed by the specified config