| java.lang.Object
 com.hp.hpl.jena.rdf.model.SimpleSelector
All known Subclasses: com.hp.hpl.jena.rdf.model.impl.SelectorImpl,
| SimpleSelector | | public class SimpleSelector extends Object implements Selector(Code) | | 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.
author:
bwm
version:
Release='$Name: $ $Revision: 1.16 $ $Date: 2008/01/02 12:05:46 $ |
| Constructor Summary | |
| public | SimpleSelector()
Create a selector. | | public | SimpleSelector(Resource subject, Property predicate, RDFNode object)
Create a selector. | | public | SimpleSelector(Resource subject, Property predicate, boolean object)
Create a selector. | | public | SimpleSelector(Resource subject, Property predicate, long object)
Create a selector. | | public | SimpleSelector(Resource subject, Property predicate, char object)
Create a selector. | | public | SimpleSelector(Resource subject, Property predicate, float object)
Create a selector. | | public | SimpleSelector(Resource subject, Property predicate, double object)
Create a selector. | | public | SimpleSelector(Resource subject, Property predicate, String object)
Create a selector. | | public | SimpleSelector(Resource subject, Property predicate, String object, String language)
Create a selector. | | public | SimpleSelector(Resource subject, Property predicate, Object object)
Create a selector. |
| Method Summary | |
| public RDFNode | getObject()
Return the object constraint of this selector. | | public Property | getPredicate()
Return the predicate constraint of this selector. | | public Resource | getSubject()
Return the subject constraint of this selector. | | public boolean | isSimple()
Answer true iff this Selector is completely characterised by its
S/P/O triple. | | public boolean | selects(Statement s)
This method is designed to be over ridden by subclasses to define application
specific constraints on the statements selected. | | public boolean | test(Statement s)
Test whether a statement should be included in a selection. |
| SimpleSelector | | public SimpleSelector()(Code) | | 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)(Code) | | 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.
Parameters:
subject - if not null, the subject of selected statementsmust equal this argument.
Parameters:
predicate - if not null, the predicate of selected statementsmust equal this argument.
Parameters:
object - if not null, the object of selected statementsmust equal this argument. |
| SimpleSelector | | public SimpleSelector(Resource subject, Property predicate, boolean object)(Code) | | 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.
Parameters:
subject - if not null, the subject of selected statementsmust equal this argument.
Parameters:
predicate - if not null, the predicate of selected statementsmust equal this argument.
Parameters:
object - if not null, the object of selected statementsmust equal this argument. |
| SimpleSelector | | public SimpleSelector(Resource subject, Property predicate, long object)(Code) | | 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.
Parameters:
subject - if not null, the subject of selected statementsmust equal this argument.
Parameters:
predicate - if not null, the predicate of selected statementsmust equal this argument.
Parameters:
object - the object of selected statementsmust equal this argument. |
| SimpleSelector | | public SimpleSelector(Resource subject, Property predicate, char object)(Code) | | 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.
Parameters:
subject - if not null, the subject of selected statementsmust equal this argument.
Parameters:
predicate - if not null, the predicate of selected statementsmust equal this argument.
Parameters:
object - the object of selected statementsmust equal this argument. |
| SimpleSelector | | public SimpleSelector(Resource subject, Property predicate, float object)(Code) | | 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.
Parameters:
subject - if not null, the subject of selected statementsmust equal this argument.
Parameters:
predicate - if not null, the predicate of selected statementsmust equal this argument.
Parameters:
object - the object of selected statementsmust equal this argument. |
| SimpleSelector | | public SimpleSelector(Resource subject, Property predicate, double object)(Code) | | 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.
Parameters:
subject - if not null, the subject of selected statementsmust equal this argument.
Parameters:
predicate - if not null, the predicate of selected statementsmust equal this argument.
Parameters:
object - the object of selected statementsmust equal this argument. |
| SimpleSelector | | public SimpleSelector(Resource subject, Property predicate, String object)(Code) | | 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.
Parameters:
subject - if not null, the subject of selected statementsmust equal this argument.
Parameters:
predicate - if not null, the predicate of selected statementsmust equal this argument.
Parameters:
object - the object of selected statementsmust equal this argument - a null string matches the empty string |
| SimpleSelector | | public SimpleSelector(Resource subject, Property predicate, String object, String language)(Code) | | 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.
Parameters:
subject - if not null, the subject of selected statementsmust equal this argument.
Parameters:
predicate - if not null, the predicate of selected statementsmust equal this argument.
Parameters:
object - the object of selected statementsmust equal this argument - the null string matches the empty string
Parameters:
language - the language of the object constraint |
| SimpleSelector | | public SimpleSelector(Resource subject, Property predicate, Object object)(Code) | | 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.
Parameters:
subject - if not null, the subject of selected statementsmust equal this argument.
Parameters:
predicate - if not null, the predicate of selected statementsmust equal this argument.
Parameters:
object - if not null, the object of selected statementsmust equal this argument. |
| getObject | | public RDFNode getObject()(Code) | | Return the object constraint of this selector.
the object constraint |
| getPredicate | | public Property getPredicate()(Code) | | Return the predicate constraint of this selector.
the predicate constraint |
| getSubject | | public Resource getSubject()(Code) | | Return the subject constraint of this selector.
the subject constraint |
| isSimple | | public boolean isSimple()(Code) | | 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).
true iff this selector only depends on S/P/O identity. |
| selects | | public boolean selects(Statement s)(Code) | | This method is designed to be over ridden by subclasses to define application
specific constraints on the statements selected.
Parameters:
s - the statement to be tested true if the statement satisfies the constraint |
| test | | public boolean test(Statement s)(Code) | | 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.
Parameters:
s - the statement to be tested true if the statement satisfies the subject, objectand predicate constraints and the selects constraint. |
|
|