OSID Logo
OSID Specifications
rules package
Version 3.0.0
Release Candidate Preview
Interfaceosid.rules.EngineQuery
Implementsosid.OsidCatalogQuery
Description

This is the query for searching for engines. Each method specifies an AND term while multiple invocations of the same method produce a nested OR.

MethodmatchRuleId
Description

Sets the rule Id for this query to match rules assigned to engines.

Parametersosid.id.IdruleIda rule Id
booleanmatch true for a positive match, false for a negative match
ErrorsNULL_ARGUMENT ruleId is null
CompliancemandatoryThis method must be implemented.
MethodclearRuleIdTerms
Description

Clears the rule Id query terms.

CompliancemandatoryThis method must be implemented.
MethodsupportsRuleQuery
Description

Tests if a rule query is available.

Returnboolean true if a rule query is available, false otherwise
CompliancemandatoryThis method must be implemented.
MethodgetRuleQuery
Description

Gets the query for a rule.

Returnosid.rules.RuleQuerythe rule query
ErrorsUNIMPLEMENTED supportsRuleQuery() is false
ComplianceoptionalThis method must be implemented if supportsRuleQuery() is true.
MethodmatchAnyRule
Description

Matches engines with any riule.

Parametersbooleanmatch true to match engines with any rule,, false to match engines with no rules
CompliancemandatoryThis method must be implemented.
MethodclearRuleTerms
Description

Clears the rule query terms.

CompliancemandatoryThis method must be implemented.
MethodmatchAncestorEngineId
Description

Sets the engine Id for this query to match engines that have the specified engine as an ancestor.

Parametersosid.id.IdengineIdan engine Id
booleanmatch true for a positive match, false for a negative match
ErrorsNULL_ARGUMENT engineId is null
CompliancemandatoryThis method must be implemented.
MethodclearAncestorEngineIdTerms
Description

Clears the ancestor engine Id query terms.

CompliancemandatoryThis method must be implemented.
MethodsupportsAncestorEngineQuery
Description

Tests if an EngineQuery is available.

Returnboolean true if an engine query is available, false otherwise
CompliancemandatoryThis method must be implemented.
MethodgetAncestorEngineQuery
Description

Gets the query for an engine. Multiple retrievals produce a nested OR term.

Returnosid.rules.EngineQuerythe engine query
ErrorsUNIMPLEMENTED supportsAncestorEngineQuery() is false
ComplianceoptionalThis method must be implemented if supportsAncestorEngineQuery() is true.
MethodmatchAnyAncestorEngine
Description

Matches engines with any ancestor.

Parametersbooleanmatch true to match engine with any ancestor, false to match root engines
CompliancemandatoryThis method must be implemented.
MethodclearAncestorEngineTerms
Description

Clears the ancestor engine query terms.

CompliancemandatoryThis method must be implemented.
MethodmatchDescendantEngineId
Description

Sets the engine Id for this query to match engines that have the specified engine as a descendant.

Parametersosid.id.IdengineIdan engine Id
booleanmatch true for a positive match, false for a negative match
ErrorsNULL_ARGUMENT engineId is null
CompliancemandatoryThis method must be implemented.
MethodclearDescendantEngineIdTerms
Description

Clears the descendant engine Id query terms.

CompliancemandatoryThis method must be implemented.
MethodsupportsDescendantEngineQuery
Description

Tests if an EngineQuery is available.

Returnboolean true if an engine query is available, false otherwise
CompliancemandatoryThis method must be implemented.
MethodgetDescendantEngineQuery
Description

Gets the query for an engine. Multiple retrievals produce a nested OR term.

Returnosid.rules.EngineQuerythe engine query
ErrorsUNIMPLEMENTED supportsDescendantEngineQuery() is false
ComplianceoptionalThis method must be implemented if supportsDescendantEngineQuery() is true.
MethodmatchAnyDescendantEngine
Description

Matches engines with any descendant.

Parametersbooleanmatch true to match engine with any descendant, false to match leaf engines
CompliancemandatoryThis method must be implemented.
MethodclearDescendantEngineTerms
Description

Clears the descendant engine query terms.

CompliancemandatoryThis method must be implemented.
MethodgetEngineQueryRecord
Description

Gets the engine query record corresponding to the given Engine record Type. Multiple record retrievals produce a nested boolean OR term.

Parametersosid.type.TypeengineRecordTypean engine record type
Returnosid.rules.records.EngineQueryRecordthe engine query record
ErrorsNULL_ARGUMENT engineRecordType is null
OPERATION_FAILEDunable to complete request
UNSUPPORTED hasRecordType(engineRecordType) is false
CompliancemandatoryThis method must be implemented.