Package org.apache.juneau.marshall.jena.marshaller

Class NQuads

java.lang.Object

org.apache.juneau.marshall.marshaller.Marshaller

org.apache.juneau.marshall.marshaller.CharMarshaller

org.apache.juneau.marshall.jena.marshaller.NQuads

public class NQuads
extends CharMarshaller

A pairing of a NQuadsSerializer and NQuadsParser into a single class with convenience to/of methods.

Examples:

// Serialize a bean or map to N-Quads String nquads = NQuads.of(myBean); // Parse N-Quads into a bean or map MyPojo parsed = NQuads.to(nquads, MyPojo.class);

// Using instance methods NQuads m = NQuads.DEFAULT; nquads = m.write(myBean); parsed = m.read(nquads, MyPojo.class);

Example output (bean with name/age, N-Triples with graph):

<...> <.../name> "Alice" <...> . <...> <.../age> "30"^^<http://www.w3.org/2001/XMLSchema#int> <...> .

Complex (nested address + array):

<...> <.../name> "Alice" <graph> . <...> <.../address> <.../address> <graph> . <.../address> <.../street> "123 Main St" <graph> . <.../address> <.../city> "Boston" <graph> . <.../address> <.../state> "MA" <graph> .

// Using static shortcuts. MyPojo myPojo = NQuads.to(string, MyPojo.class); String string = NQuads.of(myPojo);

See Also:

• {doc jmr.RdfDetails}
• {doc jm.Marshallers}

Field Summary

Fields

Modifier and Type	Field	Description
static final NQuads	DEFAULT	Default reusable instance.

Constructor Summary

Constructors

Constructor	Description
NQuads()	Constructor using defaults.
NQuads(NQuadsSerializer s, NQuadsParser p)	Constructor with serializer and parser.

Method Summary

Modifier and Type	Method	Description
static String	of(Object object)	Serializes a POJO to a String using the DEFAULT marshaller.
static <T> T	to(String input, Class<T> type)	Parses an input into the specified object type using the DEFAULT marshaller.
static <T> T	to(String input, Type type, Type... args)	Parses an input into the specified parameterized object type using the DEFAULT marshaller.

Methods inherited from class org.apache.juneau.marshall.marshaller.CharMarshaller

read, read, write

Methods inherited from class org.apache.juneau.marshall.marshaller.Marshaller

getParser, getSerializer, read, read, readArrayRecords, readRecords, readTokens, write, writeArrayRecords, writeRecords, writeTokens

Methods inherited from class java.lang.Object

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

Field Details

DEFAULT

public static final NQuads DEFAULT

Default reusable instance.

Constructor Details

NQuads

public NQuads()

Constructor using defaults.

NQuads

public NQuads(NQuadsSerializer s,
 NQuadsParser p)

Constructor with serializer and parser.

Parameters:

s - The serializer to use.
Must not be null.

p - The parser to use.
Must not be null.

Method Details

of

public static String of(Object object)
                 throws SerializeException

Serializes a POJO to a String using the DEFAULT marshaller.

A shortcut for calling DEFAULT.write(object).

Parameters:

object - The object to serialize.

Returns:

The serialized object.

Throws:

SerializeException - If a problem occurred trying to convert the output.

to

public static <T> T to(String input,
 Class<T> type)
                throws ParseException

Parses an input into the specified object type using the DEFAULT marshaller.

A shortcut for calling DEFAULT.read(input, type).

Type Parameters:

T - The class type of the object being created.

Parameters:

input - The input.

type - The object type to create.

Returns:

The parsed object.

Throws:

ParseException - Malformed input encountered.

to

public static <T> T to(String input,
 Type type,
 Type... args)
                throws ParseException

Parses an input into the specified parameterized object type using the DEFAULT marshaller.

A shortcut for calling DEFAULT.read(input, type, args).

Type Parameters:

T - The class type of the object to create.

Parameters:

input - The input.

type - The object type to create.

args - The type arguments of the class if it's a collection or map.

Returns:

The parsed object.

Throws:

ParseException - Malformed input encountered.