org.rvpf.base.xml

Class JSONSupport

Object

JSONSupport

public final class JSONSupport
extends Object

JSON support.

Method Summary

Modifier and Type	Method and Description
static XMLDocument	load(File file) Loads an XML document from a JSON file.
static XMLDocument	load(URL url, Optional<String> encoding) Loads an XML document from a JSON URL.
static XMLElement	parse(File file) Parses JSON from a file.
static XMLElement	parse(InputStream inputStream) Parses JSON from an input stream.
static XMLElement	parse(Reader reader) Parses JSON from a reader.
static XMLElement	parse(String string) Parses JSON from a file.
static XMLElement	parse(URL url) Parses JSON from an URL.
static String	toJSON(XMLDocument source) Converts an XML document to a JSON string.
static void	toJSON(XMLDocument source, Writer writer) Converts an XML document to JSON writer.

Methods inherited from class Object

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

Method Detail

load

@Nullable
 @CheckReturnValue
public static XMLDocument load(@Nonnull
                                                              File file)

Loads an XML document from a JSON file.

Parameters:

file - The JSON file.

Returns:

The XML document (null on failure).

load

@Nullable
 @CheckReturnValue
public static XMLDocument load(@Nonnull
                                                              URL url,
                                                              @Nonnull
                                                              Optional<String> encoding)

Loads an XML document from a JSON URL.

Parameters:

url - The JSON URL.

encoding - The optional character encoding name.

Returns:

The XML document (null on failure).

parse

@Nonnull
 @CheckReturnValue
public static XMLElement parse(@Nonnull
                                                             File file)
                                                      throws XMLDocument.ParseException

Parses JSON from a file.

Parameters:

file - The JSON file.

Returns:

The root element.

Throws:

XMLDocument.ParseException - When appropriate.

parse

@Nonnull
 @CheckReturnValue
public static XMLElement parse(@Nonnull
                                                             InputStream inputStream)
                                                      throws XMLDocument.ParseException

Parses JSON from an input stream.

Parameters:

inputStream - An input stream for the JSON text.

Returns:

The root element.

Throws:

XMLDocument.ParseException - When appropriate.

parse

@Nonnull
 @CheckReturnValue
public static XMLElement parse(@Nonnull
                                                             Reader reader)
                                                      throws XMLDocument.ParseException

Parses JSON from a reader.

Parameters:

reader - A reader for the JSON text.

Returns:

The root element.

Throws:

XMLDocument.ParseException - When appropriate.

parse

@Nonnull
 @CheckReturnValue
public static XMLElement parse(@Nonnull
                                                             String string)
                                                      throws XMLDocument.ParseException

Parses JSON from a file.

Parameters:

string - The JSON string.

Returns:

The root element.

Throws:

XMLDocument.ParseException - When appropriate.

parse

@Nonnull
 @CheckReturnValue
public static XMLElement parse(@Nonnull
                                                             URL url)
                                                      throws XMLDocument.ParseException

Parses JSON from an URL.

Parameters:

url - The URL of the JSON text.

Returns:

The root element.

Throws:

XMLDocument.ParseException - When appropriate.

toJSON

@Nonnull
 @CheckReturnValue
public static String toJSON(@Nonnull
                                                          XMLDocument source)

Converts an XML document to a JSON string.

Parameters:

source - The XML document.

Returns:

The JSON string.

toJSON

public static void toJSON(@Nonnull
                          XMLDocument source,
                          @Nonnull
                          Writer writer)
                   throws IOException

Converts an XML document to JSON writer.

Parameters:

source - The XML document.

writer - The JSON writer.

Throws:

IOException - From the destination.