org.jrdf.graph
Interface TripleFactory

All Known Implementing Classes:

AbstractTripleFactory

public interface TripleFactory

A Triple Factory is a class which defines the creation of certain sets of triples. This includes reification, containers and collections.

Version:

$Revision: 1.1 $

Author:

Andrew Newman

Method Summary

void	addAlternative(SubjectNode subjectNode, Alternative alternative) Inserts a alternative using the given subject.
void	addBag(SubjectNode subjectNode, Bag bag) Inserts a bag using the given subject.
void	addCollection(SubjectNode firstNode, Collection collection) Inserts a collection using the given subject.
void	addSequence(SubjectNode subjectNode, Sequence sequence) Inserts a sequence using the given subject.
void	reifyTriple(SubjectNode subjectNode, PredicateNode predicateNode, ObjectNode objectNode, SubjectNode reificationNode) Reifies a triple.
void	reifyTriple(Triple triple, SubjectNode reificationNode) Reifies a triple.

Method Detail

reifyTriple

public void reifyTriple(SubjectNode subjectNode,
                        PredicateNode predicateNode,
                        ObjectNode objectNode,
                        SubjectNode reificationNode)
                 throws TripleFactoryException,
                        AlreadyReifiedException

Reifies a triple. A triple made up of the first three nodes is added to graph and the reificationNode is used to reify the triple.

Parameters:

subjectNode - the subject of the triple.

predicateNode - the predicate of the triple.

objectNode - the object of the triple.

reificationNode - a node denoting the reified triple.

Throws:

TripleFactoryException - If the resource failed to be added.

AlreadyReifiedException - If there was already a triple URI for the given triple.

reifyTriple

public void reifyTriple(Triple triple,
                        SubjectNode reificationNode)
                 throws TripleFactoryException,
                        AlreadyReifiedException

Reifies a triple. The triple added to the graph and the reificationNode is used to reify the triple.

Parameters:

triple - the triple to be reified.

reificationNode - a node denoting the reified triple.

Throws:

TripleFactoryException - If the resource failed to be added.

AlreadyReifiedException - If there was already a triple URI for the given triple.

addAlternative

public void addAlternative(SubjectNode subjectNode,
                           Alternative alternative)
                    throws TripleFactoryException

Inserts a alternative using the given subject. The subject is also the object of a proceeding statement that identifies the container.

Parameters:

subjectNode - the subject node of the triple.

alternative - the alternative to add.

Throws:

TripleFactoryException - If the resources were failed to be added.

addBag

public void addBag(SubjectNode subjectNode,
                   Bag bag)
            throws TripleFactoryException

Inserts a bag using the given subject. The subject is also the object of a proceeding statement that identifies the container.

Parameters:

subjectNode - the subject node of the triple.

bag - the bag to add.

Throws:

TripleFactoryException - If the resources were failed to be added.

addSequence

public void addSequence(SubjectNode subjectNode,
                        Sequence sequence)
                 throws TripleFactoryException

Inserts a sequence using the given subject. The subject is also the object of a proceeding statement that identifies the container.

Parameters:

subjectNode - the subject node of the triple.

sequence - the sequence to add.

Throws:

TripleFactoryException - If the resources were failed to be added.

addCollection

public void addCollection(SubjectNode firstNode,
                          Collection collection)
                   throws TripleFactoryException

Inserts a collection using the given subject. The subject is also the object of a proceeding statement that identifies the collection.

Parameters:

firstNode - the subject node of the triple.

collection - the collection to add.

Throws:

TripleFactoryException - If the resources were failed to be added.