org.osid.ontology.rules

Interface RelevancyEnablerRuleApplicationSession

All Superinterfaces:

java.lang.AutoCloseable, java.io.Closeable, OsidSession

public interface RelevancyEnablerRuleApplicationSession
extends OsidSession

This session provides methods to apply RelevancyEnablers to Relevancies. A Relevancy with multiple RelevancyEnablers means any positive rule evaluation across the enablers result in an effective Relevancy.

Method Summary

Methods

Modifier and Type	Method and Description
void	assignRelevancyEnablerToRelevancy(Id relevancyEnablerId, Id relevancyId) Adds an existing RelevancyEnabler to a Relevancy.
boolean	canAssignRelevancyEnablers() Tests if this user can alter relevancy enabler/relevancy mappings.
boolean	canSequenceRelevancyEnablers() Tests if this user can order RelevancyEnablers.
Ontology	getOntology() Gets the Ontology associated with this session.
Id	getOntologyId() Gets the Ontology Id associated with this session.
void	moveRelevancyEnablerAhead(Id relevancyEnablerId, Id relevancyId, Id referenceId) Reorders relevancy enablers for a relevancy by moving the specified relevancy enabler in front of a reference relevancy enabler.
void	moveRelevancyEnablerBehind(Id relevancyEnablerId, Id relevancyId, Id referenceId) Reorders relevancy enablers for a relevancy by moving the specified relevancy enabler behind a reference relevancy enabler.
void	orderRelevancyEnablers(Id[] relevancyEnablerIds, Id relevancyId) Reorders a set of relevancy enablers for a relevancy.
void	unassignRelevancyEnablerFromRelevancy(Id relevancyEnablerId, Id relevancyId) Removes a RelevancyEnabler from a Relevancy.

Methods inherited from interface org.osid.OsidSession

getAuthenticatedAgent, getAuthenticatedAgentId, getClockRate, getDate, getEffectiveAgent, getEffectiveAgentId, getFormatType, getLocale, isAuthenticated, startTransaction, supportsTransactions

Methods inherited from interface org.osid.binding.java.OsidSession

close

Methods inherited from interface java.io.Closeable

close

Method Detail

getOntologyId

Id getOntologyId()

Gets the Ontology Id associated with this session.

Returns:

the Ontology Id associated with this session

Compliance:

mandatory - This method must be implemented.

getOntology

Ontology getOntology()
                     throws OperationFailedException,
                            PermissionDeniedException

Gets the Ontology associated with this session.

Returns:

the ontology

Throws:

OperationFailedException - unable to complete request

PermissionDeniedException - authorization failure

Compliance:

mandatory - This method must be implemented.

canAssignRelevancyEnablers

boolean canAssignRelevancyEnablers()

Tests if this user can alter relevancy enabler/relevancy mappings. A return of true does not guarantee successful authorization. A return of false indicates that it is known mapping methods in this session will result in a PERMISSION_DENIED. This is intended as a hint to an application that may opt not to offer lookup operations to unauthorized users.

Returns:

false if mapping is not authorized, true otherwise

Compliance:

mandatory - This method must be implemented.

assignRelevancyEnablerToRelevancy

void assignRelevancyEnablerToRelevancy(Id relevancyEnablerId,
                                     Id relevancyId)
                                       throws AlreadyExistsException,
                                              NotFoundException,
                                              OperationFailedException,
                                              PermissionDeniedException

Adds an existing RelevancyEnabler to a Relevancy.

Parameters:

relevancyEnablerId - the Id of the RelevancyEnabler

relevancyId - the Id of the Relevancy

Throws:

AlreadyExistsException - relevancyEnablerId is already applied to relevancyId

NotFoundException - relevancyEnablerId or relevancyId not found

NullArgumentException - relevancyEnablerId or relevancyId is null

OperationFailedException - unable to complete request

PermissionDeniedException - authorization failure

Compliance:

mandatory - This method must be implemented.

unassignRelevancyEnablerFromRelevancy

void unassignRelevancyEnablerFromRelevancy(Id relevancyEnablerId,
                                         Id relevancyId)
                                           throws NotFoundException,
                                                  OperationFailedException,
                                                  PermissionDeniedException

Removes a RelevancyEnabler from a Relevancy.

Parameters:

relevancyEnablerId - the Id of the RelevancyEnabler

relevancyId - the Id of the Relevancy

Throws:

NotFoundException - relevancyEnablerId or relevancyId not found or relevancyEnablerId not applied to relevancyId

NullArgumentException - relevancyEnablerId or relevancyId is null

OperationFailedException - unable to complete request

PermissionDeniedException - authorization failure

Compliance:

mandatory - This method must be implemented.

canSequenceRelevancyEnablers

boolean canSequenceRelevancyEnablers()

Tests if this user can order RelevancyEnablers. A return of true does not guarantee successful authorization. A return of false indicates that it is known sequencing operations will result in a PERMISSION_DENIED. This is intended as a hint to an application that may opt not to offer sequencing operations to an unauthorized user.

Returns:

false if RelevancyEnabler ordering is not authorized, true otherwise

Compliance:

mandatory - This method must be implemented.

moveRelevancyEnablerAhead

void moveRelevancyEnablerAhead(Id relevancyEnablerId,
                             Id relevancyId,
                             Id referenceId)
                               throws NotFoundException,
                                      OperationFailedException,
                                      PermissionDeniedException

Reorders relevancy enablers for a relevancy by moving the specified relevancy enabler in front of a reference relevancy enabler.

Parameters:

relevancyEnablerId - the Id of a RelevancyEnabler

relevancyId - the Id of a Relevancy

referenceId - the reference relevancy enabler Id

Throws:

NotFoundException - relevancyEnablerId, relevancyId, or referenceId not found or, relevancyEnablerId or referenceId not related to relevancyId

NullArgumentException - relevancyEnablerId, relevancyId, or referenceId is null

OperationFailedException - unable to complete request

PermissionDeniedException - authorization failure

Compliance:

mandatory - This method must be implemented.

moveRelevancyEnablerBehind

void moveRelevancyEnablerBehind(Id relevancyEnablerId,
                              Id relevancyId,
                              Id referenceId)
                                throws NotFoundException,
                                       OperationFailedException,
                                       PermissionDeniedException

Reorders relevancy enablers for a relevancy by moving the specified relevancy enabler behind a reference relevancy enabler.

Parameters:

relevancyEnablerId - the Id of a RelevancyEnabler

relevancyId - the Id of a Relevancy

referenceId - the reference relevancy enabler Id

Throws:

NotFoundException - relevancyEnablerId, relevancyId, or referenceId not found or, relevancyEnablerId or referenceId not related to relevancyId

NullArgumentException - relevancyEnablerId, relevancyId, or referenceId is null

OperationFailedException - unable to complete request

PermissionDeniedException - authorization failure

Compliance:

mandatory - This method must be implemented.

orderRelevancyEnablers

void orderRelevancyEnablers(Id[] relevancyEnablerIds,
                          Id relevancyId)
                            throws NotFoundException,
                                   OperationFailedException,
                                   PermissionDeniedException

Reorders a set of relevancy enablers for a relevancy.

Parameters:

relevancyEnablerIds - the Ids for a set of RelevancyEnablers

relevancyId - the Id of a Relevancy

Throws:

NotFoundException - relevancyId not found or, a relevancyEnablerId not related to relevancyId

NullArgumentException - relevancyEnablerIds or relevancyId is null

OperationFailedException - unable to complete request

PermissionDeniedException - authorization failure

Compliance:

mandatory - This method must be implemented.