com.franz.ag
Interface Node

All Superinterfaces:

java.lang.Comparable, Resource, ResourceNode, java.io.Serializable, URI, Value, ValueNode, ValueObject

public interface Node
extends ResourceNode, URI

This interface defines an instance of a labelled resource node in AllegroGraph.

The AllegroGraph object defines two slots, id and uri. Both slots are copied to the Java instance.

The URI member may be a lazy value in the Java instance. If queryURI returns null, getURI() will need a round-trip to the triple store to fetch the actual value.

Node instances are created by calls to AllegroGraph methods.

Method Summary

void	add() Add this node to the AllegroGraph triple store.
boolean	equals(java.lang.Object other) Implement equality for Node instances.
UPI	getAGId() Retrieve the AllegroGraph ID number of the Node.
java.lang.String	getLocalName() Retrieve the local name component of the URI string associated with the node instance.
java.lang.String	getNamespace() Retrieve the namespace component of the URI string associated with the node instance.
StatementIterator	getPredicateStatements() Gets all statements from the RDF graph for which this URI is the predicate.
java.lang.String	getURI() Returns the String-representation of this URI.
int	hashCode() Compute the hashcode of a Node instance.
java.lang.String	queryURI() Retrieve the URI string associated with the node instance.
java.lang.String	toString() Retrieve the URI string associated with the node instance.

Methods inherited from interface com.franz.ag.ResourceNode

addProperty, getSubjectStatements

Methods inherited from interface com.franz.ag.ValueNode

compareTo, getObjectStatements, queryAGId

Methods inherited from interface org.openrdf.model.Resource

addProperty, getSubjectStatements

Method Detail

getAGId

UPI getAGId()
            throws AllegroGraphException

Retrieve the AllegroGraph ID number of the Node.

Returns:

the ID number

If the Node is already registered in the AG triple store, return the locally cached value of the ID number. Otherwise, register the Node in the AG triple store and return the new ID number.

Throws:

AllegroGraphException

queryURI

java.lang.String queryURI()

Retrieve the URI string associated with the node instance.

Returns:

A string or null. If the returned value is null, the actual value must be obtained by calling getURI().

getLocalName

java.lang.String getLocalName()

Retrieve the local name component of the URI string associated with the node instance.

Specified by:

getLocalName in interface URI

Returns:

A string. If the value is not in the Java cache, retrieve it from the triple store.

getNamespace

java.lang.String getNamespace()

Retrieve the namespace component of the URI string associated with the node instance.

Specified by:

getNamespace in interface URI

Returns:

A string or null if the URI does not have a namespace component. If the value is not in the Java cache, retrieve it from the triple store.

toString

java.lang.String toString()

Retrieve the URI string associated with the node instance.

Overrides:

toString in class java.lang.Object

Returns:

A string. If the value is not in the Java cache, retrieve it from the triple store.

Defined in interface org.openrdf.model.URI

equals

boolean equals(java.lang.Object other)

Implement equality for Node instances.

Two Node instances are equal if both are registered in the AllegroGraph triple store and they have identical AllegroGraph part id numbers.

Otherwise, the string representations are compared.

Overrides:

equals in class java.lang.Object

hashCode

int hashCode()

Compute the hashcode of a Node instance.

The hashcode of a Node instance is the hashcode of its string representation.

Overrides:

hashCode in class java.lang.Object

getPredicateStatements

StatementIterator getPredicateStatements()
                                         throws GraphException

Description copied from interface: URI

Gets all statements from the RDF graph for which this URI is the predicate.

Specified by:

getPredicateStatements in interface URI

Throws:

GraphException

getURI

java.lang.String getURI()

Description copied from interface: URI

Returns the String-representation of this URI. The String-representation consists of the concatenation of the namespace and the local name.

Specified by:

getURI in interface URI

Returns:

The String-representation of this URI.

add

void add()
         throws AllegroGraphException

Add this node to the AllegroGraph triple store. If the node already is in the triple store, do nothing.

A Node instance is in the triple store if queryAGId() returns a non-null value.

Throws:

AllegroGraphException