org.apache.commons.rdf.simple

Class SimpleRDF

java.lang.Object

org.apache.commons.rdf.simple.SimpleRDF

All Implemented Interfaces:

RDF

public class SimpleRDF
extends Object
implements RDF

Simple RDF implementation.

The RDFTerm, Triple, Quad, Graph and Dataset instances created by SimpleRDF are simple in-memory Implementations that are not thread-safe or efficient, but which may be useful for testing and prototyping purposes.

Constructor Summary

Constructors

Constructor and Description
SimpleRDF()

Method Summary

Modifier and Type	Method and Description
BlankNode	createBlankNode() Create a new blank node.
BlankNode	createBlankNode(String name) Create a blank node based on the given name.
Dataset	createDataset() Create a new dataset.
Graph	createGraph() Create a new graph.
IRI	createIRI(String iri) Create an IRI from a (possibly escaped) String.
Literal	createLiteral(String literal) Create a simple literal.
Literal	createLiteral(String literal, IRI dataType) Create a literal with the specified data type.
Literal	createLiteral(String literal, String language) Create a language-tagged literal.
Quad	createQuad(BlankNodeOrIRI graphName, BlankNodeOrIRI subject, IRI predicate, RDFTerm object) Create a quad.
Triple	createTriple(BlankNodeOrIRI subject, IRI predicate, RDFTerm object) Create a triple.

Methods inherited from class java.lang.Object

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

Constructor Detail

SimpleRDF

public SimpleRDF()

Method Detail

createBlankNode

public BlankNode createBlankNode()

Description copied from interface: RDF

Create a new blank node.

The returned blank node MUST NOT be equal to any existing BlankNode instances according to BlankNode.equals(Object).

Specified by:

createBlankNode in interface RDF

Returns:

A new, unique BlankNode

createBlankNode

public BlankNode createBlankNode(String name)

Description copied from interface: RDF

Create a blank node based on the given name.

All BlankNodes created with the given name on a particular instance of RDF MUST be equivalent according to BlankNode.equals(Object),

The returned BlankNode MUST NOT be equal to BlankNode instances returned for any other name or those returned from RDF.createBlankNode().

The returned BlankNode SHOULD NOT be equivalent to any BlankNodes created on a different RDF instance, e.g. different instances of RDF should produce different blank nodes for the same name unless they purposely are intending to create equivalent BlankNode instances (e.g. a reinstated Serializable factory).

Specified by:

createBlankNode in interface RDF

Parameters:

name - A non-empty, non-null, String that is unique to this blank node in the context of this RDF.

Returns:

A BlankNode for the given name

createGraph

public Graph createGraph()

Description copied from interface: RDF

Create a new graph. It is undefined if the graph will be persisted by any underlying storage mechanism.

Specified by:

createGraph in interface RDF

Returns:

A new Graph

createDataset

public Dataset createDataset()
                      throws UnsupportedOperationException

Description copied from interface: RDF

Create a new dataset. It is undefined if the dataset will be persisted by any underlying storage mechanism.

Specified by:

createDataset in interface RDF

Returns:

A new Dataset

Throws:

UnsupportedOperationException

createIRI

public IRI createIRI(String iri)

Description copied from interface: RDF

Create an IRI from a (possibly escaped) String. The provided iri string MUST be valid according to the W3C RDF-1.1 IRI definition.

Specified by:

createIRI in interface RDF

Parameters:

iri - Internationalized Resource Identifier

Returns:

A new IRI

createLiteral

public Literal createLiteral(String literal)

Description copied from interface: RDF

Create a simple literal. The provided lexical form should not be escaped in any sense, e.g. should not include "quotes" unless those are part of the literal value. The returned Literal MUST have a Literal.getLexicalForm() that is equal to the provided lexical form, MUST NOT have a Literal.getLanguageTag() present, and SHOULD return a Literal.getDatatype() that is equal to the IRI http://www.w3.org/2001/XMLSchema#string.

Specified by:

createLiteral in interface RDF

Parameters:

literal - The literal value in plain text

Returns:

The created Literal

createLiteral

public Literal createLiteral(String literal,
                             IRI dataType)

Description copied from interface: RDF

Create a literal with the specified data type. The provided lexical form should not be escaped in any sense, e.g. should not include "quotes" unless those are part of the literal value. It is RECOMMENDED that the provided dataType is one of the RDF-compatible XSD types. The provided lexical form SHOULD be in the lexical space of the provided dataType. The returned Literal SHOULD have a Literal.getLexicalForm() that is equal to the provided lexicalForm, MUST NOT have a Literal.getLanguageTag() present, and MUST return a Literal.getDatatype() that is equivalent to the provided dataType IRI.

Specified by:

createLiteral in interface RDF

Parameters:

literal - The literal value

dataType - The data type IRI for the literal value, e.g. http://www.w3.org/2001/XMLSchema#integer

Returns:

The created Literal

createLiteral

public Literal createLiteral(String literal,
                             String language)

Description copied from interface: RDF

Create a language-tagged literal. The provided lexical form should not be escaped in any sense, e.g. should not include "quotes" unless those are part of the literal value. The provided language tag MUST be valid according to BCP47, e.g. en. The provided language tag MAY be converted to lower case. The returned Literal SHOULD have a Literal.getLexicalForm() which is equal to the provided lexicalForm, MUST return a Literal.getDatatype() that is equal to the IRI http://www.w3.org/1999/02/22-rdf-syntax-ns#langString, and MUST have a Literal.getLanguageTag() present which SHOULD be equal to the provided language tag (compared as String.toLowerCase(Locale) using Locale.ENGLISH).

Specified by:

createLiteral in interface RDF

Parameters:

literal - The literal value

language - The non-empty language tag as defined by BCP47

Returns:

The created Literal

createTriple

public Triple createTriple(BlankNodeOrIRI subject,
                           IRI predicate,
                           RDFTerm object)

Description copied from interface: RDF

Create a triple. The returned Triple SHOULD have a Triple.getSubject() that is equal to the provided subject, a Triple.getPredicate() that is equal to the provided predicate, and a Triple.getObject() that is equal to the provided object.

Specified by:

createTriple in interface RDF

Parameters:

subject - The IRI or BlankNode that is the subject of the triple

predicate - The IRI that is the predicate of the triple

object - The IRI, BlankNode or Literal that is the object of the triple

Returns:

The created Triple

createQuad

public Quad createQuad(BlankNodeOrIRI graphName,
                       BlankNodeOrIRI subject,
                       IRI predicate,
                       RDFTerm object)
                throws IllegalArgumentException

Description copied from interface: RDF

Create a quad.

The returned Quad SHOULD have a Quad.getGraphName() that is equal to the provided graphName, a Quad.getSubject() that is equal to the provided subject, a Quad.getPredicate() that is equal to the provided predicate, and a Quad.getObject() that is equal to the provided object.

Specified by:

createQuad in interface RDF

Parameters:

graphName - The IRI or BlankNode that this quad belongs to, or null for the public graph

subject - The IRI or BlankNode that is the subject of the quad

predicate - The IRI that is the predicate of the quad

object - The IRI, BlankNode or Literal that is the object of the quad

Returns:

The created Quad

Throws:

IllegalArgumentException - If any of the provided arguments are not acceptable, e.g. because a Literal has a lexicalForm that is too large for an underlying storage.