com.electronwill.nightconfig.core.conversion

Class ConvertedCommentedFileConfig

java.lang.Object

com.electronwill.nightconfig.core.utils.UnmodifiableConfigWrapper<C>

com.electronwill.nightconfig.core.utils.ConfigWrapper<C>

com.electronwill.nightconfig.core.conversion.ConvertedCommentedFileConfig

All Implemented Interfaces:

CommentedConfig, Config, CommentedFileConfig, FileConfig, UnmodifiableCommentedConfig, UnmodifiableConfig, java.lang.AutoCloseable

public final class ConvertedCommentedFileConfig
extends ConfigWrapper<C>
implements CommentedFileConfig

Nested Class Summary

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

CommentedConfig.Entry

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

UnmodifiableCommentedConfig.CommentNode

Field Summary

Fields inherited from class com.electronwill.nightconfig.core.utils.UnmodifiableConfigWrapper

config

Constructor Summary

Constructors

Constructor and Description
ConvertedCommentedFileConfig(CommentedFileConfig config, ConversionTable readTable, ConversionTable writeTable, java.util.function.Predicate<java.lang.Class<?>> supportPredicate)
ConvertedCommentedFileConfig(CommentedFileConfig config, java.util.function.Function<java.lang.Object,java.lang.Object> readConversion, java.util.function.Function<java.lang.Object,java.lang.Object> writeConversion, java.util.function.Predicate<java.lang.Class<?>> supportPredicate)

Method Summary

Modifier and Type	Method and Description
void	clearComments() Removes all the comments from the config.
void	close() Closes this FileConfig, releases its associated resources (if any), and ensure that the ongoing saving operations complete.
java.util.Map<java.lang.String,java.lang.String>	commentMap() Returns a Map view of the config's comments.
ConfigFormat<?>	configFormat() Returns the config's format.
boolean	containsComment(java.util.List<java.lang.String> path) Checks if the config contains a comment at some path.
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.
java.lang.String	getComment(java.util.List<java.lang.String> path) Gets a comment from the config.
java.util.Map<java.lang.String,UnmodifiableCommentedConfig.CommentNode>	getComments() Returns a Map containing a deep copy of all the comments in the config.
java.io.File	getFile()
java.nio.file.Path	getNioPath()
<T> T	getRaw(java.util.List<java.lang.String> path) Gets a value from the config.
void	load() (Re)loads this config from the file.
void	putAllComments(java.util.Map<java.lang.String,UnmodifiableCommentedConfig.CommentNode> comments) Puts the comments in the given map to this config.
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.
void	save() Saves this config as soon as possible.
<T> T	set(java.util.List<java.lang.String> path, java.lang.Object value) Sets a config value.
java.lang.String	setComment(java.util.List<java.lang.String> path, java.lang.String comment) Sets a config comment.
java.lang.String	toString()
java.util.Map<java.lang.String,java.lang.Object>	valueMap() Returns a Map view of the config's values.

Methods inherited from class com.electronwill.nightconfig.core.utils.ConfigWrapper

add, clear, remove

Methods inherited from class com.electronwill.nightconfig.core.utils.UnmodifiableConfigWrapper

contains, equals, hashCode, isEmpty, size

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface com.electronwill.nightconfig.core.file.CommentedFileConfig

builder, builder, builder, builder, builder, builder, checked, of, of, of, of, of, of, ofConcurrent, ofConcurrent, ofConcurrent, ofConcurrent, ofConcurrent, ofConcurrent

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

clearComments, commentMap, concurrentCopy, concurrentCopy, concurrentCopy, concurrentCopy, copy, copy, copy, copy, copy, copy, copy, copy, createSubConfig, entrySet, fake, inMemory, inMemoryConcurrent, of, of, ofConcurrent, putAllComments, putAllComments, removeComment, removeComment, setComment, setComment, unmodifiable, wrap

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.file.FileConfig

builder, builder, builder, of, of, of, ofConcurrent, ofConcurrent, ofConcurrent

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

Constructor Detail

ConvertedCommentedFileConfig

public ConvertedCommentedFileConfig(CommentedFileConfig config,
                                    ConversionTable readTable,
                                    ConversionTable writeTable,
                                    java.util.function.Predicate<java.lang.Class<?>> supportPredicate)

ConvertedCommentedFileConfig

public ConvertedCommentedFileConfig(CommentedFileConfig config,
                                    java.util.function.Function<java.lang.Object,java.lang.Object> readConversion,
                                    java.util.function.Function<java.lang.Object,java.lang.Object> writeConversion,
                                    java.util.function.Predicate<java.lang.Class<?>> supportPredicate)

Method Detail

getFile

public java.io.File getFile()

Specified by:

getFile in interface FileConfig

Returns:

the config's file, as a classic File object

getNioPath

public java.nio.file.Path getNioPath()

Specified by:

getNioPath in interface FileConfig

Returns:

the config's file, as a NIO Path object

save

public void save()

Description copied from interface: FileConfig

Saves this config as soon as possible. This method may return quickly and perform the IO operations in background, or it may block until the operations are done.

Specified by:

save in interface FileConfig

load

public void load()

Description copied from interface: FileConfig

(Re)loads this config from the file. This method blocks until the read operation completes.

Specified by:

load in interface FileConfig

close

public void close()

Description copied from interface: FileConfig

Closes this FileConfig, releases its associated resources (if any), and ensure that the ongoing saving operations complete.

A closed FileConfig can still be used via the Config's methods, but FileConfig.save() and FileConfig.load() will throw an IllegalStateException. Closing an aleady closed FileConfig has no effect.

Specified by:

close in interface FileConfig

Specified by:

close in interface java.lang.AutoCloseable

getComment

public java.lang.String getComment(java.util.List<java.lang.String> path)

Description copied from interface: UnmodifiableCommentedConfig

Gets a comment from the config.

Specified by:

getComment in interface UnmodifiableCommentedConfig

Parameters:

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

Returns:

the comment at the given path, or null if there is none.

containsComment

public boolean containsComment(java.util.List<java.lang.String> path)

Description copied from interface: UnmodifiableCommentedConfig

Checks if the config contains a comment at some path.

Specified by:

containsComment in interface UnmodifiableCommentedConfig

Parameters:

path - the path to check, each element of the list is a different part of the path.

Returns:

true if the path is associated with a comment, false if it's not.

setComment

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

Description copied from interface: CommentedConfig

Sets a config comment.

Specified by:

setComment in interface CommentedConfig

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

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

Description copied from interface: CommentedConfig

Removes a comment from the config.

Specified by:

removeComment in interface CommentedConfig

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

public void clearComments()

Description copied from interface: CommentedConfig

Removes all the comments from the config.

Specified by:

clearComments in interface CommentedConfig

getComments

public java.util.Map<java.lang.String,UnmodifiableCommentedConfig.CommentNode> getComments()

Description copied from interface: UnmodifiableCommentedConfig

Returns a Map containing a deep copy of all the comments in the config.

Specified by:

getComments in interface UnmodifiableCommentedConfig

Returns:

a Map containing the comments in the config.

putAllComments

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

Description copied from interface: CommentedConfig

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

Specified by:

putAllComments in interface CommentedConfig

Parameters:

comments - the comments to set

putAllComments

public void putAllComments(UnmodifiableCommentedConfig commentedConfig)

Description copied from interface: CommentedConfig

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

Specified by:

putAllComments in interface CommentedConfig

Parameters:

commentedConfig - the config to copy its comments

commentMap

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

Description copied from interface: CommentedConfig

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 CommentedConfig

Specified by:

commentMap in interface UnmodifiableCommentedConfig

Returns:

a Map view of the config's comments.

entrySet

public 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 CommentedConfig

Specified by:

entrySet in interface Config

Specified by:

entrySet in interface UnmodifiableCommentedConfig

Specified by:

entrySet in interface UnmodifiableConfig

Overrides:

entrySet in class ConfigWrapper<C extends CommentedConfig>

Returns:

a Set view of the config's entries.

createSubConfig

public 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 CommentedConfig

Specified by:

createSubConfig in interface Config

Overrides:

createSubConfig in class ConfigWrapper<C extends CommentedConfig>

Returns:

a new sub config

set

public <T> T set(java.util.List<java.lang.String> path,
                 java.lang.Object value)

Description copied from interface: Config

Sets a config value.

Specified by:

set in interface Config

Overrides:

set in class ConfigWrapper<C extends Config>

Type Parameters:

T - the type of the old value

Parameters:

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

value - the value to set

Returns:

the old value if any, or null

valueMap

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

Description copied from interface: UnmodifiableConfig

Returns a Map view of the config's values. If the config is unmodifiable then the returned map is unmodifiable too.

Specified by:

valueMap in interface Config

Specified by:

valueMap in interface UnmodifiableConfig

Overrides:

valueMap in class UnmodifiableConfigWrapper<C extends Config>

Returns:

a Map view of the config's values.

getRaw

public <T> T getRaw(java.util.List<java.lang.String> path)

Description copied from interface: UnmodifiableConfig

Gets a value from the config. Doesn't convert NullObject.NULL_OBJECT to null.

Specified by:

getRaw in interface UnmodifiableConfig

Overrides:

getRaw in class UnmodifiableConfigWrapper<C extends Config>

Type Parameters:

T - the value's type

Parameters:

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

Returns:

the value at the given path, or null if there is no such value.

configFormat

public ConfigFormat<?> configFormat()

Description copied from interface: UnmodifiableConfig

Returns the config's format.

Specified by:

configFormat in interface UnmodifiableConfig

Overrides:

configFormat in class UnmodifiableConfigWrapper<C extends Config>

Returns:

the config's format

toString

public java.lang.String toString()

Overrides:

toString in class ConfigWrapper<C extends Config>