org.apache.marmotta.ldpath.api.backend

Interface NodeBackend<Node>

All Known Subinterfaces:

RDFBackend<Node>

All Known Implementing Classes:

AbstractBackend, AbstractSesameBackend, ContextAwareSesameConnectionBackend, FileBackend, GenericJenaBackend, LDCacheBackend, LMFBackend, SesameConnectionBackend, SesameRepositoryBackend, SesameValueBackend, ThreadingSesameBackend

public interface NodeBackend<Node>

Value centered Backend for LDPath, conatins all methods required for parsing and serializing a LDPath-Program

Method Summary

Methods

Modifier and Type	Method and Description
Boolean	booleanValue(Node node) Return the boolean value of a literal node.
Node	createLiteral(String content) Create a literal node with the content passed as argument
Node	createLiteral(String content, Locale language, URI type) Create a literal node with the content passed as argument
Node	createURI(String uri) Create a URI mode with the URI passed as argument
Date	dateTimeValue(Node node) TODO
Date	dateValue(Node node) TODO
BigDecimal	decimalValue(Node node) Return the decimal number of a literal node.
Double	doubleValue(Node node) Return the double value of a literal node.
Float	floatValue(Node node) Return the float value of a literal node.
Locale	getLiteralLanguage(Node n) Return the language of the literal node passed as argument.
URI	getLiteralType(Node n) Return the URI of the type of the literal node passed as argument.
BigInteger	integerValue(Node node) Return the arbitrary length integer value of a literal node.
Integer	intValue(Node node) Return the 32bit integer value of a literal node.
boolean	isBlank(Node n) Test whether the node passed as argument is a blank node
boolean	isLiteral(Node n) Test whether the node passed as argument is a literal
boolean	isURI(Node n) Test whether the node passed as argument is a URI
Long	longValue(Node node) Return the long value of a literal node.
String	stringValue(Node node) Return the lexial representation of a node.
Date	timeValue(Node node) TODO

Method Detail

isLiteral

boolean isLiteral(Node n)

Test whether the node passed as argument is a literal

Parameters:

n - the node to check

Returns:

true if the node is a literal

isURI

boolean isURI(Node n)

Test whether the node passed as argument is a URI

Parameters:

n - the node to check

Returns:

true if the node is a URI

isBlank

boolean isBlank(Node n)

Test whether the node passed as argument is a blank node

Parameters:

n - the node to check

Returns:

true if the node is a blank node

getLiteralLanguage

Locale getLiteralLanguage(Node n)

Return the language of the literal node passed as argument.

Parameters:

n - the literal node for which to return the language

Returns:

a Locale representing the language of the literal, or null if the literal node has no language

Throws:

IllegalArgumentException - in case the node is no literal

getLiteralType

URI getLiteralType(Node n)

Return the URI of the type of the literal node passed as argument.

Parameters:

n - the literal node for which to return the typer

Returns:

a URI representing the type of the literal content, or null if the literal is untyped

Throws:

IllegalArgumentException - in case the node is no literal

createLiteral

Node createLiteral(String content)

Create a literal node with the content passed as argument

Parameters:

content - string content to represent inside the literal

Returns:

a literal node in using the model used by this backend

createLiteral

Node createLiteral(String content,
                 Locale language,
                 URI type)

Create a literal node with the content passed as argument

Parameters:

content - string content to represent inside the literal

Returns:

a literal node in using the model used by this backend

createURI

Node createURI(String uri)

Create a URI mode with the URI passed as argument

Parameters:

uri - URI of the resource to create

Returns:

a URI node using the model used by this backend

stringValue

String stringValue(Node node)

Return the lexial representation of a node. For a literal, this will be the content, for a URI node it will be the URI itself, and for a blank node it will be the identifier of the node.

Parameters:

node -

Returns:

doubleValue

Double doubleValue(Node node)

Return the double value of a literal node. Depending on the backend implementing this method, the value can be retrieved directly or must be parsed from the string representation. The method can throw a NumberFormatException or ArithmeticException indicating that the value cannot be represented as double, and an IllegalArgumentException, indicating that the passed node is not a literal

Parameters:

node - the literal node for which to return the double value

Returns:

double value of the literal node

Throws:

NumberFormatException - in case the literal cannot be represented as double value

ArithmeticException - in case the literal cannot be represented as double value

IllegalArgumentException - in case the node passed as argument is not a literal

longValue

Long longValue(Node node)

Return the long value of a literal node. Depending on the backend implementing this method, the value can be retrieved directly or must be parsed from the string representation. The method can throw a NumberFormatException or ArithmeticException indicating that the value cannot be represented as long, and an IllegalArgumentException, indicating that the passed node is not a literal

Parameters:

node - the literal node for which to return the long value

Returns:

long value of the literal node

Throws:

NumberFormatException - in case the literal cannot be represented as long value

ArithmeticException - in case the literal cannot be represented as long value

IllegalArgumentException - in case the node passed as argument is not a literal

booleanValue

Boolean booleanValue(Node node)

Return the boolean value of a literal node. Depending on the backend implementing this method, the value can be retrieved directly or must be parsed from the string representation. TODO: Define:

• Do we also support '0' '1', 'yes', 'no'; whats about case insensitive such as TRUE, False
• should we throw an RuntimeException of not an boolean value or return false as Boolean.parseBoolean(String)

Parameters:

node - the literal node for which to return the boolean value

Returns:

long value of the literal node

Throws:

IllegalArgumentException - in case the node passed as argument is not a literal

dateTimeValue

Date dateTimeValue(Node node)

TODO

Parameters:

node - the literal node for which to return the dateTime value

Returns:

long value of the literal node

Throws:

IllegalArgumentException - in case the node passed as argument is not a literal

dateValue

Date dateValue(Node node)

TODO

Parameters:

node - the literal node for which to return the date value

Returns:

long value of the literal node

Throws:

IllegalArgumentException - in case the node passed as argument is not a literal

timeValue

Date timeValue(Node node)

TODO

Parameters:

node - the literal node for which to return the time value

Returns:

long value of the literal node

Throws:

IllegalArgumentException - in case the node passed as argument is not a literal

floatValue

Float floatValue(Node node)

Return the float value of a literal node. Depending on the backend implementing this method, the value can be retrieved directly or must be parsed from the string representation. The method can throw a NumberFormatException or ArithmeticException indicating that the value cannot be represented as float, and an IllegalArgumentException, indicating that the passed node is not a literal

Parameters:

node - the literal node for which to return the float value

Returns:

long value of the literal node

Throws:

NumberFormatException - in case the literal cannot be represented as float value

ArithmeticException - in case the literal cannot be represented as float value

IllegalArgumentException - in case the node passed as argument is not a literal

intValue

Integer intValue(Node node)

Return the 32bit integer value of a literal node. Depending on the backend implementing this method, the value can be retrieved directly or must be parsed from the string representation. The method can throw a NumberFormatException or ArithmeticException indicating that the value cannot be represented as integer, and an IllegalArgumentException, indicating that the passed node is not a literal.

Note that this is restricted to 32bit singed integer values as defined by xsd:int and Integer. For bigger nuber one might want to use xsd:integer represented by BigInteger.

Parameters:

node - the literal node for which to return the Integer (xsd:int) value

Returns:

long value of the literal node

Throws:

NumberFormatException - in case the literal cannot be represented as 32 bit integer value

ArithmeticException - in case the literal cannot be represented as 32 bit integer value

IllegalArgumentException - in case the node passed as argument is not a literal

integerValue

BigInteger integerValue(Node node)

Return the arbitrary length integer value of a literal node. Depending on the backend implementing this method, the value can be retrieved directly or must be parsed from the string representation. The method can throw a NumberFormatException or ArithmeticException indicating that the value cannot be represented as integer, and an IllegalArgumentException, indicating that the passed node is not a literal.

Parameters:

node - the literal node for which to return the xsd:integer value

Returns:

long value of the literal node

Throws:

NumberFormatException - in case the literal cannot be represented as integer value

ArithmeticException - in case the literal cannot be represented as long value

IllegalArgumentException - in case the node passed as argument is integer a literal

decimalValue

BigDecimal decimalValue(Node node)

Return the decimal number of a literal node. Depending on the backend implementing this method, the value can be retrieved directly or must be parsed from the string representation. The method can throw a NumberFormatException or ArithmeticException indicating that the value cannot be represented as decimal, and an IllegalArgumentException, indicating that the passed node is not a literal.

Parameters:

node - the literal node for which to return the xsd:decimal value

Returns:

long value of the literal node

Throws:

NumberFormatException - in case the literal cannot be represented as decimal value

ArithmeticException - in case the literal cannot be represented as decimal value

IllegalArgumentException - in case the node passed as argument is not a literal