org.eclipse.rdf4j.model

Interface ValueFactory

All Known Implementing Classes:

AbstractValueFactory, MemValueFactory, SimpleValueFactory, ValidatingValueFactory, ValueFactoryBase, ValueFactoryImpl, ValueStore

public interface ValueFactory

A factory for creating IRIs, blank nodes, literals and statements based on the RDF-1.1 Concepts and Abstract Syntax, a W3C Recommendation.

Author:

Arjohn Kampman

See Also:

RDF-1.1 Concepts and Abstract Syntax

Method Summary

Modifier and Type	Method and Description
BNode	createBNode() Creates a new bNode.
BNode	createBNode(String nodeID) Creates a new blank node with the given node identifier.
IRI	createIRI(String iri) Creates a new IRI from the supplied string-representation.
IRI	createIRI(String namespace, String localName) Creates a new IRI from the supplied namespace and local name.
Literal	createLiteral(BigDecimal bigDecimal) Creates a new literal representing the specified bigDecimal that is typed using the appropriate XML Schema date/time datatype.
Literal	createLiteral(BigInteger bigInteger) Creates a new literal representing the specified bigInteger that is typed using the appropriate XML Schema date/time datatype.
Literal	createLiteral(boolean value) Creates a new xsd:boolean-typed literal representing the specified value.
Literal	createLiteral(byte value) Creates a new xsd:byte-typed literal representing the specified value.
Literal	createLiteral(Date date) Creates a new literal representing the specified date that is typed using the appropriate XML Schema date/time datatype.
Literal	createLiteral(double value) Creates a new xsd:double-typed literal representing the specified value.
Literal	createLiteral(float value) Creates a new xsd:float-typed literal representing the specified value.
Literal	createLiteral(int value) Creates a new xsd:int-typed literal representing the specified value.
Literal	createLiteral(long value) Creates a new xsd:long-typed literal representing the specified value.
Literal	createLiteral(short value) Creates a new xsd:short-typed literal representing the specified value.
Literal	createLiteral(String label) Creates a new literal with the supplied label.
Literal	createLiteral(String label, IRI datatype) Creates a new literal with the supplied label and datatype.
Literal	createLiteral(String label, String language) Creates a new literal with the supplied label and language attribute.
default Literal	createLiteral(String label, URI datatype) Deprecated. Use createLiteral(String, IRI) instead.
Literal	createLiteral(XMLGregorianCalendar calendar) Creates a new literal representing the specified calendar that is typed using the appropriate XML Schema date/time datatype.
Statement	createStatement(Resource subject, IRI predicate, Value object) Creates a new statement with the supplied subject, predicate and object.
Statement	createStatement(Resource subject, IRI predicate, Value object, Resource context) Creates a new statement with the supplied subject, predicate and object and associated context.
default Statement	createStatement(Resource subject, URI predicate, Value object) Deprecated. Use createStatement(Resource, IRI, Value) instead.
default Statement	createStatement(Resource subject, URI predicate, Value object, Resource context) Deprecated. Use createStatement(Resource, IRI, Value, Resource) instead.
default URI	createURI(String uri) Deprecated. Use {createIRI(String) instead.
default URI	createURI(String namespace, String localName) Deprecated. Use {createIRI(String, String) instead.

Method Detail

createIRI

IRI createIRI(String iri)

Creates a new IRI from the supplied string-representation.

Parameters:

iri - A string-representation of a IRI.

Returns:

An object representing the IRI.

Throws:

IlllegalArgumentException - If the supplied string does not resolve to a legal (absolute) IRI.

createURI

@Deprecated
default URI createURI(String uri)

Deprecated. Use {createIRI(String) instead.

Creates a new URI from the supplied string-representation.

Parameters:

uri - A string-representation of a URI.

Returns:

An object representing the URI.

Throws:

IlllegalArgumentException - If the supplied string does not resolve to a legal (absolute) URI.

createIRI

IRI createIRI(String namespace,
              String localName)

Creates a new IRI from the supplied namespace and local name. Calling this method is funtionally equivalent to calling createIRI(namespace+localName), but allows the ValueFactory to reuse supplied namespace and local name strings whenever possible. Note that the values returned by IRI.getNamespace() and IRI.getLocalName() are not necessarily the same as the values that are supplied to this method.

Parameters:

namespace - The IRI's namespace.

localName - The IRI's local name.

Throws:

IllegalArgumentException - If the supplied namespace and localname do not resolve to a legal (absolute) IRI.

createURI

@Deprecated
default URI createURI(String namespace,
                                  String localName)

Deprecated. Use {createIRI(String, String) instead.

Creates a new URI from the supplied namespace and local name.

Parameters:

uri - A string-representation of a URI.

Returns:

An object representing the URI.

Throws:

IlllegalArgumentException - If the supplied string does not resolve to a legal (absolute) URI.

createBNode

BNode createBNode()

Creates a new bNode.

Returns:

An object representing the bNode.

createBNode

BNode createBNode(String nodeID)

Creates a new blank node with the given node identifier.

Parameters:

nodeID - The blank node identifier.

Returns:

An object representing the blank node.

createLiteral

Literal createLiteral(String label)

Creates a new literal with the supplied label. The return value of Literal.getDatatype() for the returned object must be XMLSchema.STRING.

Parameters:

label - The literal's label, must not be null.

createLiteral

Literal createLiteral(String label,
                      String language)

Creates a new literal with the supplied label and language attribute. The return value of Literal.getDatatype() for the returned object must be RDF.LANGSTRING.

Parameters:

label - The literal's label, must not be null.

language - The literal's language attribute, must not be null.

createLiteral

Literal createLiteral(String label,
                      IRI datatype)

Creates a new literal with the supplied label and datatype.

Parameters:

label - The literal's label, must not be null.

datatype - The literal's datatype. If it is null, the datatype XMLSchema.STRING will be assigned to this literal.

createLiteral

@Deprecated
default Literal createLiteral(String label,
                                          URI datatype)

Deprecated. Use createLiteral(String, IRI) instead.

Creates a new literal with the supplied label and datatype.

Parameters:

label - The literal's label.

datatype - The literal's datatype. If it is null, the datatype XMLSchema.STRING will be assigned to this literal.

createLiteral

Literal createLiteral(boolean value)

Creates a new xsd:boolean-typed literal representing the specified value.

Parameters:

value - The value for the literal.

Returns:

An xsd:boolean-typed literal for the specified value.

createLiteral

Literal createLiteral(byte value)

Creates a new xsd:byte-typed literal representing the specified value.

Parameters:

value - The value for the literal.

Returns:

An xsd:byte-typed literal for the specified value.

createLiteral

Literal createLiteral(short value)

Creates a new xsd:short-typed literal representing the specified value.

Parameters:

value - The value for the literal.

Returns:

An xsd:short-typed literal for the specified value.

createLiteral

Literal createLiteral(int value)

Creates a new xsd:int-typed literal representing the specified value.

Parameters:

value - The value for the literal.

Returns:

An xsd:int-typed literal for the specified value.

createLiteral

Literal createLiteral(long value)

Creates a new xsd:long-typed literal representing the specified value.

Parameters:

value - The value for the literal.

Returns:

An xsd:long-typed literal for the specified value.

createLiteral

Literal createLiteral(float value)

Creates a new xsd:float-typed literal representing the specified value.

Parameters:

value - The value for the literal.

Returns:

An xsd:float-typed literal for the specified value.

createLiteral

Literal createLiteral(double value)

Creates a new xsd:double-typed literal representing the specified value.

Parameters:

value - The value for the literal.

Returns:

An xsd:double-typed literal for the specified value.

createLiteral

Literal createLiteral(BigDecimal bigDecimal)

Creates a new literal representing the specified bigDecimal that is typed using the appropriate XML Schema date/time datatype.

createLiteral

Literal createLiteral(BigInteger bigInteger)

Creates a new literal representing the specified bigInteger that is typed using the appropriate XML Schema date/time datatype.

createLiteral

Literal createLiteral(XMLGregorianCalendar calendar)

Creates a new literal representing the specified calendar that is typed using the appropriate XML Schema date/time datatype.

Parameters:

calendar - The value for the literal.

Returns:

An typed literal for the specified calendar.

createLiteral

Literal createLiteral(Date date)

Creates a new literal representing the specified date that is typed using the appropriate XML Schema date/time datatype.

createStatement

Statement createStatement(Resource subject,
                          IRI predicate,
                          Value object)

Creates a new statement with the supplied subject, predicate and object.

Parameters:

subject - The statement's subject.

predicate - The statement's predicate.

object - The statement's object.

Returns:

The created statement.

createStatement

@Deprecated
default Statement createStatement(Resource subject,
                                              URI predicate,
                                              Value object)

Deprecated. Use createStatement(Resource, IRI, Value) instead.

Creates a new statement with the supplied subject, predicate and object.

Parameters:

subject - The statement's subject.

predicate - The statement's predicate.

object - The statement's object.

Returns:

The created statement.

createStatement

Statement createStatement(Resource subject,
                          IRI predicate,
                          Value object,
                          Resource context)

Creates a new statement with the supplied subject, predicate and object and associated context.

Parameters:

subject - The statement's subject.

predicate - The statement's predicate.

object - The statement's object.

context - The statement's context.

Returns:

The created statement.

createStatement

@Deprecated
default Statement createStatement(Resource subject,
                                              URI predicate,
                                              Value object,
                                              Resource context)

Deprecated. Use createStatement(Resource, IRI, Value, Resource) instead.

Creates a new statement with the supplied subject, predicate and object and associated context.

Parameters:

subject - The statement's subject.

predicate - The statement's predicate.

object - The statement's object.

Returns:

The created statement.