Class Values

java.lang.Object

org.eclipse.rdf4j.model.util.Values

public class Values
extends Object

Factory methods to quickly create Value objects ( IRI, Literal, BNode, and Triple) without having to create a ValueFactory first.

Example usage:

import static org.eclipse.rdf4j.model.util.Values.iri;

...
IRI foo = iri("http://example.org/foo");

Since:

3.5.0

See Also:

• Statements

Field Summary

Fields

Modifier and Type	Field	Description
private static final ValueFactory	VALUE_FACTORY	Internal shared value factory used for creating all values.

Constructor Summary

Constructors

Modifier	Constructor	Description
private	Values()

Method Summary

Modifier and Type	Method	Description
static BNode	bnode()	Creates a new BNode
static BNode	bnode(String nodeId)	Creates a new BNode with the supplied node identifier.
static BNode	bnode(ValueFactory vf)	Creates a new BNode
static BNode	bnode(ValueFactory vf, String nodeId)	Creates a new BNode with the supplied node identifier.
private static Literal	createLiteralFromObject(ValueFactory valueFactory, Object object, boolean throwExceptionOnFailure)	Creates a typed Literal out of the supplied object, mapping the runtime type of the object to the appropriate XML Schema type.
static ValueFactory	getValueFactory()	Get a ValueFactory.
static IRI	iri(Iterable<Namespace> namespaces, String prefixedName)	Create a new IRI from a supplied prefixed name, using the supplied namespaces
static IRI	iri(String iri)	Create a new IRI using the supplied iri string
static IRI	iri(String namespace, String localName)	Create a new IRI using the supplied namespace name and local name
static IRI	iri(Namespace namespace, String localName)	Create a new IRI using the supplied Namespace and local name
static IRI	iri(ValueFactory vf, String iri)	Create a new IRI using the supplied iri string
static IRI	iri(ValueFactory vf, String namespace, String localName)	Create a new IRI using the supplied namespace and local name
static Literal	literal(boolean booleanValue)	Creates a new Literal with the supplied boolean value
static Literal	literal(byte byteValue)	Creates a new Literal with the supplied byte value
static Literal	literal(double doubleValue)	Creates a new Literal with the supplied double value
static Literal	literal(float floatValue)	Creates a new Literal with the supplied float value
static Literal	literal(int intValue)	Creates a new Literal with the supplied int value
static Literal	literal(long longValue)	Creates a new Literal with the supplied long value
static Literal	literal(short shortValue)	Creates a new Literal with the supplied short value
static Literal	literal(Object object)	Creates a new typed Literal out of the supplied object, mapping the runtime type of the object to the appropriate XSD datatype.
static Literal	literal(Object object, boolean failOnUnknownType)	Creates a new typed Literal out of the supplied object, mapping the runtime type of the object to the appropriate XSD datatype.
static Literal	literal(String lexicalValue)	Creates a new Literal with the supplied lexical value.
static Literal	literal(String lexicalValue, String languageTag)	Creates a new Literal with the supplied lexical value.
static Literal	literal(String lexicalValue, CoreDatatype datatype)	Creates a new Literal with the supplied lexical value and datatype.
static Literal	literal(String lexicalValue, IRI datatype)	Creates a new Literal with the supplied lexical value and datatype.
static Literal	literal(BigDecimal bigDecimal)	Creates a new Literal with the supplied BigDecimal value
static Literal	literal(BigInteger bigInteger)	Creates a new Literal with the supplied BigInteger value
static Literal	literal(TemporalAccessor value)	Creates a new Literal with the supplied TemporalAccessor value
static Literal	literal(ValueFactory vf, boolean booleanValue)	Creates a new Literal with the supplied boolean value
static Literal	literal(ValueFactory vf, byte byteValue)	Creates a new Literal with the supplied byte value
static Literal	literal(ValueFactory vf, double doubleValue)	Creates a new Literal with the supplied double value
static Literal	literal(ValueFactory vf, float floatValue)	Creates a new Literal with the supplied float value
static Literal	literal(ValueFactory vf, int intValue)	Creates a new Literal with the supplied int value
static Literal	literal(ValueFactory vf, long longValue)	Creates a new Literal with the supplied long value
static Literal	literal(ValueFactory vf, short shortValue)	Creates a new Literal with the supplied short value
static Literal	literal(ValueFactory vf, Object object, boolean failOnUnknownType)	Creates a new typed Literal out of the supplied object, mapping the runtime type of the object to the appropriate XSD datatype.
static Literal	literal(ValueFactory vf, String lexicalValue)	Creates a new Literal with the supplied lexical value.
static Literal	literal(ValueFactory vf, String lexicalValue, String languageTag)	Creates a new Literal with the supplied lexical value.
static Literal	literal(ValueFactory vf, String lexicalValue, CoreDatatype datatype)	Creates a new Literal with the supplied lexical value and datatype.
static Literal	literal(ValueFactory vf, String lexicalValue, IRI datatype)	Creates a new Literal with the supplied lexical value and datatype.
static Literal	literal(ValueFactory vf, BigDecimal bigDecimal)	Creates a new Literal with the supplied BigDecimal value
static Literal	literal(ValueFactory vf, BigInteger bigInteger)	Creates a new Literal with the supplied BigInteger value
static Literal	literal(ValueFactory vf, TemporalAccessor value)	Creates a new Literal with the supplied TemporalAccessor value
static Namespace	namespace(String prefix, String name)	Create a new Namespace object.
static Triple	triple(Resource subject, IRI predicate, Value object)	Creates a new RDF-star embedded triple with the supplied subject, predicate, and object.
static Triple	triple(Statement statement)	Creates a new RDF-star embedded triple using the subject, predicate and object from the supplied Statement.
static Triple	triple(ValueFactory vf, Resource subject, IRI predicate, Value object)	Creates a new RDF-star embedded triple with the supplied subject, predicate, and object.
static Triple	triple(ValueFactory vf, Statement statement)	Creates a new RDF-star embedded triple using the subject, predicate and object from the supplied Statement.

Methods inherited from class Object

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

Field Details

VALUE_FACTORY

private static final ValueFactory VALUE_FACTORY

Internal shared value factory used for creating all values. We use a ValidatingValueFactory to ensure created values are syntactically legal.

Constructor Details

Values

private Values()

Method Details

iri

public static IRI iri(String iri)
               throws IllegalArgumentException

Create a new IRI using the supplied iri string

Parameters:

iri - a string representing a valid (absolute) iri

Returns:

an IRI object for the supplied iri string.

Throws:

NullPointerException - if the suppplied iri is null

IllegalArgumentException - if the supplied iri string can not be parsed as a legal IRI.

iri

public static IRI iri(ValueFactory vf,
 String iri)
               throws IllegalArgumentException

Create a new IRI using the supplied iri string

Parameters:

vf - the ValueFactory to use for creation of the IRI.

iri - a string representing a valid (absolute) iri

Returns:

an IRI object for the supplied iri string.

Throws:

NullPointerException - if any of the input parameters is null

IllegalArgumentException - if the supplied iri string can not be parsed as a legal IRI by the supplied ValueFactory .

iri

public static IRI iri(String namespace,
 String localName)
               throws IllegalArgumentException

Create a new IRI using the supplied namespace name and local name

Parameters:

namespace - the IRI's namespace name

localName - the IRI's local name

Returns:

an IRI object for the supplied IRI namespace name and localName.

Throws:

NullPointerException - if any of the input parameters is null

IllegalArgumentException - if the supplied iri string can not be parsed as a legal IRI.

iri

public static IRI iri(Namespace namespace,
 String localName)
               throws IllegalArgumentException

Create a new IRI using the supplied Namespace and local name

Parameters:

namespace - the IRI's Namespace

localName - the IRI's local name

Returns:

an IRI object for the supplied IRI namespace and localName.

Throws:

NullPointerException - if any of the input parameters is null

IllegalArgumentException - if the supplied iri string can not be parsed as a legal IRI.

Since:

3.6.0

iri

public static IRI iri(Iterable<Namespace> namespaces,
 String prefixedName)
               throws IllegalArgumentException

Create a new IRI from a supplied prefixed name, using the supplied namespaces

Parameters:

namespaces - the Namespaces from which to find the correct namespace to map the prefixed name to

prefixedName - a prefixed name that is a shorthand for a full iri, using syntax form prefix:localName. For example, rdf:type is a prefixed name where rdf is the prefix. If the correct Namespace definition is also supplied this expands to the full namespace name http://www.w3.org/1999/02/22-rdf-syntax-ns#, leading to a full IRI http://www.w3.org/1999/02/22-rdf-syntax-ns#type.

Returns:

an IRI object for the supplied IRI namespace and localName.

Throws:

NullPointerException - if any of the input parameters is null

IllegalArgumentException - if the supplied prefixed name can not be transformed to a legal IRI.

Since:

3.6.0

iri

public static IRI iri(ValueFactory vf,
 String namespace,
 String localName)
               throws IllegalArgumentException

Create a new IRI using the supplied namespace and local name

Parameters:

vf - the ValueFactory to use for creation of the IRI.

namespace - the IRI's namespace

localName - the IRI's local name

Returns:

an IRI object for the supplied IRI namespace and localName.

Throws:

NullPointerException - if any of the input parameters is null

IllegalArgumentException - if the supplied iri string can not be parsed as a legal IRI by the supplied ValueFactory

bnode

public static BNode bnode()

Creates a new BNode

Returns:

a new BNode

bnode

public static BNode bnode(ValueFactory vf)

Creates a new BNode

Parameters:

vf - the ValueFactory to use for creation of the BNode

Returns:

a new BNode

Throws:

NullPointerException - if any of the input parameters is null

bnode

public static BNode bnode(String nodeId)
                   throws IllegalArgumentException

Creates a new BNode with the supplied node identifier.

Parameters:

nodeId - the node identifier

Returns:

a new BNode

Throws:

NullPointerException - if the supplied node identifier is null.

IllegalArgumentException - if the supplied node identifier is not valid

bnode

public static BNode bnode(ValueFactory vf,
 String nodeId)
                   throws IllegalArgumentException

Creates a new BNode with the supplied node identifier.

Parameters:

vf - the ValueFactory to use for creation of the BNode

nodeId - the node identifier

Returns:

a new BNode

Throws:

NullPointerException - if any of the input parameters is null

IllegalArgumentException - if the supplied node identifier is not valid

literal

public static Literal literal(String lexicalValue)

Creates a new Literal with the supplied lexical value.

Parameters:

lexicalValue - the lexical value for the literal

Returns:

a new Literal of type XSD.STRING

Throws:

NullPointerException - if the supplied lexical value is null.

literal

public static Literal literal(ValueFactory vf,
 String lexicalValue)

Creates a new Literal with the supplied lexical value.

Parameters:

vf - the ValueFactory to use for creation of the Literal

lexicalValue - the lexical value for the literal

Returns:

a new Literal of type XSD.STRING

Throws:

NullPointerException - if any of the input parameters is null

literal

public static Literal literal(String lexicalValue,
 String languageTag)

Creates a new Literal with the supplied lexical value.

Parameters:

lexicalValue - the lexical value for the literal

languageTag - the language tag for the literal.

Returns:

a new Literal of type RDF.LANGSTRING

Throws:

NullPointerException - if the supplied lexical value or language tag is null.

literal

public static Literal literal(ValueFactory vf,
 String lexicalValue,
 String languageTag)

Creates a new Literal with the supplied lexical value.

Parameters:

vf - the ValueFactory to use for creation of the Literal

lexicalValue - the lexical value for the literal

languageTag - the language tag for the literal.

Returns:

a new Literal of type RDF.LANGSTRING

Throws:

NullPointerException - if any of the input parameters is null

literal

public static Literal literal(String lexicalValue,
 IRI datatype)
                       throws IllegalArgumentException

Creates a new Literal with the supplied lexical value and datatype.

Parameters:

lexicalValue - the lexical value for the literal

datatype - the datatype IRI

Returns:

a new Literal with the supplied lexical value and datatype

Throws:

NullPointerException - if the supplied lexical value or datatype is null.

IllegalArgumentException - if the supplied lexical value is not valid for the given datatype

literal

public static Literal literal(String lexicalValue,
 CoreDatatype datatype)
                       throws IllegalArgumentException

Creates a new Literal with the supplied lexical value and datatype.

Parameters:

lexicalValue - the lexical value for the literal

datatype - the CoreDatatype

Returns:

a new Literal with the supplied lexical value and datatype

Throws:

NullPointerException - if the supplied lexical value or datatype is null.

IllegalArgumentException - if the supplied lexical value is not valid for the given datatype

literal

public static Literal literal(ValueFactory vf,
 String lexicalValue,
 IRI datatype)
                       throws IllegalArgumentException

Creates a new Literal with the supplied lexical value and datatype.

Parameters:

vf - the ValueFactory to use for creation of the Literal

lexicalValue - the lexical value for the literal

datatype - the datatype IRI

Returns:

a new Literal with the supplied lexical value and datatype

Throws:

NullPointerException - if any of the input parameters is null.

IllegalArgumentException - if the supplied lexical value is not valid for the given datatype

literal

public static Literal literal(ValueFactory vf,
 String lexicalValue,
 CoreDatatype datatype)
                       throws IllegalArgumentException

Creates a new Literal with the supplied lexical value and datatype.

Parameters:

vf - the ValueFactory to use for creation of the Literal

lexicalValue - the lexical value for the literal

datatype - the CoreDatatype

Returns:

a new Literal with the supplied lexical value and datatype

Throws:

NullPointerException - if any of the input parameters is null.

IllegalArgumentException - if the supplied lexical value is not valid for the given datatype

literal

public static Literal literal(boolean booleanValue)

Creates a new Literal with the supplied boolean value

Parameters:

booleanValue - a boolean value

Returns:

a Literal of type XSD.BOOLEAN with the supplied value

literal

public static Literal literal(ValueFactory vf,
 boolean booleanValue)

Creates a new Literal with the supplied boolean value

Parameters:

vf - the ValueFactory to use for creation of the Literal

booleanValue - a boolean value

Returns:

a Literal of type XSD.BOOLEAN with the supplied value

Throws:

NullPointerException - if any of the input parameters is null.

literal

public static Literal literal(byte byteValue)

Creates a new Literal with the supplied byte value

Parameters:

byteValue - a byte value

Returns:

a Literal of type XSD.BYTE with the supplied value

literal

public static Literal literal(ValueFactory vf,
 byte byteValue)

Creates a new Literal with the supplied byte value

Parameters:

vf - the ValueFactory to use for creation of the Literal

byteValue - a byte value

Returns:

a Literal of type XSD.BYTE with the supplied value

Throws:

NullPointerException - if any of the input parameters is null.

literal

public static Literal literal(short shortValue)

Creates a new Literal with the supplied short value

Parameters:

shortValue - a short value

Returns:

a Literal of type XSD.SHORT with the supplied value

literal

public static Literal literal(ValueFactory vf,
 short shortValue)

Creates a new Literal with the supplied short value

Parameters:

vf - the ValueFactory to use for creation of the Literal

shortValue - a short value

Returns:

a Literal of type XSD.SHORT with the supplied value

Throws:

NullPointerException - if any of the input parameters is null.

literal

public static Literal literal(int intValue)

Creates a new Literal with the supplied int value

Parameters:

intValue - an int value

Returns:

a Literal of type XSD.INT with the supplied value

literal

public static Literal literal(ValueFactory vf,
 int intValue)

Creates a new Literal with the supplied int value

Parameters:

vf - the ValueFactory to use for creation of the Literal

intValue - an int value

Returns:

a Literal of type XSD.INT with the supplied value

Throws:

NullPointerException - if any of the input parameters is null.

literal

public static Literal literal(long longValue)

Creates a new Literal with the supplied long value

Parameters:

longValue - a long value

Returns:

a Literal of type XSD.LONG with the supplied value

literal

public static Literal literal(ValueFactory vf,
 long longValue)

Creates a new Literal with the supplied long value

Parameters:

vf - the ValueFactory to use for creation of the Literal

longValue - a long value

Returns:

a Literal of type XSD.LONG with the supplied value

Throws:

NullPointerException - if any of the input parameters is null.

literal

public static Literal literal(float floatValue)

Creates a new Literal with the supplied float value

Parameters:

floatValue - a float value

Returns:

a Literal of type XSD.FLOAT with the supplied value

literal

public static Literal literal(ValueFactory vf,
 float floatValue)

Creates a new Literal with the supplied float value

Parameters:

vf - the ValueFactory to use for creation of the Literal

floatValue - a float value

Returns:

a Literal of type XSD.FLOAT with the supplied value

Throws:

NullPointerException - if any of the input parameters is null.

literal

public static Literal literal(double doubleValue)

Creates a new Literal with the supplied double value

Parameters:

doubleValue - a double value

Returns:

a Literal of type XSD.DOUBLE with the supplied value

literal

public static Literal literal(ValueFactory vf,
 double doubleValue)

Creates a new Literal with the supplied double value

Parameters:

vf - the ValueFactory to use for creation of the Literal

doubleValue - a double value

Returns:

a Literal of type XSD.DOUBLE with the supplied value

Throws:

NullPointerException - if any of the input parameters is null.

literal

public static Literal literal(BigDecimal bigDecimal)

Creates a new Literal with the supplied BigDecimal value

Parameters:

bigDecimal - a BigDecimal value

Returns:

a Literal of type XSD.DECIMAL with the supplied value

Throws:

NullPointerException - if the supplied bigDecimal is null.

literal

public static Literal literal(ValueFactory vf,
 BigDecimal bigDecimal)

Creates a new Literal with the supplied BigDecimal value

Parameters:

vf - the ValueFactory to use for creation of the Literal

bigDecimal - a BigDecimal value

Returns:

a Literal of type XSD.DECIMAL with the supplied value

Throws:

NullPointerException - if any of the input parameters is null.

literal

public static Literal literal(BigInteger bigInteger)

Creates a new Literal with the supplied BigInteger value

Parameters:

bigInteger - a BigInteger value

Returns:

a Literal of type XSD.INTEGER with the supplied value

Throws:

NullPointerException - if the supplied bigInteger is null.

literal

public static Literal literal(ValueFactory vf,
 BigInteger bigInteger)

Creates a new Literal with the supplied BigInteger value

Parameters:

vf - the ValueFactory to use for creation of the Literal

bigInteger - a BigInteger value

Returns:

a Literal of type XSD.INTEGER with the supplied value

Throws:

NullPointerException - if any of the input parameters is null.

literal

public static Literal literal(TemporalAccessor value)
                       throws IllegalArgumentException

Creates a new Literal with the supplied TemporalAccessor value

Parameters:

value - a TemporalAccessor value.

Returns:

a Literal with the supplied calendar value and the appropriate XSD date/time datatype for the specific value.

Throws:

NullPointerException - if the supplied TemporalAccessor value is null.

IllegalArgumentException - if value cannot be represented by an XML Schema date/time datatype

literal

public static Literal literal(ValueFactory vf,
 TemporalAccessor value)
                       throws IllegalArgumentException

Creates a new Literal with the supplied TemporalAccessor value

Parameters:

vf - the ValueFactory to use for creation of the Literal

value - a TemporalAccessor value.

Returns:

a Literal with the supplied calendar value and the appropriate XSD date/time datatype for the specific value.

Throws:

NullPointerException - if any of the input parameters is null..

IllegalArgumentException - if value cannot be represented by an XML Schema date/time datatype

literal

public static Literal literal(Object object)

Creates a new typed Literal out of the supplied object, mapping the runtime type of the object to the appropriate XSD datatype. If no mapping is available, the method returns a literal with the string representation of the supplied object as the value, and XSD.STRING as the datatype.

Recognized types are Boolean, Byte, Double, Float, Integer, Long, Short, XMLGregorianCalendar , TemporalAccessor and Date.

Parameters:

object - an object to be converted to a typed literal.

Returns:

a typed literal representation of the supplied object.

Throws:

NullPointerException - if the input parameter is null..

literal

public static Literal literal(Object object,
 boolean failOnUnknownType)

Creates a new typed Literal out of the supplied object, mapping the runtime type of the object to the appropriate XSD datatype.

Recognized types are Boolean, Byte, Double, Float, BigDecimal, Integer, BigInteger, Long, Short, XMLGregorianCalendar, TemporalAccessor,

invalid reference

TemporalAmpount

and Date.

Parameters:

object - an object to be converted to a typed literal.

failOnUnknownType - If no mapping is available and failOnUnknownType is false the method returns a literal with the string representation of the supplied object as the value, and XSD.STRING as the datatype. If set to true the method throws an IllegalArgumentException if no mapping available.

Returns:

a typed literal representation of the supplied object.

Throws:

NullPointerException - if the input parameter is null..

literal

public static Literal literal(ValueFactory vf,
 Object object,
 boolean failOnUnknownType)

Creates a new typed Literal out of the supplied object, mapping the runtime type of the object to the appropriate XSD datatype.

Recognized types are Boolean, Byte, Double, Float, Integer, Long, Short, XMLGregorianCalendar, TemporalAccessor and Date.

Parameters:

object - an object to be converted to a typed literal.

failOnUnknownType - If no mapping is available and failOnUnknownType is false the method returns a literal with the string representation of the supplied object as the value, and XSD.STRING as the datatype. If set to true the method throws an IllegalArgumentException if no mapping available.

valueFactory - the ValueFactoryto use for creation of the Literal

Returns:

a typed literal representation of the supplied object.

Throws:

NullPointerException - if any of the input parameters is null.

IllegalArgumentException - if failOnUnknownType is set to true and the runtime type of the supplied object could not be mapped.

triple

public static Triple triple(Resource subject,
 IRI predicate,
 Value object)

Creates a new RDF-star embedded triple with the supplied subject, predicate, and object.

Parameters:

subject - the Triple subject

predicate - the Triple predicate

object - the Triple object

Returns:

a Triple with the supplied subject, predicate, and object.

Throws:

NullPointerException - if any of the supplied input parameters is null.

triple

public static Triple triple(ValueFactory vf,
 Resource subject,
 IRI predicate,
 Value object)

Creates a new RDF-star embedded triple with the supplied subject, predicate, and object.

Parameters:

vf - the ValueFactory to use for creation of the Triple

subject - the Triple subject

predicate - the Triple predicate

object - the Triple object

Returns:

a Triple with the supplied subject, predicate, and object.

Throws:

NullPointerException - if any of the supplied input parameters is null.

triple

public static Triple triple(Statement statement)

Creates a new RDF-star embedded triple using the subject, predicate and object from the supplied Statement.

Parameters:

statement - the Statement from which to construct a Triple

Returns:

a Triple with the same subject, predicate, and object as the supplied Statement.

Throws:

NullPointerException - if statement is null.

triple

public static Triple triple(ValueFactory vf,
 Statement statement)

Creates a new RDF-star embedded triple using the subject, predicate and object from the supplied Statement.

Parameters:

vf - the ValueFactory to use for creation of the Triple

statement - the Statement from which to construct a Triple

Returns:

a Triple with the same subject, predicate, and object as the supplied Statement.

Throws:

NullPointerException - if any of the supplied input parameters is null.

namespace

public static Namespace namespace(String prefix,
 String name)

Create a new Namespace object.

Parameters:

prefix - the prefix associated with the namespace

name - the namespace name (typically an IRI) for the namespace.

Returns:

a Namespace object.

Since:

3.6.0

getValueFactory

public static ValueFactory getValueFactory()

Get a ValueFactory.

Returns:

a ValueFactory.

createLiteralFromObject

private static Literal createLiteralFromObject(ValueFactory valueFactory,
 Object object,
 boolean throwExceptionOnFailure)
                                        throws IllegalArgumentException

Creates a typed Literal out of the supplied object, mapping the runtime type of the object to the appropriate XML Schema type. If no mapping is available, the method throws an exception if the boolean parameter is true, or if it is false it returns a literal with the string representation of the supplied object as the value, and XSD.STRING as the datatype. Recognized types are Boolean, Byte, Double, Float, Integer, Long, Short, XMLGregorianCalendar , and Date.

Parameters:

valueFactory - The ValueFactory to use when creating the result.

object - an object to be converted to a typed literal.

throwExceptionOnFailure - If true throws a LiteralUtilException when the object is not recognised. If false it returns a string typed literal based on the objects toString method.

Returns:

a typed literal representation of the supplied object.

Throws:

IllegalArgumentException - If the literal could not be created.

NullPointerException - If the object was null.