org.jrdf.parser
Interface ParserBlankNodeFactory

All Known Implementing Classes:
ParserBlankNodeFactoryImpl

public interface ParserBlankNodeFactory

A factory for creating BlankNodes. One possible implementation might create BlankNodes that maintain their identity relative to the RDF file being parsed, possibly by wrapping the nodeID in the case of createBlankNode(String) or by wrapping a sequence number in the case of createBlankNode(). In that case the resulting BlankNodes would only be useful as a temporary object that is used while an RDF file is being parsed.
Another implementation might keep a map from nodeID to BlankNode so that createBlankNode(String) would always return the same BlankNode object when called with a particular nodeID.

Version:
$Revision: 1.1 $
Author:
David Makepeace

Method Summary
 void clear()
          Resets this ParserBlankNodeFactory.
 BlankNode createBlankNode()
          Creates a BlankNode that is unique relative to this instance of the ParserBlankNodeFactory.
 BlankNode createBlankNode(String nodeID)
          Creates a BlankNode that is only distinguished by the nodeID value.
 

Method Detail

createBlankNode

public BlankNode createBlankNode()
                          throws GraphElementFactoryException
Creates a BlankNode that is unique relative to this instance of the ParserBlankNodeFactory.

Returns:
the BlankNode.
Throws:
GraphElementFactoryException - if there is a failure to create the blank node.

createBlankNode

public BlankNode createBlankNode(String nodeID)
                          throws GraphElementFactoryException
Creates a BlankNode that is only distinguished by the nodeID value.

Parameters:
nodeID - the nodeID of the blank node - consistently returns the same blank node if it exists.
Returns:
the BlankNode.
Throws:
GraphElementFactoryException - if there is a failure to create the blank node.

clear

public void clear()
Resets this ParserBlankNodeFactory. Subsequent calls to createBlankNode() may return BlankNodes that compare equal to BlankNodes that were created before the call to clear().