org.osid.resource

Interface ResourceAgentAssignmentSession

All Superinterfaces:

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

public interface ResourceAgentAssignmentSession
extends OsidSession

This session provides methods to re-assign Resource to Agents. A Resource may be associated with multiple Agents. An Agent may map to only one Resource.

Method Summary

Methods

Modifier and Type	Method and Description
void	assignAgentToResource(Id agentId, Id resourceId) Adds an existing Agent to a Resource.
boolean	canAssignAgents() Tests if this user can alter resource/agent mappings.
boolean	canAssignAgentsToResource(Id resourceId) Tests if this user can alter resource/agent mappings.
Bin	getBin() Gets the Bin associated with this session.
Id	getBinId() Gets the Bin Id associated with this session.
void	unassignAgentFromResource(Id agentId, Id resourceId) Removes an Agent from a Resource.

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

getBinId

Id getBinId()

Gets the Bin Id associated with this session.

Returns:

the Bin Id associated with this session

Compliance:

mandatory - This method must be implemented.

getBin

Bin getBin()
           throws OperationFailedException,
                  PermissionDeniedException

Gets the Bin associated with this session.

Returns:

the Bin associated with this session

Throws:

OperationFailedException - unable to complete request

PermissionDeniedException - authorization failure

Compliance:

mandatory - This method must be implemented.

canAssignAgents

boolean canAssignAgents()

Tests if this user can alter resource/agent 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 assignment operations to unauthorized users.

Returns:

false if mapping is not authorized, true otherwise

Compliance:

mandatory - This method must be implemented.

canAssignAgentsToResource

boolean canAssignAgentsToResource(Id resourceId)

Tests if this user can alter resource/agent mappings. A return of true does not guarantee successful authorization. A return of false indicates that it is known location 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 assignment operations to unauthorized users.

Parameters:

resourceId - the Id of the Resource

Returns:

false if mapping is not authorized, true otherwise

Throws:

NullArgumentException - resourceId is null

Compliance:

mandatory - This method must be implemented.

assignAgentToResource

void assignAgentToResource(Id agentId,
                         Id resourceId)
                           throws AlreadyExistsException,
                                  NotFoundException,
                                  OperationFailedException,
                                  PermissionDeniedException

Adds an existing Agent to a Resource.

Parameters:

agentId - the Id of the Agent

resourceId - the Id of the Resource

Throws:

AlreadyExistsException - agentId is already assigned to resourceId

NotFoundException - agentId or resourceId not found

NullArgumentException - agentId or resourceId is null

OperationFailedException - unable to complete request

PermissionDeniedException - authorization failure

Compliance:

mandatory - This method must be implemented.

unassignAgentFromResource

void unassignAgentFromResource(Id agentId,
                             Id resourceId)
                               throws NotFoundException,
                                      OperationFailedException,
                                      PermissionDeniedException

Removes an Agent from a Resource.

Parameters:

agentId - the Id of the Agent

resourceId - the Id of the Resource

Throws:

NotFoundException - agentId or resourceId not found or agentId not assigned to resourceId

NullArgumentException - agentId or resourceId is null

OperationFailedException - unable to complete request

PermissionDeniedException - authorization failure

Compliance:

mandatory - This method must be implemented.