Package org.eclipse.rdf4j.model
Interface ValueFactory
- All Known Implementing Classes:
AbstractValueFactory
,MemValueFactory
,SimpleValueFactory
,ValidatingValueFactory
,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:
-
Method Summary
Modifier and TypeMethodDescriptionCreates a new bNode.createBNode
(String nodeID) Creates a new blank node with the given node identifier.Creates a new IRI from the supplied string-representation.Creates a new IRI from the supplied namespace and local name.createLiteral
(boolean value) Creates a new xsd:boolean-typed literal representing the specified value.createLiteral
(byte value) Creates a new xsd:byte-typed literal representing the specified value.createLiteral
(double value) Creates a new xsd:double-typed literal representing the specified value.createLiteral
(float value) Creates a new xsd:float-typed literal representing the specified value.createLiteral
(int value) Creates a new xsd:int-typed literal representing the specified value.createLiteral
(long value) Creates a new xsd:long-typed literal representing the specified value.createLiteral
(short value) Creates a new xsd:short-typed literal representing the specified value.createLiteral
(String label) Creates a new literal with the supplied label.createLiteral
(String label, String language) Creates a new literal with the supplied label and language attribute.createLiteral
(String label, CoreDatatype datatype) Creates a new literal with the supplied label and datatype.createLiteral
(String label, IRI datatype) Creates a new literal with the supplied label and datatype.createLiteral
(String label, IRI datatype, CoreDatatype coreDatatype) Creates a new literal with the supplied label and datatype.createLiteral
(BigDecimal bigDecimal) Creates a new literal representing the specified bigDecimal that is typed as an xsd:decimal.createLiteral
(BigInteger bigInteger) Creates a new literal representing the specified bigInteger that is typed as an xsd:integer.default Literal
createLiteral
(TemporalAccessor value) Creates a new literal representing a temporal accessor value.default Literal
createLiteral
(TemporalAmount value) Creates a new literal representing a temporal amount value.createLiteral
(Date date) Creates a new literal representing the specified date that is typed using the appropriate XML Schema date/time datatype.createLiteral
(XMLGregorianCalendar calendar) Creates a new literal representing the specified calendar that is typed using the appropriate XML Schema date/time datatype.createStatement
(Resource subject, IRI predicate, Value object) Creates a new statement with the supplied subject, predicate and object.createStatement
(Resource subject, IRI predicate, Value object, Resource context) Creates a new statement with the supplied subject, predicate and object and associated context.default Triple
createTriple
(Resource subject, IRI predicate, Value object) Creates a new RDF-star triple with the supplied subject, predicate and object.
-
Method Details
-
createIRI
Creates a new IRI from the supplied string-representation.- Parameters:
iri
- A string-representation of a IRI.- Returns:
- An object representing the IRI.
- Throws:
IllegalArgumentException
- If the supplied string does not resolve to a legal (absolute) IRI.
-
createIRI
Creates a new IRI from the supplied namespace and local name. Calling this method is funtionally equivalent to callingcreateIRI(namespace+localName)
, but allows the ValueFactory to reuse supplied namespace and local name strings whenever possible. Note that the values returned byIRI.getNamespace()
andIRI.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.
-
createBNode
-
createBNode
-
createLiteral
Creates a new literal with the supplied label. The return value ofLiteral.getDatatype()
for the returned object must bexsd:string
.- Parameters:
label
- The literal's label, must not be null.- Returns:
- A literal for the specified value.
-
createLiteral
Creates a new literal with the supplied label and language attribute. The return value ofLiteral.getDatatype()
for the returned object must berdf:langString
.- Parameters:
label
- The literal's label, must not be null.language
- The literal's language attribute, must not be null.- Returns:
- A literal for the specified value and language attribute.
-
createLiteral
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 datatypexsd:string
will be assigned to this literal.- Returns:
- A literal for the specified value and type.
-
createLiteral
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. It may not be null.
-
createLiteral
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 datatypexsd:string
will be assigned to this literal.
-
createLiteral
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
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
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
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
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
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
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
Creates a new literal representing the specified bigDecimal that is typed as an xsd:decimal.- Parameters:
bigDecimal
- The value for the literal.- Returns:
- An xsd:decimal-typed literal for the specified value.
-
createLiteral
Creates a new literal representing the specified bigInteger that is typed as an xsd:integer.- Parameters:
bigInteger
- The value for the literal.- Returns:
- An xsd:integer-typed literal for the specified value.
-
createLiteral
Creates a new literal representing a temporal accessor value.- Parameters:
value
- the temporal accessor value for the literal- Returns:
- a literal representing the specified temporal accessor
value
with the appropriate XML Schema date/time datatype - Throws:
NullPointerException
- ifvalue
isnull
IllegalArgumentException
- ifvalue
cannot be represented by an XML Schema date/time datatype- Since:
- 3.5.0
-
createLiteral
Creates a new literal representing a temporal amount value.- Parameters:
value
- the temporal amount value for the literal- Returns:
- a literal representing the specified temporal amount
value
with the appropriate XML Schema duration datatype - Throws:
NullPointerException
- ifvalue
isnull
IllegalArgumentException
- ifvalue
cannot be represented by an XML Schema duration datatype- Since:
- 3.5.0
-
createLiteral
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:
- A typed literal for the specified calendar.
-
createLiteral
-
createStatement
-
createStatement
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.
-
createTriple
Creates a new RDF-star triple 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 triple.
- Since:
- 3.2.0
-