public interface NegotiationACC
Modifier and Type | Method and Description |
---|---|
java.util.List<Role> |
listPlayableRoles()
Request the list of the roles playable by the requesting agent, according
to RBAC configuration (as installed in the TuCSoN node who released this
ACC) and to the requesting agent class.
|
boolean |
login(java.lang.String username,
java.lang.String password)
Attempts to perform login, so as to receive the associated agent class,
according to RBAC configuration (as installed in the TuCSoN node who
released this ACC).
|
EnhancedACC |
playDefaultRole()
Requests to play the default role according to RBAC configuration (as
installed in the TuCSoN node who released this ACC) and to the requesting
agent class.
|
EnhancedACC |
playRole(java.lang.String roleName)
Requests to play the given role according to RBAC configuration (as
installed in the TuCSoN node who released this ACC) and to the requesting
agent class.
|
EnhancedACC |
playRole(java.lang.String roleName,
java.lang.Long timeout)
Requests to play the given role according to RBAC configuration (as
installed in the TuCSoN node who released this ACC) and to the requesting
agent class, waiting
timeout milliseconds at most for operation
completion. |
EnhancedACC |
playRoleWithPermissions(java.util.List<java.lang.String> permNames)
Requests to play a role given a set of desired permissions, according to
RBAC configuration (as installed in the TuCSoN node who released this
ACC) and to the requesting agent class.
|
EnhancedACC |
playRoleWithPermissions(java.util.List<java.lang.String> permNames,
java.lang.Long timeout)
Requests to play a role given a set of desired permissions, according to
RBAC configuration (as installed in the TuCSoN node who released this
ACC) and to the requesting agent class, waiting
timeout
milliseconds at most for operation completion. |
java.util.List<Role> listPlayableRoles() throws TucsonOperationNotPossibleException, UnreachableNodeException, OperationTimeOutException
TucsonOperationNotPossibleException
- if the requested TuCSoN operation cannot be performedUnreachableNodeException
- if the TuCSoN node target of this operation is not
network-reachableOperationTimeOutException
- if the operation timeout expired prior to operation
completionboolean login(java.lang.String username, java.lang.String password) throws TucsonOperationNotPossibleException, UnreachableNodeException, OperationTimeOutException
username
- the username of the agentpassword
- the password of the agenttrue
or false
depending on login success/failureTucsonOperationNotPossibleException
- if the requested TuCSoN operation cannot be performedUnreachableNodeException
- if the TuCSoN node target of this operation is not
network-reachableOperationTimeOutException
- if the operation timeout expired prior to operation
completionEnhancedACC playDefaultRole() throws TucsonOperationNotPossibleException, UnreachableNodeException, OperationTimeOutException, TucsonInvalidAgentIdException
TucsonOperationNotPossibleException
- if the requested TuCSoN operation cannot be performedUnreachableNodeException
- if the TuCSoN node target of this operation is not
network-reachableOperationTimeOutException
- if the operation timeout expired prior to operation
completionTucsonInvalidAgentIdException
- if the requesting agent ID is not a valid TuCSoN agent IDEnhancedACC playRole(java.lang.String roleName) throws TucsonOperationNotPossibleException, UnreachableNodeException, OperationTimeOutException, TucsonInvalidAgentIdException, AgentNotAllowedException
roleName
- the name of the role to playTucsonOperationNotPossibleException
- if the requested TuCSoN operation cannot be performedUnreachableNodeException
- if the TuCSoN node target of this operation is not
network-reachableOperationTimeOutException
- if the operation timeout expired prior to operation
completionTucsonInvalidAgentIdException
- if the requesting agent ID is not a valid TuCSoN agent IDAgentNotAllowedException
- if the requesting agent is not allowed to request this TuCSoN
operationEnhancedACC playRole(java.lang.String roleName, java.lang.Long timeout) throws TucsonOperationNotPossibleException, UnreachableNodeException, OperationTimeOutException, TucsonInvalidAgentIdException, AgentNotAllowedException
timeout
milliseconds at most for operation
completion.roleName
- the name of the role to playtimeout
- the maximum waiting time in millisecondsTucsonOperationNotPossibleException
- if the requested TuCSoN operation cannot be performedUnreachableNodeException
- if the TuCSoN node target of this operation is not
network-reachableOperationTimeOutException
- if the operation timeout expired prior to operation
completionTucsonInvalidAgentIdException
- if the requesting agent ID is not a valid TuCSoN agent IDAgentNotAllowedException
- if the requesting agent is not allowed to request this TuCSoN
operationEnhancedACC playRoleWithPermissions(java.util.List<java.lang.String> permNames) throws TucsonOperationNotPossibleException, UnreachableNodeException, OperationTimeOutException, TucsonInvalidAgentIdException, AgentNotAllowedException
permNames
- the set of desired permission namesTucsonOperationNotPossibleException
- if the requested TuCSoN operation cannot be performedUnreachableNodeException
- if the TuCSoN node target of this operation is not
network-reachableOperationTimeOutException
- if the operation timeout expired prior to operation
completionTucsonInvalidAgentIdException
- if the requesting agent ID is not a valid TuCSoN agent IDAgentNotAllowedException
- if the requesting agent is not allowed to request this TuCSoN
operationEnhancedACC playRoleWithPermissions(java.util.List<java.lang.String> permNames, java.lang.Long timeout) throws TucsonOperationNotPossibleException, UnreachableNodeException, OperationTimeOutException, TucsonInvalidAgentIdException, AgentNotAllowedException
timeout
milliseconds at most for operation completion.permNames
- the set of desired permission namestimeout
- the maximum waiting time in millisecondsTucsonOperationNotPossibleException
- if the requested TuCSoN operation cannot be performedUnreachableNodeException
- if the TuCSoN node target of this operation is not
network-reachableOperationTimeOutException
- if the operation timeout expired prior to operation
completionTucsonInvalidAgentIdException
- if the requesting agent ID is not a valid TuCSoN agent IDAgentNotAllowedException
- if the requesting agent is not allowed to request this TuCSoN
operation