Package org.apache.juneau.marshall.jena

Class RdfParser

java.lang.Object

org.apache.juneau.marshall.Context

org.apache.juneau.marshall.MarshallingContextable

org.apache.juneau.marshall.parser.Parser

org.apache.juneau.marshall.parser.ReaderParser

org.apache.juneau.marshall.jena.RdfParser

All Implemented Interfaces:

RdfMetaProvider, XmlMetaProvider

Direct Known Subclasses:

JsonLdParser, N3Parser, NQuadsParser, NTripleParser, RdfJsonParser, RdfXmlParser, TriGParser, TriXParser, TurtleParser

public class RdfParser
extends ReaderParser
implements RdfMetaProvider

Parses RDF into POJOs.

Behavior-specific subclasses

The following direct subclasses are provided for language-specific parsers:

• RdfXmlParser - RDF/XML and RDF/XML-ABBREV.
• NTripleParser - N-TRIPLE.
• TurtleParser - TURTLE.
• N3Parser - N3.

Notes:

• This class is thread safe and reusable.

See Also:

• {doc jmr.RdfDetails}

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	RdfParser.Builder<SELF extends RdfParser.Builder<SELF>>	Builder class.
static final class	RdfParser.DefaultBuilder	Concrete default builder leaf for the non-subclassed create() / copy() path.

Nested classes/interfaces inherited from class org.apache.juneau.marshall.parser.Parser

Parser.Null

Field Summary

Fields

Modifier and Type	Field	Description
protected final RdfCollectionFormat	collectionFormat
protected final Namespace	juneauBpNs
protected final Namespace	juneauNs
protected final String	language
protected final boolean	looseCollections
protected final boolean	trimWhitespace

Fields inherited from class org.apache.juneau.marshall.parser.Parser

autoCloseStreams, consumes, debugOutputLines, listener, nulls, trimStrings, unbuffered

Fields inherited from class org.apache.juneau.marshall.MarshallingContextable

marshallingContext

Fields inherited from class org.apache.juneau.marshall.Context

CONTEXT_APPLY_FILTER

Constructor Summary

Constructors

Constructor	Description
RdfParser(RdfParser.Builder<?> builder)	Constructor.

Method Summary

Modifier and Type	Method	Description
RdfParser.Builder<?>	copy()	Creates a builder from this context object.
static RdfParser.Builder<?>	create()	Creates a new builder for this object.
RdfParserSession.Builder	createSession()	Create a session builder based on the properties defined on this context.
protected final RdfCollectionFormat	getCollectionFormat()	RDF format for representing collections and arrays.
protected final Map<String,Object>	getJenaSettings()	All Jena-related configuration properties.
protected final Namespace	getJuneauBpNs()	Default XML namespace for bean properties.
protected final Namespace	getJuneauNs()	XML namespace for Juneau properties.
protected final String	getLanguage()	RDF language.
RdfBeanMeta	getRdfBeanMeta(BeanMeta<?> bm)	Returns the language-specific metadata on the specified bean.
RdfBeanPropertyMeta	getRdfBeanPropertyMeta(BeanPropertyMeta bpm)	Returns the language-specific metadata on the specified bean property.
RdfClassMeta	getRdfClassMeta(ClassMeta<?> cm)	Returns the language-specific metadata on the specified class.
RdfParserSession	getSession()	Returns a session to use for this context.
XmlBeanMeta	getXmlBeanMeta(BeanMeta<?> bm)	Returns the language-specific metadata on the specified bean.
XmlBeanPropertyMeta	getXmlBeanPropertyMeta(BeanPropertyMeta bpm)	Returns the language-specific metadata on the specified bean property.
XmlClassMeta	getXmlClassMeta(ClassMeta<?> cm)	Returns the language-specific metadata on the specified class.
protected final boolean	isLooseCollections()	Collections should be serialized and parsed as loose collections.
protected final boolean	isTrimWhitespace()	Trim whitespace from text elements.
protected FluentMap<String,Object>	properties()	Returns the properties on this bean as a map for debugging.

Methods inherited from class org.apache.juneau.marshall.parser.ReaderParser

getStreamCharset, isReaderParser

Methods inherited from class org.apache.juneau.marshall.parser.Parser

canHandle, createParserBuilder, doRead, getDebugOutputLines, getListener, getMediaTypes, getNulls, getPrimaryMediaType, isAutoCloseStreams, isTrimStrings, isUnbuffered, read, read, read, read, read, read, readArgs, readIntoCollection, readIntoMap, readWithOuter

Methods inherited from class org.apache.juneau.marshall.MarshallingContextable

getDurationFormat, getMarshallingContext, getPeriodFormat

Methods inherited from class org.apache.juneau.marshall.Context

createBuilder, getAnnotationProvider, init, isDebug, toString

Methods inherited from class java.lang.Object

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

Field Details

looseCollections

protected final boolean looseCollections

trimWhitespace

protected final boolean trimWhitespace

juneauBpNs

protected final Namespace juneauBpNs

juneauNs

protected final Namespace juneauNs

collectionFormat

protected final RdfCollectionFormat collectionFormat

language

protected final String language

Constructor Details

RdfParser

public RdfParser(RdfParser.Builder<?> builder)

Constructor.

Parameters:

builder - The builder for this object.
Cannot be null.

Method Details

create

public static RdfParser.Builder<?> create()

Creates a new builder for this object.

Returns:

A new builder.

copy

public RdfParser.Builder<?> copy()

Description copied from class: Context

Creates a builder from this context object.

Builders are used to define new contexts (e.g. serializers, parsers) based on existing configurations.

Overrides:

copy in class Parser

Returns:

A new Builder object.

createSession

public RdfParserSession.Builder createSession()

Description copied from class: Context

Create a session builder based on the properties defined on this context.

Use this method for creating sessions where you want to override basic settings. Otherwise, use Context.getSession() directly.

Overrides:

createSession in class ReaderParser

Returns:

A new session builder.

getRdfBeanMeta

public RdfBeanMeta getRdfBeanMeta(BeanMeta<?> bm)

Description copied from interface: RdfMetaProvider

Returns the language-specific metadata on the specified bean.

Specified by:

getRdfBeanMeta in interface RdfMetaProvider

Parameters:

bm - The bean to return the metadata on.

Returns:

The metadata.

getRdfBeanPropertyMeta

public RdfBeanPropertyMeta getRdfBeanPropertyMeta(BeanPropertyMeta bpm)

Description copied from interface: RdfMetaProvider

Returns the language-specific metadata on the specified bean property.

Specified by:

getRdfBeanPropertyMeta in interface RdfMetaProvider

Parameters:

bpm - The bean property to return the metadata on.

Returns:

The metadata.

getRdfClassMeta

public RdfClassMeta getRdfClassMeta(ClassMeta<?> cm)

Description copied from interface: RdfMetaProvider

Returns the language-specific metadata on the specified class.

Specified by:

getRdfClassMeta in interface RdfMetaProvider

Parameters:

cm - The class to return the metadata on.

Returns:

The metadata.

getSession

public RdfParserSession getSession()

Description copied from class: Context

Returns a session to use for this context.

Note that subclasses may opt to return a reusable non-modifiable session.

Overrides:

getSession in class ReaderParser

Returns:

A new session object.

getXmlBeanMeta

public XmlBeanMeta getXmlBeanMeta(BeanMeta<?> bm)

Description copied from interface: XmlMetaProvider

Returns the language-specific metadata on the specified bean.

Specified by:

getXmlBeanMeta in interface XmlMetaProvider

Parameters:

bm - The bean to return the metadata on.

Returns:

The metadata.

getXmlBeanPropertyMeta

public XmlBeanPropertyMeta getXmlBeanPropertyMeta(BeanPropertyMeta bpm)

Description copied from interface: XmlMetaProvider

Returns the language-specific metadata on the specified bean property.

Specified by:

getXmlBeanPropertyMeta in interface XmlMetaProvider

Parameters:

bpm - The bean property to return the metadata on.

Returns:

The metadata.

getXmlClassMeta

public XmlClassMeta getXmlClassMeta(ClassMeta<?> cm)

Description copied from interface: XmlMetaProvider

Returns the language-specific metadata on the specified class.

Specified by:

getXmlClassMeta in interface XmlMetaProvider

Parameters:

cm - The class to return the metadata on.

Returns:

The metadata.

getCollectionFormat

protected final RdfCollectionFormat getCollectionFormat()

RDF format for representing collections and arrays.

Returns:

RDF format for representing collections and arrays.

See Also:

• RdfParser.Builder.collectionFormat(RdfCollectionFormat)

getJenaSettings

protected final Map<String,Object> getJenaSettings()

All Jena-related configuration properties.

Returns:

A map of all Jena-related configuration properties.

getJuneauBpNs

protected final Namespace getJuneauBpNs()

Default XML namespace for bean properties.

Returns:

Default XML namespace for bean properties.

See Also:

• RdfParser.Builder.juneauBpNs(Namespace)

getJuneauNs

protected final Namespace getJuneauNs()

XML namespace for Juneau properties.

Returns:

XML namespace for Juneau properties.

See Also:

• RdfParser.Builder.juneauNs(Namespace)

getLanguage

protected final String getLanguage()

RDF language.

Returns:

The RDF language to use.

See Also:

• RdfParser.Builder.language(String)

isLooseCollections

protected final boolean isLooseCollections()

Collections should be serialized and parsed as loose collections.

Returns:

true if collections of resources are handled as loose collections of resources in RDF instead of resources that are children of an RDF collection (e.g. Sequence, Bag).

See Also:

• RdfParser.Builder.looseCollections()

isTrimWhitespace

protected final boolean isTrimWhitespace()

Trim whitespace from text elements.

Returns:

true if whitespace in text elements will be automatically trimmed.

See Also:

• RdfParser.Builder.trimWhitespace()

properties

protected FluentMap<String,Object> properties()

Description copied from class: Context

Returns the properties on this bean as a map for debugging.

Overrides:

properties in class ReaderParser

Returns:

The properties on this bean as a map for debugging.