org.openrdf.rio

Interface DatatypeHandler

All Known Implementing Classes:

DBPediaDatatypeHandler, GeoSPARQLDatatypeHandler, RDFDatatypeHandler, VirtuosoGeometryDatatypeHandler, XMLSchemaDatatypeHandler

public interface DatatypeHandler

An interface defining methods related to verification and normalization of typed literals and datatype URIs.

Since:

2.7.0

Author:

Peter Ansell

Field Summary

Fields

Modifier and Type	Field and Description
static String	DBPEDIA Identifier for datatypes defined by DBPedia.
static String	GEOSPARQL Identifier for datatypes defined in the GeoSPARQL vocabulary.
static String	RDFDATATYPES Identifier for datatypes defined in the RDF vocabulary.
static String	VIRTUOSOGEOMETRY Identifier for datatypes defined in the Virtuoso Geometry vocabulary.
static String	XMLSCHEMA Identifier for datatypes defined in the XMLSchema vocabulary.

Method Summary

Modifier and Type	Method and Description
String	getKey() A unique key for this datatype handler to identify it in the DatatypeHandlerRegistry.
boolean	isRecognizedDatatype(URI datatypeUri) Checks if the given datatype URI is recognized by this datatype handler.
Literal	normalizeDatatype(String literalValue, URI datatypeUri, ValueFactory valueFactory) Normalize both the datatype URI and the literal value if appropriate, and use the given value factory to generate a literal matching a literal value and datatype URI.
boolean	verifyDatatype(String literalValue, URI datatypeUri) Verifies that the datatype URI is valid, including a check on the structure of the literal value.

Field Detail

XMLSCHEMA

static final String XMLSCHEMA

Identifier for datatypes defined in the XMLSchema vocabulary.

Since:

2.7.0

See Also:

Constant Field Values

RDFDATATYPES

static final String RDFDATATYPES

Identifier for datatypes defined in the RDF vocabulary.

Since:

2.7.0

See Also:

Constant Field Values

DBPEDIA

static final String DBPEDIA

Identifier for datatypes defined by DBPedia.

Since:

2.7.1

See Also:

DBPedia Datatypes, Constant Field Values

VIRTUOSOGEOMETRY

static final String VIRTUOSOGEOMETRY

Identifier for datatypes defined in the Virtuoso Geometry vocabulary.

Since:

2.7.1

See Also:

Virtuoso Geospatial, Constant Field Values

GEOSPARQL

static final String GEOSPARQL

Identifier for datatypes defined in the GeoSPARQL vocabulary.

Since:

2.7.4

See Also:

GeoSPARQL, Constant Field Values

Method Detail

isRecognizedDatatype

boolean isRecognizedDatatype(URI datatypeUri)

Checks if the given datatype URI is recognized by this datatype handler.

Parameters:

datatypeUri - The datatype URI to check.

Returns:

True if the datatype is syntactically valid and could be used with verifyDatatype(String, URI) and normalizeDatatype(String, URI, ValueFactory).

Since:

2.7.0

verifyDatatype

boolean verifyDatatype(String literalValue,
                       URI datatypeUri)
                throws LiteralUtilException

Verifies that the datatype URI is valid, including a check on the structure of the literal value.

This method must only be called after verifying that isRecognizedDatatype(URI) returns true for the given datatype URI.

Parameters:

literalValue - Literal value matching the given datatype URI.

datatypeUri - A datatype URI that matched with isRecognizedDatatype(URI)

Returns:

True if the datatype URI is recognized by this datatype handler, and it is verified to be syntactically valid.

Throws:

LiteralUtilException - If the datatype was not recognized.

Since:

2.7.0

normalizeDatatype

Literal normalizeDatatype(String literalValue,
                          URI datatypeUri,
                          ValueFactory valueFactory)
                   throws LiteralUtilException

Normalize both the datatype URI and the literal value if appropriate, and use the given value factory to generate a literal matching a literal value and datatype URI.

This method must only be called after verifying that isRecognizedDatatype(URI) returns true for the given datatype URI, and verifyDatatype(String, URI) also returns true for the given datatype URI and literal value.

Parameters:

literalValue - Required literal value to use in the normalization process and to provide the value for the resulting literal.

datatypeUri - The datatype URI which is to be normalized. This URI is available in normalized form from the result using Literal.getDatatype().

valueFactory - The ValueFactory to use to create the result literal.

Returns:

A Literal containing the normalized literal value and datatype URI.

Throws:

LiteralUtilException - If the datatype URI was not recognized or verified, or the literal value could not be normalized due to an error.

Since:

2.7.0

getKey

String getKey()

A unique key for this datatype handler to identify it in the DatatypeHandlerRegistry.

Returns:

A unique string key.

Since:

2.7.0