org.jrdf.graph
Interface GraphValueFactory

All Known Subinterfaces:

GraphElementFactory

All Known Implementing Classes:

GraphElementFactoryImpl, GraphValueFactoryImpl

public interface GraphValueFactory

Method Summary

Literal	createLiteral(Object object) Converts a known Java class (such as Integer) into an RDF literal (XSD:int).
Literal	createLiteral(String lexicalValue) Creates a new literal with the given lexical value, with no language or datatype.
Literal	createLiteral(String lexicalValue, String languageType) Creates a new literal with the given lexical value, with a given language but no datatype.
Literal	createLiteral(String lexicalValue, URI datatypeURI) Creates a new literal with the given lexical value and given datatype.
URIReference	createURIReference(URI uri) Create a URI reference.
URIReference	createURIReference(URI uri, boolean validate) Create a URI reference without checking if the URI given is a valid RDF URI, currently if the URI is absolute.

Method Detail

createURIReference

URIReference createURIReference(URI uri)
                                throws GraphElementFactoryException

Create a URI reference. Checks the validity of the URI (must be absolute).

Parameters:

uri - The URI of the resource.

Returns:

the newly created URI reference value.

Throws:

GraphElementFactoryException - If the resource failed to be created.

createURIReference

URIReference createURIReference(URI uri,
                                boolean validate)
                                throws GraphElementFactoryException

Create a URI reference without checking if the URI given is a valid RDF URI, currently if the URI is absolute.

Parameters:

uri - The URI of the resource.

validate - true if we disbale checking to see if the URI is valid.

Returns:

The newly created URI reference value.

Throws:

GraphElementFactoryException - If the resource failed to be created.

createLiteral

Literal createLiteral(Object object)
                      throws GraphElementFactoryException

Converts a known Java class (such as Integer) into an RDF literal (XSD:int).

Parameters:

object - the value object (a Java class) to create the literal from.

Returns:

the newly created literal value.

Throws:

GraphElementFactoryException - If the literal failed to be created.

IllegalArgumentException - if there is no registered class to value creator mapping in the datatype factory.

createLiteral

Literal createLiteral(String lexicalValue)
                      throws GraphElementFactoryException

Creates a new literal with the given lexical value, with no language or datatype.

Parameters:

lexicalValue - The lexical value for the literal.

Returns:

the newly created literal value.

Throws:

GraphElementFactoryException - If the literal failed to be created.

createLiteral

Literal createLiteral(String lexicalValue,
                      String languageType)
                      throws GraphElementFactoryException

Creates a new literal with the given lexical value, with a given language but no datatype.

Parameters:

lexicalValue - The lexical value for the literal. Cannot be null.

languageType - The language of the literal or null if not required.

Returns:

the newly created literal value.

Throws:

GraphElementFactoryException - If the literal failed to be created.

createLiteral

Literal createLiteral(String lexicalValue,
                      URI datatypeURI)
                      throws GraphElementFactoryException

Creates a new literal with the given lexical value and given datatype.

Parameters:

lexicalValue - The lexical value for the literal. Cannot be null.

datatypeURI - The URI of the datatype of the literal or null if not required.

Returns:

the newly created literal value.

Throws:

GraphElementFactoryException - If the literal failed to be created.