- Direct Known Subclasses:
SelectorImpl
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.
-
Constructor Summary
ConstructorsConstructorDescriptionDeprecated.Create a selector.SimpleSelector
(Resource subject, Property predicate, boolean object) Deprecated.Create a selector.SimpleSelector
(Resource subject, Property predicate, char object) Deprecated.Create a selector.SimpleSelector
(Resource subject, Property predicate, double object) Deprecated.Create a selector.SimpleSelector
(Resource subject, Property predicate, float object) Deprecated.Create a selector.SimpleSelector
(Resource subject, Property predicate, long object) Deprecated.Create a selector.SimpleSelector
(Resource subject, Property predicate, Object object) Deprecated.Create a selector.SimpleSelector
(Resource subject, Property predicate, String object) Deprecated.Create a selector.SimpleSelector
(Resource subject, Property predicate, String object, String language) Deprecated.Create a selector.SimpleSelector
(Resource subject, Property predicate, RDFNode object) Deprecated.Create a selector. -
Method Summary
Modifier and TypeMethodDescriptionDeprecated.Return the object constraint of this selector.Deprecated.Return the predicate constraint of this selector.Deprecated.Return the subject constraint of this selector.boolean
isSimple()
Deprecated.Answer true iff this Selector is completely characterised by its S/P/O triple.boolean
Deprecated.This method is designed to be over ridden by subclasses to define application specific constraints on the statements selected.boolean
Deprecated.Test whether a statement should be included in a selection.
-
Constructor Details
-
SimpleSelector
public SimpleSelector()Deprecated.Create a selector. Since no subject, predicate or object constraints are specified a model will test all statements. -
SimpleSelector
Deprecated.Create a selector. A model may restrict statements that are tested using theselects
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 statements must equal this argument.predicate
- if not null, the predicate of selected statements must equal this argument.object
- if not null, the object of selected statements must equal this argument.
-
SimpleSelector
Deprecated.Create a selector. A model may restrict statements that are tested using theselects
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 statements must equal this argument.predicate
- if not null, the predicate of selected statements must equal this argument.object
- if not null, the object of selected statements must equal this argument.
-
SimpleSelector
Deprecated.Create a selector. A model may restrict statements that are tested using theselects
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 statements must equal this argument.predicate
- if not null, the predicate of selected statements must equal this argument.object
- the object of selected statements must equal this argument.
-
SimpleSelector
Deprecated.Create a selector. A model may restrict statements that are tested using theselects
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 statements must equal this argument.predicate
- if not null, the predicate of selected statements must equal this argument.object
- the object of selected statements must equal this argument.
-
SimpleSelector
Deprecated.Create a selector. A model may restrict statements that are tested using theselects
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 statements must equal this argument.predicate
- if not null, the predicate of selected statements must equal this argument.object
- the object of selected statements must equal this argument.
-
SimpleSelector
Deprecated.Create a selector. A model may restrict statements that are tested using theselects
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 statements must equal this argument.predicate
- if not null, the predicate of selected statements must equal this argument.object
- the object of selected statements must equal this argument.
-
SimpleSelector
Deprecated.Create a selector. A model may restrict statements that are tested using theselects
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 statements must equal this argument.predicate
- if not null, the predicate of selected statements must equal this argument.object
- the object of selected statements must equal this argument - a null string matches the empty string
-
SimpleSelector
Deprecated.Create a selector. A model may restrict statements that are tested using theselects
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 statements must equal this argument.predicate
- if not null, the predicate of selected statements must equal this argument.object
- the object of selected statements must equal this argument - the null string matches the empty stringlanguage
- the language of the object constraint
-
SimpleSelector
Deprecated.Create a selector. A model may restrict statements that are tested using theselects
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 statements must equal this argument.predicate
- if not null, the predicate of selected statements must equal this argument.object
- if not null, the object of selected statements must equal this argument.
-
-
Method Details
-
getSubject
Deprecated.Return the subject constraint of this selector.- Specified by:
getSubject
in interfaceSelector
- Returns:
- the subject constraint
-
getPredicate
Deprecated.Return the predicate constraint of this selector.- Specified by:
getPredicate
in interfaceSelector
- Returns:
- the predicate constraint
-
getObject
Deprecated.Return the object constraint of this selector. -
isSimple
public boolean isSimple()Deprecated.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). -
test
Deprecated.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 providedselects
method. -
selects
Deprecated.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- Returns:
- true if the statement satisfies the constraint
-
Predicate<Statement>