JXTA

net.jxta.access
Interface AccessService

All Superinterfaces:
Module, Service

public interface AccessService
extends Service

The Access Service is used by JXTA Applications and Services to determine if specific operations are permitted for a particular identity.

Each Access Service implementation provides a mechanism for determining if, for a given operation and identity, the operation is permitted.


Nested Class Summary
static class AccessService.AccessResult
          The result of an access check.
 
Field Summary
 
Fields inherited from interface net.jxta.platform.Module
START_AGAIN_PROGRESS, START_AGAIN_STALLED, START_DISABLED, START_OK
 
Method Summary
 AccessService.AccessResult doAccessCheck(PrivilegedOperation operation, Credential credential)
          Determine if a privileged operation is permitted for a given identity.
 PrivilegedOperation newPrivilegedOperation(Element source)
          Read a privileged operation from a portion of a structured document.
 PrivilegedOperation newPrivilegedOperation(Object subject, Credential offerer)
          Create a new privileged operation with the specified subject.
 
Methods inherited from interface net.jxta.service.Service
getImplAdvertisement, getInterface
 
Methods inherited from interface net.jxta.platform.Module
init, startApp, stopApp
 

Method Detail

doAccessCheck

AccessService.AccessResult doAccessCheck(PrivilegedOperation operation,
                                         Credential credential)
Determine if a privileged operation is permitted for a given identity.

Parameters:
operation - The operation which is being requested or null. null signifies that the operation is unimportant though the credential must be valid.
credential - The identity which is requesting or null. A null value indicates that no credential is available.
Returns:
the result of the access check.

newPrivilegedOperation

PrivilegedOperation newPrivilegedOperation(Object subject,
                                           Credential offerer)
Create a new privileged operation with the specified subject. Each operation is also associated with an identity, the offerer. Generally the privileged operation is cryptographically signed by the offerer.

Parameters:
subject - The subject of the operation. This usually identifies what operation is being requested.
offerer - The identity which is offering the operation.
Returns:
The privileged operation object
See Also:
Credential

newPrivilegedOperation

PrivilegedOperation newPrivilegedOperation(Element source)
Read a privileged operation from a portion of a structured document.

Parameters:
source - The root of the document portion containing the serialized representation of the privileged operation.
Returns:
The privileged operation object.

JXSE