Module org.apache.jena.core

Package org.apache.jena.rdf.model.impl

Class LiteralImpl

java.lang.Object

org.apache.jena.enhanced.Polymorphic<RDFNode>

org.apache.jena.enhanced.EnhNode

org.apache.jena.rdf.model.impl.LiteralImpl

All Implemented Interfaces:

FrontsNode, Literal, RDFNode

public class LiteralImpl
extends EnhNode
implements Literal

An implementation of Literal.

Field Summary

Fields

Modifier and Type	Field	Description
static final Implementation	factory

Constructor Summary

Constructors

Constructor	Description
LiteralImpl(Node n, EnhGraph m)
LiteralImpl(Node n, ModelCom m)

Method Summary

Modifier and Type	Method	Description
Literal	asLiteral()	If this node is a Literal, answer that literal; otherwise throw an exception.
Resource	asResource()	If this node is a Resource, answer that resource; otherwise throw an exception.
boolean	getBoolean()	If the literal is interpretable as a Boolean return its value as a boolean.
byte	getByte()	If the literal is interpretable as a Byte return its value.
char	getChar()	If the literal is interpretable as a Char return its value.
RDFDatatype	getDatatype()	Return the datatype of the literal.
String	getDatatypeURI()	Return the uri of the datatype of the literal.
double	getDouble()	If the literal is interpretable as a Double return its value.
float	getFloat()	If the literal is interpretable as a Float return its value.
int	getInt()	If the literal is interpretable as a Integer return its value.
String	getLanguage()	If a language is defined for this literal return it
String	getLexicalForm()	Return the lexical form of the literal.
long	getLong()	If the literal is interpretable as a Long return its value.
Model	getModel()	Answer the model this literal was created in, if any, otherwise null.
short	getShort()	If the literal is interpretable as a Short return its value.
String	getString()	If the literal is interpretable as a string return its value.
Object	getValue()	Return the value of the literal.
Literal	inModel(Model m)	Literals are not in any particular model, and so inModel can return this.
boolean	isWellFormedXML()	Deprecated. To be removed.
boolean	sameValueAs(Literal other)	Test that two literals are semantically equivalent.
String	toString()	Answer a String representation of the node.
Object	visitWith(RDFVisitor rv)	Apply the appropriate method of the visitor to this node's content and return the result.

Methods inherited from class org.apache.jena.enhanced.EnhNode

as, asNode, canAs, equals, getGraph, hashCode, isAnon, isLiteral, isResource, isStmtResource, isURIResource, isValid, viewAs

Methods inherited from class org.apache.jena.enhanced.Polymorphic

addView, supports

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.apache.jena.graph.FrontsNode

asNode

Methods inherited from interface org.apache.jena.rdf.model.Literal

equals

Methods inherited from interface org.apache.jena.rdf.model.RDFNode

as, canAs, isAnon, isLiteral, isResource, isStmtResource, isURIResource

Field Details

factory

public static final Implementation factory

Constructor Details

LiteralImpl

public LiteralImpl(Node n,
 ModelCom m)

LiteralImpl

public LiteralImpl(Node n,
 EnhGraph m)

Method Details

visitWith

public Object visitWith(RDFVisitor rv)

Description copied from interface: RDFNode

Apply the appropriate method of the visitor to this node's content and return the result.

Specified by:

visitWith in interface RDFNode

Parameters:

rv - an RDFVisitor with a method for URI/blank/literal nodes

Returns:

the result returned by the selected method

inModel

public Literal inModel(Model m)

Literals are not in any particular model, and so inModel can return this.

Specified by:

inModel in interface Literal

Specified by:

inModel in interface RDFNode

Parameters:

m - a model to move the literal into

Returns:

this

asLiteral

public Literal asLiteral()

Description copied from interface: RDFNode

If this node is a Literal, answer that literal; otherwise throw an exception.

Specified by:

asLiteral in interface RDFNode

asResource

public Resource asResource()

Description copied from interface: RDFNode

If this node is a Resource, answer that resource; otherwise throw an exception.

Specified by:

asResource in interface RDFNode

getModel

public Model getModel()

Answer the model this literal was created in, if any, otherwise null.

Specified by:

getModel in interface RDFNode

Returns:

The model associated with this resource.

toString

public String toString()

Description copied from interface: RDFNode

Answer a String representation of the node. The form of the string depends on the type of the node and is intended for human consumption, not machine analysis.

Specified by:

toString in interface RDFNode

Overrides:

toString in class Object

getValue

public Object getValue()

Return the value of the literal. In the case of plain literals this will return the literal string. In the case of typed literals it will return a java object representing the value. In the case of typed literals representing a java primitive then the appropriate java wrapper class (Integer etc) will be returned.

Specified by:

getValue in interface Literal

getDatatype

public RDFDatatype getDatatype()

Return the datatype of the literal. This will be null in the case of plain literals.

Specified by:

getDatatype in interface Literal

getDatatypeURI

public String getDatatypeURI()

Return the uri of the datatype of the literal. This will be null in the case of plain literals.

Specified by:

getDatatypeURI in interface Literal

getLexicalForm

public String getLexicalForm()

Return the lexical form of the literal.

Specified by:

getLexicalForm in interface Literal

getBoolean

public boolean getBoolean()

Description copied from interface: Literal

If the literal is interpretable as a Boolean return its value as a boolean. Plain literals are interpreted by parsing their lexical representation, typed literals are interpreted by coercion of the java object representing their value.

Specified by:

getBoolean in interface Literal

Returns:

the literal interpreted as a boolean

getByte

public byte getByte()

Description copied from interface: Literal

If the literal is interpretable as a Byte return its value. Plain literals are interpreted by parsing their lexical representation, typed literals are interpreted by coercion of the java object representing their value.

Specified by:

getByte in interface Literal

Returns:

the literal interpreted as a byte

getShort

public short getShort()

Description copied from interface: Literal

If the literal is interpretable as a Short return its value. Plain literals are interpreted by parsing their lexical representation, typed literals are interpreted by coercion of the java object representing their value.

Specified by:

getShort in interface Literal

Returns:

the literal interpreted as a short

getInt

public int getInt()

Description copied from interface: Literal

If the literal is interpretable as a Integer return its value. Plain literals are interpreted by parsing their lexical representation, typed literals are interpreted by coercion of the java object representing their value.

Specified by:

getInt in interface Literal

Returns:

the literal interpreted as an int

getLong

public long getLong()

Description copied from interface: Literal

If the literal is interpretable as a Long return its value. Plain literals are interpreted by parsing their lexical representation, typed literals are interpreted by coercion of the java object representing their value.

Specified by:

getLong in interface Literal

Returns:

the literal interpreted as a long

getChar

public char getChar()

Description copied from interface: Literal

If the literal is interpretable as a Char return its value. Plain literals are interpreted by parsing their lexical representation, typed literals are interpreted by coercion of the java object representing their value.

Specified by:

getChar in interface Literal

Returns:

the literal interpreted as a char

getFloat

public float getFloat()

Description copied from interface: Literal

If the literal is interpretable as a Float return its value. Plain literals are interpreted by parsing their lexical representation, typed literals are interpreted by coercion of the java object representing their value.

Specified by:

getFloat in interface Literal

Returns:

the literal interpreted as a float

getDouble

public double getDouble()

Description copied from interface: Literal

If the literal is interpretable as a Double return its value. Plain literals are interpreted by parsing their lexical representation, typed literals are interpreted by coercion of the java object representing their value.

Specified by:

getDouble in interface Literal

Returns:

the literal interpreted as a double

getString

public String getString()

Description copied from interface: Literal

If the literal is interpretable as a string return its value. For typed literals this will throw an error for non string literals and one needs to use getLexicalForm to return the string form of other datatypes.

Specified by:

getString in interface Literal

Returns:

the literal string

getLanguage

public String getLanguage()

Description copied from interface: Literal

If a language is defined for this literal return it

Specified by:

getLanguage in interface Literal

Returns:

the language for this literal if it exists, or empty string if none

isWellFormedXML

@Deprecated
public boolean isWellFormedXML()

Deprecated.

To be removed. Well-formness of XML literal is not tested for.

Description copied from interface: Literal

Answer true iff this literal is (or claims to be) well-formed XML.

Specified by:

isWellFormedXML in interface Literal

sameValueAs

public boolean sameValueAs(Literal other)

Test that two literals are semantically equivalent. In some cases this may be the same as equals, in others equals is stricter. For example, two xsd:int literals with the same value but different language tag are semantically equivalent but distinguished by the java equality function in order to support round tripping.

Specified by:

sameValueAs in interface Literal