dev.dejvokep.boostedyaml.settings.updater

Class UpdaterSettings

java.lang.Object

dev.dejvokep.boostedyaml.settings.updater.UpdaterSettings

public class UpdaterSettings
extends Object

Updater settings cover all options related explicitly (only) to file updating.

Settings introduced by BoostedYAML follow builder design pattern, e.g. you may build your own settings using UpdaterSettings.builder() //configure// .build()

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	UpdaterSettings.Builder Builder for updater settings.

Field Summary

Fields

Modifier and Type	Field and Description
static UpdaterSettings	DEFAULT Default updater settings.
static boolean	DEFAULT_AUTO_SAVE If to, by default, automatically save the file after updating.
static boolean	DEFAULT_ENABLE_DOWNGRADING If to enable file downgrading by default.
static boolean	DEFAULT_KEEP_ALL If to keep all non-merged content (present in the document, but not in the defaults) inside the document by default.
static Map<MergeRule,Boolean>	DEFAULT_MERGE_RULES Default merge preservation rules.
static Versioning	DEFAULT_VERSIONING Default versioning.

Constructor Summary

Constructors

Constructor and Description
UpdaterSettings(UpdaterSettings.Builder builder) Creates final, immutable updater settings from the given builder.

Method Summary

Modifier and Type	Method and Description
static UpdaterSettings.Builder	builder() Returns a new builder.
static UpdaterSettings.Builder	builder(UpdaterSettings settings) Returns a new builder with the same configuration as the given settings.
Set<Route>	getIgnoredRoutes(String versionId, char separator) Returns which blocks (represented by their routes) to ignore (including their contents) while updating to the specified version ID.
Map<MergeRule,Boolean>	getMergeRules() Returns merge preservation rules.
Map<Route,Route>	getRelocations(String versionId, char separator) Returns relocations (in from route = to route format) that took effect at the given version ID.
Versioning	getVersioning() Returns the versioning.
boolean	isAutoSave() Sets if the file should automatically be saved using YamlDocument.save() after the updater has finished updating (does not save if nothing's changed).
boolean	isEnableDowngrading() Returns if to enable downgrading.
boolean	isKeepAll() Returns if to keep all non-merged (that don't have an equivalent in the defaults) blocks in the document.

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT_AUTO_SAVE

public static final boolean DEFAULT_AUTO_SAVE

If to, by default, automatically save the file after updating.

See Also:

Constant Field Values

DEFAULT_ENABLE_DOWNGRADING

public static final boolean DEFAULT_ENABLE_DOWNGRADING

If to enable file downgrading by default.

See Also:

Constant Field Values

DEFAULT_KEEP_ALL

public static final boolean DEFAULT_KEEP_ALL

If to keep all non-merged content (present in the document, but not in the defaults) inside the document by default.

See Also:

Constant Field Values

DEFAULT_MERGE_RULES

public static final Map<MergeRule,Boolean> DEFAULT_MERGE_RULES

Default merge preservation rules.

DEFAULT_VERSIONING

public static final Versioning DEFAULT_VERSIONING

Default versioning.

DEFAULT

public static final UpdaterSettings DEFAULT

Default updater settings.

Constructor Detail

UpdaterSettings

public UpdaterSettings(UpdaterSettings.Builder builder)

Creates final, immutable updater settings from the given builder.

Parameters:

builder - the builder

Method Detail

getMergeRules

public Map<MergeRule,Boolean> getMergeRules()

Returns merge preservation rules.

The given map contains the merge rule as the key, with the value representing if to preserve content already in the document instead of the equivalent from the defaults.

Returns:

the merge rules

getIgnoredRoutes

public Set<Route> getIgnoredRoutes(@NotNull
                                   String versionId,
                                   char separator)

Returns which blocks (represented by their routes) to ignore (including their contents) while updating to the specified version ID.

Parameters:

versionId - version for which to return the routes

separator - separator to split string routes by

Returns:

the set of routes representing blocks to ignore at the version ID

getRelocations

public Map<Route,Route> getRelocations(@NotNull
                                       String versionId,
                                       char separator)

Returns relocations (in from route = to route format) that took effect at the given version ID.

Parameters:

versionId - version for which to return the relocations

separator - separator to split string route relocations by

Returns:

the relocations that took effect at the version ID

getVersioning

public Versioning getVersioning()

Returns the versioning.

Returns:

the versioning

isEnableDowngrading

public boolean isEnableDowngrading()

Returns if to enable downgrading.

Returns:

if to enable downgrading

isKeepAll

public boolean isKeepAll()

Returns if to keep all non-merged (that don't have an equivalent in the defaults) blocks in the document.

Returns:

if to keep all non-merged blocks

isAutoSave

public boolean isAutoSave()

Sets if the file should automatically be saved using YamlDocument.save() after the updater has finished updating (does not save if nothing's changed).

Returns:

if the file should automatically be saved

builder

public static UpdaterSettings.Builder builder()

Returns a new builder.

Returns:

the new builder

builder

public static UpdaterSettings.Builder builder(UpdaterSettings settings)

Returns a new builder with the same configuration as the given settings.

Parameters:

settings - preset settings

Returns:

the new builder