Deprecated API

Contents

• Deprecated Interfaces
• Deprecated Classes
• Deprecated Exceptions
• Deprecated Annotation Types
• Deprecated Methods
• Deprecated Constructors

Deprecated Interfaces

Interface and Description
com.electronwill.nightconfig.core.conversion.Converter Use the new package com.electronwill.nightconfig.core.serde.

Deprecated Classes

Class and Description
com.electronwill.nightconfig.core.ConcurrentConfigSpec A concurrent HashMap is not enough to make the whole spec robust to multi-threaded use.
com.electronwill.nightconfig.core.conversion.ObjectConverter Use ObjectSerializer or ObjectSerializer instead.

Deprecated Exceptions

Exceptions and Description
com.electronwill.nightconfig.core.conversion.InvalidValueException Use the new package com.electronwill.nightconfig.core.serde with serde.annotations.
com.electronwill.nightconfig.core.conversion.ReflectionException Use the new package com.electronwill.nightconfig.core.serde with serde.annotations.

Deprecated Annotation Types

Annotation Type and Description
com.electronwill.nightconfig.core.conversion.AdvancedPath Use the new package com.electronwill.nightconfig.core.serde with serde.annotations.
com.electronwill.nightconfig.core.conversion.Conversion Use the new package com.electronwill.nightconfig.core.serde with serde.annotations.
com.electronwill.nightconfig.core.conversion.ForceBreakdown Use the new package com.electronwill.nightconfig.core.serde with serde.annotations.
com.electronwill.nightconfig.core.conversion.Path Use the new package com.electronwill.nightconfig.core.serde with serde.annotations.
com.electronwill.nightconfig.core.conversion.PreserveNotNull Use the new package com.electronwill.nightconfig.core.serde with serde.annotations.
com.electronwill.nightconfig.core.conversion.SpecClassInArray Use the new package com.electronwill.nightconfig.core.serde with serde.annotations.
com.electronwill.nightconfig.core.conversion.SpecDoubleInRange Use the new package com.electronwill.nightconfig.core.serde with serde.annotations.
com.electronwill.nightconfig.core.conversion.SpecEnum Use the new package com.electronwill.nightconfig.core.serde with serde.annotations.
com.electronwill.nightconfig.core.conversion.SpecFloatInRange Use the new package com.electronwill.nightconfig.core.serde with serde.annotations.
com.electronwill.nightconfig.core.conversion.SpecIntInRange Use the new package com.electronwill.nightconfig.core.serde with serde.annotations.
com.electronwill.nightconfig.core.conversion.SpecLongInRange Use the new package com.electronwill.nightconfig.core.serde with serde.annotations.
com.electronwill.nightconfig.core.conversion.SpecNotNull Use the new package com.electronwill.nightconfig.core.serde with serde.annotations.
com.electronwill.nightconfig.core.conversion.SpecStringInArray Use the new package com.electronwill.nightconfig.core.serde with serde.annotations.
com.electronwill.nightconfig.core.conversion.SpecStringInRange Use the new package com.electronwill.nightconfig.core.serde with serde.annotations.
com.electronwill.nightconfig.core.conversion.SpecValidator Use the new package com.electronwill.nightconfig.core.serde with serde.annotations.

Deprecated Methods

Method and Description
com.electronwill.nightconfig.core.CommentedConfig.commentMap() commentMap() may not be supported by some config types, in particular ConcurrentConfig, and may be removed in a future version. Prefer to use CommentedConfig.entrySet() instead.
com.electronwill.nightconfig.core.UnmodifiableCommentedConfig.commentMap() commentMap() may not be supported by some config types, in particular ConcurrentConfig, and may be removed in a future version. Prefer to use UnmodifiableCommentedConfig.entrySet() instead.
com.electronwill.nightconfig.core.file.GenericBuilder.concurrent() Since NightConfig v3.7, this method has no effect because all FileConfig are thread-safe, backed by ConcurrentConfig.
com.electronwill.nightconfig.core.CommentedConfig.concurrentCopy(UnmodifiableCommentedConfig) A concurrent HashMap is not enough to make the whole configuration robust to multi-threaded use. Prefer to use a ConcurrentConfig instead.
com.electronwill.nightconfig.core.CommentedConfig.concurrentCopy(UnmodifiableCommentedConfig, ConfigFormat<?>) A concurrent HashMap is not enough to make the whole configuration robust to multi-threaded use. Prefer to use a ConcurrentConfig instead.
com.electronwill.nightconfig.core.CommentedConfig.concurrentCopy(UnmodifiableConfig) A concurrent HashMap is not enough to make the whole configuration robust to multi-threaded use. Prefer to use a ConcurrentConfig instead.
com.electronwill.nightconfig.core.Config.concurrentCopy(UnmodifiableConfig) A concurrent HashMap is not enough to make the whole configuration robust to multi-threaded use. Prefer to use a ConcurrentConfig instead.
com.electronwill.nightconfig.core.CommentedConfig.concurrentCopy(UnmodifiableConfig, ConfigFormat<?>) A concurrent HashMap is not enough to make the whole configuration robust to multi-threaded use. Prefer to use a ConcurrentConfig instead.
com.electronwill.nightconfig.core.Config.concurrentCopy(UnmodifiableConfig, ConfigFormat<?>) A concurrent HashMap is not enough to make the whole configuration robust to multi-threaded use. Prefer to use a ConcurrentConfig instead.
com.electronwill.nightconfig.core.AbstractCommentedConfig.getDefaultCommentMap(boolean)
com.electronwill.nightconfig.core.Config.getDefaultMapCreator(boolean) A concurrent HashMap is not enough to make the whole configuration robust to multi-threaded use. Prefer to use a ConcurrentConfig instead.
com.electronwill.nightconfig.core.AbstractConfig.getDefaultMapCreator(boolean)
com.electronwill.nightconfig.core.Config.getDefaultMapCreator(boolean, boolean) A concurrent HashMap is not enough to make the whole configuration robust to multi-threaded use. Prefer to use a ConcurrentConfig instead.
com.electronwill.nightconfig.core.CommentedConfig.inMemoryConcurrent() A concurrent HashMap is not enough to make the whole configuration robust to multi-threaded use. Prefer to use a ConcurrentConfig instead.
com.electronwill.nightconfig.core.Config.inMemoryConcurrent() A concurrent HashMap is not enough to make the whole configuration robust to multi-threaded use. Prefer to use a ConcurrentConfig instead.
com.electronwill.nightconfig.core.Config.inMemoryUniversalConcurrent() A concurrent HashMap is not enough to make the whole configuration robust to multi-threaded use. Prefer to use a ConcurrentConfig instead.
com.electronwill.nightconfig.core.CommentedConfig.ofConcurrent(ConfigFormat<? extends CommentedConfig>) A concurrent HashMap is not enough to make the whole configuration robust to multi-threaded use. Prefer to use a ConcurrentConfig instead.
com.electronwill.nightconfig.core.Config.ofConcurrent(ConfigFormat<? extends Config>) A concurrent HashMap is not enough to make the whole configuration robust to multi-threaded use. Prefer to use a ConcurrentConfig instead.
com.electronwill.nightconfig.core.file.FileConfig.ofConcurrent(File) All FileConfig are now thread-safe by default, backed by a ConcurrentConfig
com.electronwill.nightconfig.core.file.CommentedFileConfig.ofConcurrent(File) All FileConfig are now thread-safe by default, backed by a ConcurrentConfig
com.electronwill.nightconfig.core.file.FileConfig.ofConcurrent(File, ConfigFormat<?>) All FileConfig are now thread-safe by default, backed by a ConcurrentConfig
com.electronwill.nightconfig.core.file.CommentedFileConfig.ofConcurrent(File, ConfigFormat<? extends CommentedConfig>) All FileConfig are now thread-safe by default, backed by a ConcurrentConfig
com.electronwill.nightconfig.core.file.FileConfig.ofConcurrent(Path) All FileConfig are now thread-safe by default, backed by a ConcurrentConfig
com.electronwill.nightconfig.core.file.CommentedFileConfig.ofConcurrent(Path) All FileConfig are now thread-safe by default, backed by a ConcurrentConfig
com.electronwill.nightconfig.core.file.FileConfig.ofConcurrent(Path, ConfigFormat<?>) All FileConfig are now thread-safe by default, backed by a ConcurrentConfig
com.electronwill.nightconfig.core.file.CommentedFileConfig.ofConcurrent(Path, ConfigFormat<? extends CommentedConfig>) All FileConfig are now thread-safe by default, backed by a ConcurrentConfig
com.electronwill.nightconfig.core.file.FileConfig.ofConcurrent(String) All FileConfig are now thread-safe by default, backed by a ConcurrentConfig
com.electronwill.nightconfig.core.file.CommentedFileConfig.ofConcurrent(String) All FileConfig are now thread-safe by default, backed by a ConcurrentConfig
com.electronwill.nightconfig.core.file.FileConfig.ofConcurrent(String, ConfigFormat<?>) All FileConfig are now thread-safe by default, backed by a ConcurrentConfig
com.electronwill.nightconfig.core.file.CommentedFileConfig.ofConcurrent(String, ConfigFormat<? extends CommentedConfig>) All FileConfig are now thread-safe by default, backed by a ConcurrentConfig
com.electronwill.nightconfig.core.conversion.ObjectConverter.toConfig(Object, Supplier<C>) Use ObjectSerializer.serializeFields(Object, Supplier) instead.
com.electronwill.nightconfig.core.conversion.ObjectConverter.toObject(UnmodifiableConfig, Supplier<O>) Use ObjectDeserializer.deserializeFields(UnmodifiableConfig, Supplier) instead.
com.electronwill.nightconfig.core.UnmodifiableConfig.valueMap() valueMap() may not work exactly as a regular Map for some config types, in particular ConcurrentConfig, and may be removed in a future version. Prefer to use UnmodifiableConfig.entrySet() instead.
com.electronwill.nightconfig.core.Config.valueMap() valueMap() may not work exactly as a regular Map for some config types, in particular ConcurrentConfig, and may be removed in a future version. Prefer to use Config.entrySet() instead.
com.electronwill.nightconfig.core.concurrent.SynchronizedConfig.valueMap() This method is deprecated on SynchronizedConfig. Because a conversion is applied to the value that is added to the map with put, modifying the value after the put will, most of the time, not be reflected to the config, i.e. once something is added to the valueMap(), you loose control over it.

Deprecated Constructors

Constructor and Description
com.electronwill.nightconfig.core.AbstractCommentedConfig(boolean)
com.electronwill.nightconfig.core.AbstractCommentedConfig(UnmodifiableCommentedConfig, boolean)
com.electronwill.nightconfig.core.AbstractCommentedConfig(UnmodifiableConfig, boolean)
com.electronwill.nightconfig.core.AbstractConfig(boolean)
com.electronwill.nightconfig.core.AbstractConfig(UnmodifiableConfig, boolean)
com.electronwill.nightconfig.core.conversion.ObjectConverter() Use ObjectSerializer or ObjectSerializer instead.