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

Class Turtle

java.lang.Object

org.apache.juneau.marshall.marshaller.Marshaller

org.apache.juneau.marshall.marshaller.CharMarshaller

org.apache.juneau.marshall.jena.marshaller.Turtle

public class Turtle
extends CharMarshaller

A pairing of a TurtleSerializer and TurtleParser 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. Turtle turtle = new Turtle(); MyPojo myPojo = turtle.read(string, MyPojo.class); String string = turtle.write(myPojo);

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

Example output (bean with name/age):

Field Summary

Fields

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

Constructor Summary

Constructors

Constructor	Description
Turtle()	Constructor.
Turtle(TurtleSerializer s, TurtleParser 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 Turtle DEFAULT

Default reusable instance.

Constructor Details

Turtle

public Turtle()

Constructor.

Uses TurtleSerializer.DEFAULT and TurtleParser.DEFAULT.

Turtle

public Turtle(TurtleSerializer s,
 TurtleParser 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.