Overview  Package   Class  Use  Deprecated  Index
Home >> All >> com >> hp >> hpl >> jena >> rdf >> [ model overview ]	PREV CLASS  NEXT CLASS
SUMMARY:  JAVADOC |  SOURCE |  DOWNLOAD | NESTED | FIELD | CONSTR | METHOD	DETAIL: FIELD | CONSTR | METHOD

---

com.hp.hpl.jena.rdf.model
Class SimpleSelector  

java.lang.Object
  com.hp.hpl.jena.rdf.model.SimpleSelector

All Implemented Interfaces:

Selector

---

public class SimpleSelector

extends java.lang.Object

implements Selector

A general selector class for use when querying models.

An instance of this class is passed with query calls to models. The model will use the test method of this class to decide whether a statement should be included in the selection.

Instances of this class can be provided with subject, predicate and object constraints. If a subject, a predicate or an object are provided, the model implementation may restrict the statements that it tests to statements whose subject, predicate and object match those provided in the constructor. This can provide for considerably more efficient searching. However, the model implementation is not required to do this. If no subject, predicate or object are provided in the constructor, then all statements in the model must be tested.

This class is designed to be subclassed by the application, defining defining further selection criteria of its own by providing its own selects method.

A direct instance of SimpleSelector returns true for the Selector::isSimple() predicate. Instances of subclasses of SimpleSelector return false, since the only reason to have such subclasses is to provide a non-trivial test predicate or S/P/O tests other than equality.

The test method first verifies that a statement satisfies any subject, predicate or object constraints and the calls the selects method to test for any application supplied constraint. The default selects method simply returns true.

Version:

Release='$Name: $ $Revision: 1.13 $ $Date: 2005/02/21 12:14:26 $

---

Field Summary
protected  RDFNode	object
protected  Property	predicate
protected  Resource	subject

 

Constructor Summary

SimpleSelector()           Create a selector.

SimpleSelector(Resource subject, Property predicate, boolean object)           Create a selector.

SimpleSelector(Resource subject, Property predicate, char object)           Create a selector.

SimpleSelector(Resource subject, Property predicate, double object)           Create a selector.

SimpleSelector(Resource subject, Property predicate, float object)           Create a selector.

SimpleSelector(Resource subject, Property predicate, long object)           Create a selector.

SimpleSelector(Resource subject, Property predicate, java.lang.Object object)           Create a selector.

SimpleSelector(Resource subject, Property predicate, RDFNode object)           Create a selector.

SimpleSelector(Resource subject, Property predicate, java.lang.String object)           Create a selector.

SimpleSelector(Resource subject, Property predicate, java.lang.String object, java.lang.String language)           Create a selector.

 

Method Summary
RDFNode	getObject()           Return the object constraint of this selector.
Property	getPredicate()           Return the predicate constraint of this selector.
Resource	getSubject()           Return the subject constraint of this selector.
boolean	isSimple()           Answer true iff this Selector is completely characterised by its S/P/O triple.
private  Literal	literal(java.lang.String s, java.lang.String lang)
boolean	selects(Statement s)           This method is designed to be over ridden by subclasses to define application specific constraints on the statements selected.
boolean	test(Statement s)           Test whether a statement should be included in a selection.

 

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

 

Field Detail

subject

protected Resource subject

---

predicate

protected Property predicate

---

object

protected RDFNode object

Constructor Detail

SimpleSelector

public SimpleSelector()

Create a selector. Since no subject, predicate or object constraints are specified a model will test all statements.

---

SimpleSelector

public SimpleSelector(Resource subject,
                      Property predicate,
                      RDFNode object)

Create a selector. A model may restrict statements that are tested using the selects method to those whose subject matches the subject parameter, whose predicate matches the predicate parameter and whose object matches the object paramater. Any null parameter is considered to match anything.

---

SimpleSelector

public SimpleSelector(Resource subject,
                      Property predicate,
                      boolean object)

Create a selector. A model may restrict statements that are tested using the selects method to those whose subject matches the subject parameter, whose predicate matches the predicate parameter and whose object matches the object paramater. Any null parameter is considered to match anything.

---

SimpleSelector

public SimpleSelector(Resource subject,
                      Property predicate,
                      long object)

Create a selector. A model may restrict statements that are tested using the selects method to those whose subject matches the subject parameter, whose predicate matches the predicate parameter and whose object matches the object paramater. Any null parameter is considered to match anything.

---

SimpleSelector

public SimpleSelector(Resource subject,
                      Property predicate,
                      char object)

Create a selector. A model may restrict statements that are tested using the selects method to those whose subject matches the subject parameter, whose predicate matches the predicate parameter and whose object matches the object paramater. Any null parameter is considered to match anything.

---

SimpleSelector

public SimpleSelector(Resource subject,
                      Property predicate,
                      float object)

Create a selector. A model may restrict statements that are tested using the selects method to those whose subject matches the subject parameter, whose predicate matches the predicate parameter and whose object matches the object paramater. Any null parameter is considered to match anything.

---

SimpleSelector

public SimpleSelector(Resource subject,
                      Property predicate,
                      double object)

Create a selector. A model may restrict statements that are tested using the selects method to those whose subject matches the subject parameter, whose predicate matches the predicate parameter and whose object matches the object paramater. Any null parameter is considered to match anything.

---

SimpleSelector

public SimpleSelector(Resource subject,
                      Property predicate,
                      java.lang.String object)

Create a selector. A model may restrict statements that are tested using the selects method to those whose subject matches the subject parameter, whose predicate matches the predicate parameter and whose object matches the object paramater. Any null parameter is considered to match anything.

---

SimpleSelector

public SimpleSelector(Resource subject,
                      Property predicate,
                      java.lang.String object,
                      java.lang.String language)

Create a selector. A model may restrict statements that are tested using the selects method to those whose subject matches the subject parameter, whose predicate matches the predicate parameter and whose object matches the object paramater. Any null parameter is considered to match anything.

---

SimpleSelector

public SimpleSelector(Resource subject,
                      Property predicate,
                      java.lang.Object object)

Create a selector. A model may restrict statements that are tested using the selects method to those whose subject matches the subject parameter, whose predicate matches the predicate parameter and whose object matches the object paramater. Any null parameter is considered to match anything.

Method Detail

literal

private Literal literal(java.lang.String s,
                        java.lang.String lang)

---

getSubject

public Resource getSubject()

Return the subject constraint of this selector.

Specified by:

getSubject in interface Selector

---

getPredicate

public Property getPredicate()

Return the predicate constraint of this selector.

Specified by:

getPredicate in interface Selector

---

getObject

public RDFNode getObject()

Return the object constraint of this selector.

Specified by:

getObject in interface Selector

---

isSimple

public boolean isSimple()

Answer true iff this Selector is completely characterised by its S/P/O triple. Subclasses will by default return false, so this method need not be over-ridden (the only reason for subclassing SimpleSelector is to make a test not dependent only on the S/P/O identity).

Specified by:

isSimple in interface Selector

---

test

public boolean test(Statement s)

Test whether a statement should be included in a selection. This method tests whether the supplied statement satisfies the subject, predicate and object constraints of the selector and then tests whether it matches the application provided selects method.

Specified by:

test in interface Selector

---

selects

public boolean selects(Statement s)

This method is designed to be over ridden by subclasses to define application specific constraints on the statements selected.

---

Overview  Package   Class  Use  Deprecated  Index
Home >> All >> com >> hp >> hpl >> jena >> rdf >> [ model overview ]	PREV CLASS  NEXT CLASS
SUMMARY:  JAVADOC |  SOURCE |  DOWNLOAD | NESTED | FIELD | CONSTR | METHOD	DETAIL: FIELD | CONSTR | METHOD

---