org.ontoware.rdfreactor.runtime

Class ReactorBaseImpl

java.lang.Object

org.ontoware.rdfreactor.runtime.ReactorBaseImpl

All Implemented Interfaces:

ReactorBase, ResourceEntity

public class ReactorBaseImpl
extends Object
implements ReactorBase

ReactorBaseImpl is the base class for instances of classes from the RDFS/OWL schema generated by the code generator.
If a class inheriting from ReactorBaseImpl is instantiated, it represents an instance of a class from an RDFS/OWL schema. The properties of this class instance are stored in an RDF model using RDF2Go (via the static Bridge object) as triples of the form: (this.instanceIdentifier, key, value).
Besides methods for putting, getting and removing properties, the Map Interface is also supported for handling of all properties of this instance in one Map, backed by the actual RDF2Go model.
RDF Reactor uses the following naming: resource - instance of an RDF schema class, identified by the resource ID (an URI or BlankNode), almost all statements about the resource use the resource ID as the object property - a property belongs to a resource, represented by the predicate of a statement about a resource value - value of a property of a resource, represented by the object of the statement with the property as predicate and the resource ID as the subject

Version:

$Id: ReactorBaseImpl.java,v 1.24 2006/12/05 19:47:28 xamde Exp $

Author:

$Author: xamde $

Field Summary

Fields

Modifier and Type	Field and Description
protected URI	classURI the URI of the RDFS class from which this object is an instance
protected Model	model the underlying RDF2Go model in which the triples representing the properties of this object are saved

Constructor Summary

Constructors

Constructor and Description
ReactorBaseImpl(Model model, URI classURI, Resource instanceIdentifier) Constructor: create a ReactorBaseImpl for the RDFS/OWL schema class identified by classURI, with instanceIdentifier as the identifing URL or BlankNode.
ReactorBaseImpl(Model model, URI classURI, Resource instanceIdentifier, boolean write) Constructor: create a ReactorBaseImpl for the RDFS/OWL schema class identified by classURI, with instanceIdentifier as the identifing URL or BlankNode.

Method Summary

Modifier and Type	Method and Description
boolean	add(URI property, Object object) Adds a statement (this, prop, o).
boolean	add(URI property, Object object, int maxCard) Adds a statement (this, prop, o) if the number of statements matching (this, prop, x) is less then maxCard
Object	castTo(Class<?> targetType) Cast .this object to the given target Java type.
void	delete() Delete all statements of the form (this, *,*)
boolean	equals(Object other) implement
Object	get(URI prop, Class<?> returnType) Returns the first x in (this, prop, x) if such a statement is in the model.
Set<Object>	getAll_AsSet(URI prop, Class<?> returnType) Get all values for the given property of this resource instance as a Set.
Object[]	getAll_Inverse(URI property, Node o, Class<?> returnType) Get all resources having the given property and value.
Object[]	getAll(URI prop, Class<?> returnType) Returns an array of x with (this, prop, x) if such statements are in the model.
static Object[]	getAllInstances(Model model, Class<?> javaClass) Return all instances of the given class.
static Iterator<?>	getAllInstancesAsIterator(Model model, Class javaClass, URI classURI) Return all instances of the given class as a SubjectResultIterator object.
static Object	getInstance(Model model, URI uri, Class<?> javaClass)
Model	getModel()
URI	getRDFSClassURI()
Resource	getResource() implements
int	hashCode() implement
static boolean	hasInstance(Model model, URI uri, URI classURI)
boolean	hasValue(URI prop)
boolean	hasValue(URI prop, Object value)
boolean	in(Model model)
boolean	isInstanceof(Class<?> javaClass) Deprecated.
boolean	isInstanceof(URI classURI) Check if .this object is an instance of the given RDFS/OWL class URI.
boolean	remove(URI prop, Object o) Tries to remove a statement (this, prop, o).
boolean	remove(URI prop, Object o, int minCard) Tries to remove a statement (this, prop, o) if the number of statements matching (this, prop, x) in the model is less then minCard
boolean	removeAll(URI prop) remove all (this, rdf:type, prop) statements
void	set(URI prop, Object o) Removes all statements (this, prop, x) and set one anew: (this, prop, o).
void	setAll(URI prop, Object[] o) Removes all statements (this, prop, x) and sets anew: (this, prop, o[0]), (this, prop, o[1]), ...
void	setAll(URI prop, Object[] o, int maxCard) Removes all statements (this, prop, x) and sets anew: (this, prop, o[0]), (this, prop, o[1]), ...
String	toString() implement
boolean	update(URI prop, Object oldValue, Object newValue) Looks for a statement (this, prop, oldValue) and replaces it by a new statement (this, prop, newValue).

Methods inherited from class java.lang.Object

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

Field Detail

model

protected Model model

the underlying RDF2Go model in which the triples representing the properties of this object are saved

classURI

protected URI classURI

the URI of the RDFS class from which this object is an instance

Constructor Detail

ReactorBaseImpl

public ReactorBaseImpl(Model model,
                       URI classURI,
                       Resource instanceIdentifier,
                       boolean write)

Constructor: create a ReactorBaseImpl for the RDFS/OWL schema class identified by classURI, with instanceIdentifier as the identifing URL or BlankNode.

Parameters:

model, - the underlying RDF2Go model

classURI, - URI of the RDFS/OWL class from which this object is an instance

instanceIdentifier, - has to be an URI or URL or BlankNode

write - if true, the triple (this, rdf:type, classURI) is written to the model (in addition to any other triples denoting properties of the instance)

ReactorBaseImpl

public ReactorBaseImpl(Model model,
                       URI classURI,
                       Resource instanceIdentifier)

Constructor: create a ReactorBaseImpl for the RDFS/OWL schema class identified by classURI, with instanceIdentifier as the identifing URL or BlankNode. Dont write (this, rdf:type, classURI) for this instance to the model.

Parameters:

model, - the underlying RDF2Go model

classURI, - URI of the RDFS/OWL class from which this object is an instance

instanceIdentifier, - has to be an URI or URL or BlankNode

Method Detail

getResource

public Resource getResource()

implements

Specified by:

getResource in interface ResourceEntity

Returns:

the RDF resource as an RDF2GO resource

See Also:

ReactorEntity

getRDFSClassURI

public URI getRDFSClassURI()

Specified by:

getRDFSClassURI in interface ReactorBase

Returns:

the URI of the RDFS schema class of which this object is an instance

equals

public boolean equals(Object other)

implement

Overrides:

equals in class Object

See Also:

methods

hashCode

public int hashCode()

implement

Overrides:

hashCode in class Object

See Also:

methods

toString

public String toString()

implement

Overrides:

toString in class Object

Returns:

a string representation of the instance identifier (URI or blank node). Representations are dependant on the used RDF2Go adaptor.

See Also:

methods

hasInstance

public static boolean hasInstance(Model model,
                                  URI uri,
                                  URI classURI)

getInstance

public static Object getInstance(Model model,
                                 URI uri,
                                 Class<?> javaClass)
                          throws Exception

Throws:

Exception

getAllInstancesAsIterator

public static Iterator<?> getAllInstancesAsIterator(Model model,
                                                    Class javaClass,
                                                    URI classURI)

Return all instances of the given class as a SubjectResultIterator object.

Parameters:

model - - underlying RDF2Go model

javaClass - - the java class representing the class the instances which should be returned

classURI - - URI of the (RDFS/OWL) class. currently not used

Returns:

SubjectResultIterator over the resulting instances

getAllInstances

public static Object[] getAllInstances(Model model,
                                       Class<?> javaClass)

Return all instances of the given class.

Parameters:

model - - underlying RDF2Go model

javaClass - - the java class representing the class the instances which should be returned

Returns:

array of all instances of the given java class in the model

isInstanceof

public boolean isInstanceof(URI classURI)
                     throws ModelRuntimeException

Check if .this object is an instance of the given RDFS/OWL class URI.

Specified by:

isInstanceof in interface ReactorBase

Parameters:

classURI - - URI of the RDFS/OWL class

Returns:

true if .this is an instance of the given classURI

Throws:

ModelRuntimeException

isInstanceof

@Deprecated
public boolean isInstanceof(Class<?> javaClass)
                                 throws ModelRuntimeException

Deprecated.

Check if .this object is an instance of the given Java class.

Specified by:

isInstanceof in interface ReactorBase

Parameters:

javaClass - - given Java class

Returns:

true if .this is an instance of the given Java Class in the model

Throws:

ModelRuntimeException

castTo

public Object castTo(Class<?> targetType)

Cast .this object to the given target Java type.

Specified by:

castTo in interface ReactorBase

Parameters:

targetType - - Java type to which to cast this object

Returns:

converted object

get

public Object get(URI prop,
                  Class<?> returnType)
           throws RDFDataException

Returns the first x in (this, prop, x) if such a statement is in the model. Null otherwise. If there are several x the first is returned (depending on the underlying RDF store). This method is useful for functional properties.

Specified by:

get in interface ReactorBase

Parameters:

prop - - URI of the property

returnType - - desired Java return type

Returns:

null or object typed as returnType

Throws:

RDFDataException

getAll

public Object[] getAll(URI prop,
                       Class<?> returnType)

Returns an array of x with (this, prop, x) if such statements are in the model. Null otherwise.

Specified by:

getAll in interface ReactorBase

Parameters:

prop - - URI of the property

returnType - - desired Java return type

Returns:

all values, array can be empty, never null

getAll_Inverse

public Object[] getAll_Inverse(URI property,
                               Node o,
                               Class<?> returnType)

Get all resources having the given property and value. Return x matching (x, property, o).

Parameters:

property - - URI of the property

o - - value of the property

returnType - - desired Java return type

Returns:

array of desired returnType representing the found resources

getAll_AsSet

public Set<Object> getAll_AsSet(URI prop,
                                Class<?> returnType)

Get all values for the given property of this resource instance as a Set.

Parameters:

prop - - URI of the property

returnType - - desired Java return type

Returns:

Set of all values for the given property

set

public void set(URI prop,
                Object o)

Removes all statements (this, prop, x) and set one anew: (this, prop, o).

Specified by:

set in interface ReactorBase

Parameters:

prop - - URI of the property

o - - new value for the property

setAll

public void setAll(URI prop,
                   Object[] o)
            throws ModelRuntimeException

Removes all statements (this, prop, x) and sets anew: (this, prop, o[0]), (this, prop, o[1]), ...

Specified by:

setAll in interface ReactorBase

Parameters:

prop - - URI of the property

o - - array of new values for the property

Throws:

ModelRuntimeException

setAll

public void setAll(URI prop,
                   Object[] o,
                   int maxCard)
            throws ModelRuntimeException,
                   CardinalityException

Removes all statements (this, prop, x) and sets anew: (this, prop, o[0]), (this, prop, o[1]), ... But only if the number of objects in o[] is less than or equal to maxCard.

Specified by:

setAll in interface ReactorBase

Parameters:

prop - - URI of the property

o - - array of new values of the property

maxCard - - the maximum number of triples allowed to match (this, prop, x)

Throws:

CardinalityException

CardinalityException - if the size of o[] is larger then maxCard

ModelRuntimeException

update

public boolean update(URI prop,
                      Object oldValue,
                      Object newValue)

Looks for a statement (this, prop, oldValue) and replaces it by a new statement (this, prop, newValue). If the first cannot be found, false is returned, true otherwise.

Specified by:

update in interface ReactorBase

Parameters:

prop - - URI of the property

oldValue - - old value of the property

newValue - - new value of the property

Returns:

true if old value was found

hasValue

public boolean hasValue(URI prop,
                        Object value)

Parameters:

prop -

value -

Returns:

true if the model contains the statement (this, prop, value)

hasValue

public boolean hasValue(URI prop)

Parameters:

prop -

Returns:

true if the model contains any statement (this, prop, *)

add

public boolean add(URI property,
                   Object object)

Adds a statement (this, prop, o). Returns false if this statement has already been in model. True otherwise.

Specified by:

add in interface ReactorBase

Parameters:

property - - URI of the property

object - - value of the property

Returns:

true if value was already in the model

add

public boolean add(URI property,
                   Object object,
                   int maxCard)
            throws CardinalityException

Adds a statement (this, prop, o) if the number of statements matching (this, prop, x) is less then maxCard

Specified by:

add in interface ReactorBase

Parameters:

property - - URI of the property

object - - value of the property

maxCard - - number of occurences of (this, prop, x) allowed in the model

Returns:

true if value was already preset

Throws:

CardinalityException - if the resource already has more then maxCard values for the property

remove

public boolean remove(URI prop,
                      Object o)

Tries to remove a statement (this, prop, o).

Specified by:

remove in interface ReactorBase

Parameters:

prop - - URI of the property

o - - value of the property

Returns:

true, if value was present

remove

public boolean remove(URI prop,
                      Object o,
                      int minCard)
               throws CardinalityException

Tries to remove a statement (this, prop, o) if the number of statements matching (this, prop, x) in the model is less then minCard

Specified by:

remove in interface ReactorBase

Parameters:

prop - - URI of the property

o - - value of the property

minCard - - number of occurences of (this, prop, x) needed in the model

Returns:

true if value was found

Throws:

CardinalityException - if resource has less then minCard values for the property

removeAll

public boolean removeAll(URI prop)

remove all (this, rdf:type, prop) statements

Specified by:

removeAll in interface ReactorBase

Parameters:

prop, - Object of a Triple

Returns:

true if at least on value was found and removed

getModel

public Model getModel()

Specified by:

getModel in interface ReactorBase

Returns:

the model for which this instance acts as a view

delete

public void delete()

Delete all statements of the form (this, *,*)

Specified by:

delete in interface ReactorBase

in

public boolean in(Model model)

Specified by:

in in interface ReactorBase

Parameters:

model - and RDG2GO model

Returns:

true, iff this resource is contained in any statement of the model