public interface StateAssignmentSession extends OsidSession
This session provides methods to re-assign State
to
reference Ids.
A State
may be associated
with multiple reference ids.
A reference id
may map to only one State.
Modifier and Type | Method and Description |
---|---|
void |
assignReferenceToState(Id referenceId,
Id stateId)
Adds a reference
Id to a State. |
boolean |
canAssignStates()
Tests if this user can alter state/id mappings.
|
IdList |
getNextStateIds(Id referenceId,
Id processId)
Gets the valid states that can be assigned to the reference
id
in the given process. |
StateList |
getNextStates(Id referenceId,
Id processId)
Gets the valid states that can be assigned to a reference
Id
in the given process. |
void |
unassignReferenceFromState(Id referenceId,
Id stateId)
Removes a reference
Id from a State. |
getAuthenticatedAgent, getAuthenticatedAgentId, getClockRate, getDate, getEffectiveAgent, getEffectiveAgentId, getFormatType, getLocale, isAuthenticated, startTransaction, supportsTransactions
close
boolean canAssignStates()
PERMISSION_DENIED.
This is intended as a hint to an
application that may opt not to offer lookup operations to
unauthorized users. false
if mapping is not authorized, true
otherwisemandatory
- This method must be implemented. IdList getNextStateIds(Id referenceId, Id processId) throws NotFoundException, OperationFailedException, PermissionDeniedException
id
in the given process.referenceId
- a reference Id
processId
- Id
of the Process
Ids
of the next valid statesNotFoundException
- referenceId
or
processId
is not foundNullArgumentException
- referenceId
or
processId
is null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. StateList getNextStates(Id referenceId, Id processId) throws NotFoundException, OperationFailedException, PermissionDeniedException
Id
in the given process.referenceId
- a reference Id
processId
- Id
of the Process
NotFoundException
- referenceId
or
processId
is not foundNullArgumentException
- referenceId
or
processId
is null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. void assignReferenceToState(Id referenceId, Id stateId) throws AlreadyExistsException, NotFoundException, OperationFailedException, PermissionDeniedException
Id
to a State.
referenceId
- a reference Id
stateId
- the Id
of the State
AlreadyExistsException
- this Id
is
already assigned to the stateNotFoundException
- stateId
not foundNullArgumentException
- id
or
stateId
is null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. void unassignReferenceFromState(Id referenceId, Id stateId) throws NotFoundException, OperationFailedException, PermissionDeniedException
Id
from a State.
referenceId
- a reference Id
stateId
- the Id
of the State
NotFoundException
- stateId
not foundNullArgumentException
- referenceId
or
stateId
is null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented.