Package org.spongepowered.configurate.hocon

Class HoconConfigurationLoader

java.lang.Object

org.spongepowered.configurate.loader.AbstractConfigurationLoader<CommentedConfigurationNode>

org.spongepowered.configurate.hocon.HoconConfigurationLoader

All Implemented Interfaces:

ConfigurationNodeFactory<CommentedConfigurationNode>, ConfigurationLoader<CommentedConfigurationNode>

public final class HoconConfigurationLoader
extends AbstractConfigurationLoader<CommentedConfigurationNode>

A loader for HOCON (Hodor)-formatted configurations, using the lightbend config library for parsing and generation.

Since:

4.0.0

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final class	HoconConfigurationLoader.Builder	Builds a HoconConfigurationLoader.

Field Summary

Fields inherited from class org.spongepowered.configurate.loader.AbstractConfigurationLoader

CONFIGURATE_LINE_PATTERN, CONFIGURATE_LINE_SEPARATOR, sink, source, SYSTEM_LINE_SEPARATOR

Method Summary

Modifier and Type	Method	Description
static HoconConfigurationLoader.Builder	builder()	Creates a new HoconConfigurationLoader builder.
protected void	checkCanWrite(ConfigurationNode node)	Perform format-specific validation of a node.
CommentedConfigurationNode	createNode(ConfigurationOptions options)	Create an empty node with the provided options.
protected void	loadInternal(CommentedConfigurationNode node, BufferedReader reader)	Using a created node, attempt to read a configuration file.
protected void	saveInternal(ConfigurationNode node, Writer writer)	Perform a save of the node to the provided writer.

Methods inherited from class org.spongepowered.configurate.loader.AbstractConfigurationLoader

canLoad, canSave, defaultCommentHandler, defaultOptions, load, loadToReference, save, writeHeaderInternal

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.spongepowered.configurate.loader.ConfigurationLoader

load

Methods inherited from interface org.spongepowered.configurate.ConfigurationNodeFactory

createNode, createNode, createNode, toListCollector, toListCollector, toMapCollector, toMapCollector

Method Details

builder

public static HoconConfigurationLoader.Builder builder()

Creates a new HoconConfigurationLoader builder.

Returns:

a new builder

Since:

4.0.0

checkCanWrite

protected void checkCanWrite(ConfigurationNode node)
                      throws ConfigurateException

Description copied from class: AbstractConfigurationLoader

Perform format-specific validation of a node.

This method will be called before a writer is opened, allowing the loader to perform any basic validation it may need to before it opens a writer replacing an existing file.

Overrides:

checkCanWrite in class AbstractConfigurationLoader<CommentedConfigurationNode>

Parameters:

node - the node to write

Throws:

ConfigurateException - if any invalid data is present

loadInternal

protected void loadInternal(CommentedConfigurationNode node,
 BufferedReader reader)
                     throws ParsingException

Description copied from class: AbstractConfigurationLoader

Using a created node, attempt to read a configuration file.

The header will already have been read if applicable.

Specified by:

loadInternal in class AbstractConfigurationLoader<CommentedConfigurationNode>

Parameters:

node - node to load into

reader - reader to load from

Throws:

ParsingException - if an error occurs at any stage of loading

saveInternal

protected void saveInternal(ConfigurationNode node,
 Writer writer)
                     throws ConfigurateException

Description copied from class: AbstractConfigurationLoader

Perform a save of the node to the provided writer.

Specified by:

saveInternal in class AbstractConfigurationLoader<CommentedConfigurationNode>

Parameters:

node - node to save

writer - writer to output to

Throws:

ConfigurateException - if any of the node's data is unsavable

createNode

public CommentedConfigurationNode createNode(ConfigurationOptions options)

Description copied from interface: ConfigurationNodeFactory

Create an empty node with the provided options.

Node options may be overridden if the factory enforces specific requirements on options.

Parameters:

options - node options

Returns:

newly created empty node