Upgrading com.typesafe:config 0.6 to 1
Breaking0.6.0 → 1.4.9Breaking5Platform1New40Changed28Fixed53Other30
BreakingUpgrade verdict
5 breaking changes and a platform requirement change.
In plain terms
- Drop the broken Maven chip in Readme.
- Remove unnecessary array.
- Remove unmodifiable collection wrappers in ResolveContext.
- Renamed some methods in the new ConfigDocument for consistency with Config (breaks ABI vs. 1.3.0-M2, but not vs. any stable release).
Must act Top 4 of 6 that need code or config changes
What you must change
Breaking5
Drop the broken Maven chip in Readme.
Remove unnecessary array.
Remove unmodifiable collection wrappers in ResolveContext.
Renamed some methods in the new ConfigDocument for consistency with Config (breaks ABI vs. 1.3.0-M2, but not vs. any stable release).
Remove junk in POM caused by broken local configuration.
Platform1
now built with Java 8 and requires Java 8.
API changes
Generated by DepDelta from published JVM bytecode. Not mixed with prose notes.
- changed:
static class ConfigException.ValidationProblem → static class ConfigException.ValidationProblem implements Serializable - added:
@interface Optional - added:
class ConfigBeanFactory - added:
class DefaultConfigLoadingStrategy implements ConfigLoadingStrategy - added:
ctor ConfigBeanFactory() - added:
ctor ConfigException.BadBean(String) - added:
ctor ConfigException.BadBean(String, Throwable) - added:
ctor DefaultConfigLoadingStrategy() - added:
final class ConfigMemorySize - added:
final class ConfigOriginFactory - added:
interface ConfigLoadingStrategy - added:
interface ConfigResolver - added:
method Config.getDuration(String): Duration - added:
method Config.getDuration(String, TimeUnit): long - added:
method Config.getDurationList(String): List - added:
method Config.getDurationList(String, TimeUnit): List - added:
method Config.getEnum(Class, String): Enum - added:
method Config.getEnumList(Class, String): List - added:
method Config.getIsNull(String): boolean - added:
method Config.getMemorySize(String): ConfigMemorySize - added:
method Config.getMemorySizeList(String): List - added:
method Config.getPeriod(String): Period - added:
method Config.getTemporal(String): TemporalAmount - added:
method Config.hasPathOrNull(String): boolean - added:
method Config.isResolved(): boolean - added:
method Config.resolveWith(Config): Config - added:
method Config.resolveWith(Config, ConfigResolveOptions): Config - added:
method ConfigException.UnresolvedSubstitution.addExtraDetail(String): ConfigException.UnresolvedSubstitution - added:
method ConfigException.ValidationProblem.toString(): String - added:
method ConfigIncludeContext.setParseOptions(ConfigParseOptions): ConfigIncludeContext - added:
method ConfigList.withOrigin(ConfigOrigin): ConfigList - added:
method ConfigLoadingStrategy.parseApplicationConfig(ConfigParseOptions): Config - added:
method ConfigMemorySize.equals(Object): boolean - added:
method ConfigMemorySize.hashCode(): int - added:
method ConfigMemorySize.toBytes(): long - added:
method ConfigMemorySize.toBytesBigInteger(): BigInteger - added:
method ConfigMemorySize.toString(): String - added:
method ConfigObject.withOrigin(ConfigOrigin): ConfigObject - added:
method ConfigOrigin.withComments(List): ConfigOrigin - added:
method ConfigOrigin.withLineNumber(int): ConfigOrigin - added:
method ConfigParseOptions.setSyntaxFromFilename(String): ConfigParseOptions - added:
method ConfigRenderOptions.getShowEnvVariableValues(): boolean - added:
method ConfigRenderOptions.setShowEnvVariableValues(boolean): ConfigRenderOptions - added:
method ConfigResolveOptions.appendResolver(ConfigResolver): ConfigResolveOptions - added:
method ConfigResolveOptions.getAllowUnresolved(): boolean - added:
method ConfigResolveOptions.getResolver(): ConfigResolver - added:
method ConfigResolveOptions.setAllowUnresolved(boolean): ConfigResolveOptions - added:
method ConfigResolver.lookup(String): ConfigValue - added:
method ConfigResolver.withFallback(ConfigResolver): ConfigResolver - added:
method ConfigValue.withOrigin(ConfigOrigin): ConfigValue - added:
method DefaultConfigLoadingStrategy.parseApplicationConfig(ConfigParseOptions): Config - added:
static class ConfigException.BadBean extends ConfigException.BugOrBroken - added:
static method ConfigBeanFactory.create(Config, Class): Object - added:
static method ConfigBeanFactory.create(Config, Class, boolean): Object - added:
static method ConfigFactory.defaultApplication(): Config - added:
static method ConfigFactory.defaultApplication(ClassLoader): Config - added:
static method ConfigFactory.defaultApplication(ConfigParseOptions): Config - added:
static method ConfigFactory.defaultReferenceUnresolved(): Config - added:
static method ConfigFactory.defaultReferenceUnresolved(ClassLoader): Config - added:
static method ConfigFactory.load(ConfigParseOptions, ConfigResolveOptions): Config - added:
static method ConfigFactory.parseApplicationReplacement(): Optional - added:
static method ConfigFactory.parseApplicationReplacement(ClassLoader): Optional - added:
static method ConfigFactory.parseApplicationReplacement(ConfigParseOptions): Optional - added:
static method ConfigFactory.systemEnvironmentOverrides(): Config - added:
static method ConfigMemorySize.ofBytes(BigInteger): ConfigMemorySize - added:
static method ConfigMemorySize.ofBytes(long): ConfigMemorySize - added:
static method ConfigOriginFactory.newFile(String): ConfigOrigin - added:
static method ConfigOriginFactory.newSimple(): ConfigOrigin - added:
static method ConfigOriginFactory.newSimple(String): ConfigOrigin - added:
static method ConfigOriginFactory.newURL(URL): ConfigOrigin
- removed:
method Parseable.rawParseValue(Reader, ConfigOrigin, ConfigParseOptions): AbstractConfigValue - added:
class ConfigBeanImpl - added:
ctor ConfigBeanImpl() - added:
interface Parseable.Relativizer - added:
method Parseable.Relativizer.relativeTo(String): ConfigParseable - added:
method Parseable.parseConfigDocument(): ConfigDocument - added:
method Parseable.rawParseDocument(ConfigOrigin, ConfigParseOptions): ConfigDocument - added:
method Parseable.reader(ConfigParseOptions): Reader - added:
static method ConfigBeanImpl.createInternal(Config, Class, boolean): Object - added:
static method ConfigImpl.defaultReferenceUnresolved(ClassLoader): Config - added:
static method ConfigImpl.envVariablesOverridesAsConfig(): Config - added:
static method ConfigImpl.newEnvVariable(String): ConfigOrigin - added:
static method ConfigImpl.newFileOrigin(String): ConfigOrigin - added:
static method ConfigImpl.newSimpleOrigin(String): ConfigOrigin - added:
static method ConfigImpl.newURLOrigin(URL): ConfigOrigin - added:
static method ConfigImpl.reloadEnvVariablesConfig(): void - added:
static method ConfigImpl.reloadEnvVariablesOverridesConfig(): void - added:
static method ConfigImpl.trace(int, String): void - added:
static method ConfigImpl.traceSubstitutionsEnabled(): boolean - added:
static method ConfigImplUtil.syntaxFromExtension(String): ConfigSyntax
- added:
ctor ConfigDocumentFactory() - added:
final class ConfigDocumentFactory - added:
interface ConfigDocument - added:
interface ConfigNode - added:
method ConfigDocument.hasPath(String): boolean - added:
method ConfigDocument.render(): String - added:
method ConfigDocument.withValue(String, ConfigValue): ConfigDocument - added:
method ConfigDocument.withValueText(String, String): ConfigDocument - added:
method ConfigDocument.withoutPath(String): ConfigDocument - added:
method ConfigNode.render(): String - added:
static method ConfigDocumentFactory.parseFile(File): ConfigDocument - added:
static method ConfigDocumentFactory.parseFile(File, ConfigParseOptions): ConfigDocument - added:
static method ConfigDocumentFactory.parseReader(Reader): ConfigDocument - added:
static method ConfigDocumentFactory.parseReader(Reader, ConfigParseOptions): ConfigDocument - added:
static method ConfigDocumentFactory.parseString(String): ConfigDocument - added:
static method ConfigDocumentFactory.parseString(String, ConfigParseOptions): ConfigDocument