Package org.eclipse.rdf4j.rio.datatypes

## Class RDFDatatypeHandler

- java.lang.Object
- - org.eclipse.rdf4j.rio.datatypes.RDFDatatypeHandler

- All Implemented Interfaces:
    `DatatypeHandler`

      public class RDFDatatypeHandler
      extends Object
      implements DatatypeHandler

  An implementation of a datatype handler that can process `RDF` built-in datatypes.
  Author:
    Peter Ansell

- - ### Field Summary

    - ### Fields inherited from interface org.eclipse.rdf4j.rio.DatatypeHandler

      `DBPEDIA, GEOSPARQL, RDFDATATYPES, VIRTUOSOGEOMETRY, XMLSCHEMA`

  - ### Constructor Summary

    Constructors
    Constructor | Description
    --- | ---
    `RDFDatatypeHandler()` | Default constructor.

  - ### Method Summary

    All Methods Instance Methods Concrete Methods
    Modifier and Type | Method | Description
    --- | --- | ---
    `String` | `getKey()` | A unique key for this datatype handler to identify it in the DatatypeHandlerRegistry.
    `boolean` | `isRecognizedDatatype​(IRI datatypeUri)` | Checks if the given datatype URI is recognized by this datatype handler.
    `Literal` | `normalizeDatatype​(String literalValue, IRI 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, IRI datatypeUri)` | Verifies that the datatype URI is valid, including a check on the structure of the literal value.

    - ### Methods inherited from class java.lang.Object

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

- - ### Constructor Detail

    - #### RDFDatatypeHandler

          public RDFDatatypeHandler()

      Default constructor.

  - ### Method Detail

    - #### isRecognizedDatatype

          public boolean isRecognizedDatatype​(IRI datatypeUri)

      Description copied from interface: `DatatypeHandler`
      Checks if the given datatype URI is recognized by this datatype handler.
      Specified by:
        `isRecognizedDatatype` in interface `DatatypeHandler`
      Parameters:
        `datatypeUri` - The datatype URI to check.
      Returns:
        True if the datatype is syntactically valid and could be used with `DatatypeHandler.verifyDatatype(String, IRI)` and `DatatypeHandler.normalizeDatatype(String, IRI, ValueFactory)`.

    - #### verifyDatatype

          public boolean verifyDatatype​(String literalValue,
                                        IRI datatypeUri)
                                 throws LiteralUtilException

      Description copied from interface: `DatatypeHandler`
      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 `DatatypeHandler.isRecognizedDatatype(IRI)` returns true for the given datatype URI.

      Specified by:
        `verifyDatatype` in interface `DatatypeHandler`
      Parameters:
        `literalValue` - Literal value matching the given datatype URI.
        `datatypeUri` - A datatype URI that matched with `DatatypeHandler.isRecognizedDatatype(IRI)`
      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.

    - #### normalizeDatatype

          public Literal normalizeDatatype​(String literalValue,
                                           IRI datatypeUri,
                                           ValueFactory valueFactory)
                                    throws LiteralUtilException

      Description copied from interface: `DatatypeHandler`
      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 `DatatypeHandler.isRecognizedDatatype(IRI)` returns true for the given datatype URI, and `DatatypeHandler.verifyDatatype(String, IRI)` also returns true for the given datatype URI and literal value.

      Specified by:
        `normalizeDatatype` in interface `DatatypeHandler`
      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.

    - #### getKey

          public String getKey()

      Description copied from interface: `DatatypeHandler`
      A unique key for this datatype handler to identify it in the DatatypeHandlerRegistry.
      Specified by:
        `getKey` in interface `DatatypeHandler`
      Returns:
        A unique string key.