public interface BrokerProcessorDistributorAssignmentSession extends OsidSession
This session provides methods to re-assign BrokerProcessor
to Distributor
mappings. A BrokerProcessor
may appear in multiple Distributor
objects and
removing the last reference to a BrokerProcessor
is the
equivalent of deleting it. Each Distributor
may have its
own authorizations governing who is allowed to operate on it.
Adding a reference of a BrokerProcessor
to another
Distributor
is not a copy operation (eg: does not change
its Id
).
Modifier and Type | Method and Description |
---|---|
void |
assignBrokerProcessorToDistributor(Id brokerProcessorId,
Id distributorId)
Adds an existing
BrokerProcessor to a
Distributor. |
boolean |
canAssignBrokerProcessors()
Tests if this user can alter broker processor/distributor mappings.
|
boolean |
canAssignBrokerProcessorsToDistributor(Id distributorId)
Tests if this user can alter broker processor/distributor mappings.
|
IdList |
getAssignableDistributorIds(Id distributorId)
Gets a list of distributors including and under the given distributor
node in which any broker processor can be assigned.
|
IdList |
getAssignableDistributorIdsForBrokerProcessor(Id distributorId,
Id brokerProcessorId)
Gets a list of distributors including and under the given distributor
node in which a specific broker processor can be assigned.
|
void |
unassignBrokerProcessorFromDistributor(Id brokerProcessorId,
Id distributorId)
Removes a
BrokerProcessor from a Distributor. |
getAuthenticatedAgent, getAuthenticatedAgentId, getClockRate, getDate, getEffectiveAgent, getEffectiveAgentId, getFormatType, getLocale, isAuthenticated, startTransaction, supportsTransactions
close
boolean canAssignBrokerProcessors()
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. boolean canAssignBrokerProcessorsToDistributor(Id distributorId)
PERMISSION_DENIED.
This is intended as
a hint to an application that may opt not to offer lookup operations
to unauthorized users.distributorId
- the Id
of the Distributor
false
if mapping is not authorized, true
otherwiseNullArgumentException
- distributorId
is
null
mandatory
- This method must be implemented. IdList getAssignableDistributorIds(Id distributorId) throws OperationFailedException
distributorId
- the Id
of the Distributor
Ids
NullArgumentException
- distributorId
is
null
OperationFailedException
- unable to complete requestmandatory
- This method must be implemented. IdList getAssignableDistributorIdsForBrokerProcessor(Id distributorId, Id brokerProcessorId) throws OperationFailedException
distributorId
- the Id
of the Distributor
brokerProcessorId
- the Id
of the
BrokerProcessor
Ids
NullArgumentException
- distributorId
or
brokerProcessorId
is null
OperationFailedException
- unable to complete requestmandatory
- This method must be implemented. void assignBrokerProcessorToDistributor(Id brokerProcessorId, Id distributorId) throws AlreadyExistsException, NotFoundException, OperationFailedException, PermissionDeniedException
BrokerProcessor
to a
Distributor.
brokerProcessorId
- the Id
of the
BrokerProcessor
distributorId
- the Id
of the Distributor
AlreadyExistsException
- brokerProcessorId
is already assigned to distributorId
NotFoundException
- brokerProcessorId
or
distributorId
not foundNullArgumentException
- brokerProcessorId
or distributorId
is null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. void unassignBrokerProcessorFromDistributor(Id brokerProcessorId, Id distributorId) throws NotFoundException, OperationFailedException, PermissionDeniedException
BrokerProcessor
from a Distributor.
brokerProcessorId
- the Id
of the
BrokerProcessor
distributorId
- the Id
of the Distributor
NotFoundException
- brokerProcessorId
or
distributorId
not found
brokerProcessorId
not assigned to distributorId
NullArgumentException
- brokerProcessorId
or distributorId
is null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented.