org.apache.clerezza.rdf.utils

Class RdfList

java.lang.Object

java.util.AbstractCollection<E>

java.util.AbstractList<Resource>

org.apache.clerezza.rdf.utils.RdfList

All Implemented Interfaces:

Iterable<Resource>, Collection<Resource>, List<Resource>

public class RdfList
extends AbstractList<Resource>

An implementation of an java.util.List backed by an RDF collection (rdf:List). The list allows modification that are reflected to the underlying TripleCollection. It reads the data from the TripleCollection when it is first needed, so changes to the TripleCollection affecting the rdf:List may or may not have an effect on the values returned by instances of this class. For that reason only one instance of this class should be used for accessing an rdf:List of sublists thereof when the lists are being modified, having multiple lists exclusively for read operations (such as for immutable TripleCollections) is not problematic.

Author:

rbn, mir

Field Summary

Fields inherited from class java.util.AbstractList

modCount

Constructor Summary

Constructors

Constructor and Description
RdfList(GraphNode listNode) Get a list for the specified resource node.
RdfList(NonLiteral listResource, TripleCollection tc) Get a list for the specified resource.

Method Summary

Methods

Modifier and Type	Method and Description
void	add(int index, Resource element)
static RdfList	createEmptyList(NonLiteral listResource, TripleCollection tc) Creates an empty RdfList by writing a triple "listResource owl:sameAs rdf.nil ." to tc.
boolean	equals(Object obj)
static Set<GraphNode>	findContainingListNodes(GraphNode element) Returns a set of GraphNodeS which are the first list nodes (meaning they are not the beginning of a sublist) of the list containing the specified GraphNode as an element.
static Set<RdfList>	findContainingLists(GraphNode element) Returns the rdf lists of which the specified GraphNode is an element of.
Resource	get(int index)
NonLiteral	getListResource()
int	hashCode()
Resource	remove(int index)
int	size()

Methods inherited from class java.util.AbstractList

add, addAll, clear, indexOf, iterator, lastIndexOf, listIterator, listIterator, removeRange, set, subList

Methods inherited from class java.util.AbstractCollection

addAll, contains, containsAll, isEmpty, remove, removeAll, retainAll, toArray, toArray, toString

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.util.List

addAll, contains, containsAll, isEmpty, remove, removeAll, retainAll, toArray, toArray

Constructor Detail

RdfList

public RdfList(NonLiteral listResource,
       TripleCollection tc)

Get a list for the specified resource. If the list is modified using the created instance listResource will always be the first list.

Parameters:

listResource -

tc -

RdfList

public RdfList(GraphNode listNode)

Get a list for the specified resource node.

Parameters:

listNode -

Method Detail

createEmptyList

public static RdfList createEmptyList(NonLiteral listResource,
                      TripleCollection tc)
                               throws IllegalArgumentException

Creates an empty RdfList by writing a triple "listResource owl:sameAs rdf.nil ." to tc.

Parameters:

listResource -

tc -

Returns:

an empty rdf:List.

Throws:

IllegalArgumentException - if the provided listResource is a non-empty rdf:List.

get

public Resource get(int index)

Specified by:

get in interface List<Resource>

Specified by:

get in class AbstractList<Resource>

size

public int size()

Specified by:

size in interface Collection<Resource>

Specified by:

size in interface List<Resource>

Specified by:

size in class AbstractCollection<Resource>

add

public void add(int index,
       Resource element)

Specified by:

add in interface List<Resource>

Overrides:

add in class AbstractList<Resource>

remove

public Resource remove(int index)

Specified by:

remove in interface List<Resource>

Overrides:

remove in class AbstractList<Resource>

getListResource

public NonLiteral getListResource()

equals

public boolean equals(Object obj)

Specified by:

equals in interface Collection<Resource>

Specified by:

equals in interface List<Resource>

Overrides:

equals in class AbstractList<Resource>

hashCode

public int hashCode()

Specified by:

hashCode in interface Collection<Resource>

Specified by:

hashCode in interface List<Resource>

Overrides:

hashCode in class AbstractList<Resource>

findContainingLists

public static Set<RdfList> findContainingLists(GraphNode element)

Returns the rdf lists of which the specified GraphNode is an element of. Sublists of other lists are not returned.

Parameters:

element -

Returns:

findContainingListNodes

public static Set<GraphNode> findContainingListNodes(GraphNode element)

Returns a set of GraphNodeS which are the first list nodes (meaning they are not the beginning of a sublist) of the list containing the specified GraphNode as an element.

Parameters:

element -

Returns: