blue.endless.jankson

Class Jankson

java.lang.Object

blue.endless.jankson.Jankson

public class Jankson
extends java.lang.Object

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Jankson.Builder

Method Summary

Modifier and Type	Method and Description
static Jankson.Builder	builder()
<T> T	fromJson(JsonObject obj, java.lang.Class<T> clazz)
<T> T	fromJson(java.lang.String json, java.lang.Class<T> clazz)
<T> T	fromJsonCarefully(JsonObject obj, java.lang.Class<T> clazz) Converts a JsonObject into an object of the specified class, in fail-fast mode, throwing an exception proactively if problems arise
<T> T	fromJsonCarefully(java.lang.String json, java.lang.Class<T> clazz) Converts a String of json into an object of the specified class in fail-fast mode, throwing an exception proactively if problems arise.
int	getCodePoint(java.io.InputStream in)
Marshaller	getMarshaller()
JsonObject	load(java.io.File f)
JsonObject	load(java.io.InputStream in)
JsonObject	load(java.lang.String s)
JsonElement	loadElement(java.io.File f) Experimental: Parses the supplied File as a JsonElement, which may or may not be an object at the root level
JsonElement	loadElement(java.io.InputStream in) Experimental: Parses the supplied InputStream as a JsonElement, which may or may not be an object at the root level
JsonElement	loadElement(java.lang.String s) Experimental: Parses the supplied String as a JsonElement, which may or may not be an object at the root level
<T> void	push(ParserContext<T> t, java.util.function.Consumer<T> consumer) Pushes a context onto the stack.
void	throwDelayed(SyntaxError syntaxError)
<T> JsonElement	toJson(T t)
<T> JsonElement	toJson(T t, Marshaller alternateMarshaller)

Methods inherited from class java.lang.Object

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

Method Detail

load

@Nonnull
public JsonObject load(java.lang.String s)
                         throws SyntaxError

Throws:

SyntaxError

load

@Nonnull
public JsonObject load(java.io.File f)
                         throws java.io.IOException,
                                SyntaxError

Throws:

java.io.IOException

SyntaxError

getCodePoint

public int getCodePoint(java.io.InputStream in)
                 throws java.io.IOException

Throws:

java.io.IOException

load

@Nonnull
public JsonObject load(java.io.InputStream in)
                         throws java.io.IOException,
                                SyntaxError

Throws:

java.io.IOException

SyntaxError

loadElement

@Nonnull
public JsonElement loadElement(java.lang.String s)
                                 throws SyntaxError

Experimental: Parses the supplied String as a JsonElement, which may or may not be an object at the root level

Throws:

SyntaxError

loadElement

@Nonnull
public JsonElement loadElement(java.io.File f)
                                 throws java.io.IOException,
                                        SyntaxError

Experimental: Parses the supplied File as a JsonElement, which may or may not be an object at the root level

Throws:

java.io.IOException

SyntaxError

loadElement

@Nonnull
public JsonElement loadElement(java.io.InputStream in)
                                 throws java.io.IOException,
                                        SyntaxError

Experimental: Parses the supplied InputStream as a JsonElement, which may or may not be an object at the root level

Throws:

java.io.IOException

SyntaxError

fromJson

public <T> T fromJson(JsonObject obj,
                      java.lang.Class<T> clazz)

fromJson

public <T> T fromJson(java.lang.String json,
                      java.lang.Class<T> clazz)
               throws SyntaxError

Throws:

SyntaxError

fromJsonCarefully

public <T> T fromJsonCarefully(java.lang.String json,
                               java.lang.Class<T> clazz)
                        throws SyntaxError,
                               DeserializationException

Converts a String of json into an object of the specified class in fail-fast mode, throwing an exception proactively if problems arise.

Parameters:

json - A string containing json data to be unpacked

clazz - The class to convert the data into

Returns:

An object representing the data in json

Throws:

SyntaxError - If the json cannot be parsed

DeserializationException - If the conversion into an instance of the specified type fails

fromJsonCarefully

public <T> T fromJsonCarefully(JsonObject obj,
                               java.lang.Class<T> clazz)
                        throws DeserializationException

Converts a JsonObject into an object of the specified class, in fail-fast mode, throwing an exception proactively if problems arise

Parameters:

obj - A JsonObject holding the data to be unpacked

clazz - The class to convert the data into

Returns:

An object of the specified class, holding the data from json

Throws:

DeserializationException - If the conversion into an instance of the specified type fails

toJson

public <T> JsonElement toJson(T t)

toJson

public <T> JsonElement toJson(T t,
                              Marshaller alternateMarshaller)

push

public <T> void push(ParserContext<T> t,
                     java.util.function.Consumer<T> consumer)

Pushes a context onto the stack. MAY ONLY BE CALLED BY THE ACTIVE CONTEXT

getMarshaller

public Marshaller getMarshaller()

builder

public static Jankson.Builder builder()

throwDelayed

public void throwDelayed(SyntaxError syntaxError)