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

Class JsonLd

java.lang.Object

org.apache.juneau.marshall.marshaller.Marshaller

org.apache.juneau.marshall.marshaller.CharMarshaller

org.apache.juneau.marshall.jena.marshaller.JsonLd

public class JsonLd
extends CharMarshaller

A pairing of a JsonLdSerializer and JsonLdParser into a single class with convenience to/of methods.

The general idea is to combine a single serializer and parser inside a simplified API for serializing and parsing POJOs.

Examples:

// Using instance. JsonLd jsonLd = new JsonLd(); MyPojo myPojo = jsonLd.read(string, MyPojo.class); String string = jsonLd.write(myPojo);

// Using DEFAULT instance. MyPojo myPojo = JsonLd.DEFAULT.read(string, MyPojo.class); String string = JsonLd.DEFAULT.write(myPojo);

Example output (bean with name/age, JSON-LD format):

{ "@context": {...}, "@id": "...", "@type": "Person", "name": "Alice", "age": 30 }

Complex (nested address + array):

{ "@context": {...}, "@id": "...", "@type": "Person", "name": "Alice", "age": 30, "address": { "@id": ".../address", "street": "123 Main St", "city": "Boston", "state": "MA" }, "tags": ["a","b","c"] }

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

See Also:

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

Field Summary

Fields

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

Constructor Summary

Constructors

Constructor	Description
JsonLd()	Constructor.
JsonLd(JsonLdSerializer s, JsonLdParser p)	Constructor.

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 JsonLd DEFAULT

Default reusable instance.

Constructor Details

JsonLd

public JsonLd()

Constructor.

Uses JsonLdSerializer.DEFAULT and JsonLdParser.DEFAULT.

JsonLd

public JsonLd(JsonLdSerializer s,
 JsonLdParser p)

Constructor.

Parameters:

s - The serializer to use for serializing output.
Must not be null.

p - The parser to use for parsing input.
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.