Package com.github.siroshun09.configapi.format.gson

Class GsonFormat

java.lang.Object

com.github.siroshun09.configapi.format.gson.GsonFormat

All Implemented Interfaces:

FileFormat<MapNode>

public final class GsonFormat
extends Object
implements FileFormat<MapNode>

A FileFormat implementation that loading/saving MapNode from/to json files using Gson.

Supported Nodes:

• ValueNodes
  • CharValue and CharArray is written as String
  • EnumValue will be written as String using Enum.name()
  • Loading CharValue, CharArray, and EnumValue is not supported
• MapNode and ListNode
• ArrayNodes: serialize only
• NullNode
• CommentedNode - The comment will be dropped

Field Summary

Fields

Modifier and Type	Field	Description
static final GsonFormat	DEFAULT	An instance of GsonFormat that created from a plain GsonBuilder.
static final GsonFormat	PRETTY_PRINTING	An instance of GsonFormat that created from a GsonBuilder that set pretty printing.

Constructor Summary

Constructors

Constructor	Description
GsonFormat(@NotNull com.google.gson.GsonBuilder gsonBuilder)	Creates a new GsonFormat from the GsonBuilder.

Method Summary

Modifier and Type	Method	Description
@NotNull MapNode	load(@NotNull Reader reader)	Loads a node from a Reader.
void	save(@NotNull MapNode node, @NotNull Writer writer)	Saves a node to a Writer.

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.github.siroshun09.configapi.core.file.FileFormat

load, load, save, save

Field Details

DEFAULT

public static final GsonFormat DEFAULT

An instance of GsonFormat that created from a plain GsonBuilder.

PRETTY_PRINTING

public static final GsonFormat PRETTY_PRINTING

An instance of GsonFormat that created from a GsonBuilder that set pretty printing.

Constructor Details

GsonFormat

public GsonFormat(@NotNull
 @NotNull com.google.gson.GsonBuilder gsonBuilder)

Creates a new GsonFormat from the GsonBuilder.

Parameters:

gsonBuilder - the GsonBuilder

Method Details

load

@NotNull
public @NotNull MapNode load(@NotNull
 @NotNull Reader reader)
                      throws IOException

Description copied from interface: FileFormat

Loads a node from a Reader.

Specified by:

load in interface FileFormat<MapNode>

Parameters:

reader - a Reader to load a node

Returns:

a loaded Node (FileFormat)

Throws:

IOException - if I/O error occurred

save

public void save(@NotNull
 @NotNull MapNode node,
 @NotNull
 @NotNull Writer writer)
          throws IOException

Description copied from interface: FileFormat

Saves a node to a Writer.

Specified by:

save in interface FileFormat<MapNode>

Parameters:

node - a root Node (FileFormat) to save

writer - a Writer to write a node

Throws:

IOException - if I/O error occurred