com.centrasite.resourceaccess.managers
Interface PermissionManager

All Superinterfaces:
ResourceManager

public interface PermissionManager
extends ResourceManager

Interface for managing permissions. It can perform creation, deletion and searching of permissions.


Method Summary
 CentraSitePermission createPermission()
          Create a new instance of non-system level CentraSitePermission.
 CentraSitePermission createPermission(boolean systemLevel)
          Create a new instance of CentraSitePermission.
 void deletePermission(CentraSitePermission permission)
          Delete specified permission.
 CentraSitePermission getPermission(javax.xml.registry.infomodel.RegistryObject permissionRegistryObject)
          Utility method to obtain CentraSitePermission instance of RegistryObject of type "Permission".
 CentraSitePermission getPermission(java.lang.String permissionId)
          Get the permission corresponding to the specified permission identity.
 CentraSitePermission getPermission(java.lang.String permissionId, javax.xml.registry.infomodel.Organization organization)
          Get the permission corresponding to the specified permission identity applicable to the specified organization.
 java.util.Collection<CentraSitePermission> getPermissions(javax.xml.registry.infomodel.Organization organization)
          Get all the permissions for a given Organization.
 java.util.Collection<CentraSitePermission> getPermissions(java.lang.String filter)
          Get the permissions using the specified search filter.
 java.util.Collection<CentraSitePermission> getPermissionsEx(javax.xml.registry.infomodel.Organization organization)
          Get all the permissions for a given Organization.
 java.util.Collection<CentraSitePermission> getPermissionsEx(java.lang.String filter)
          Get the permissions using the specified search filter.
 
Methods inherited from interface com.centrasite.resourceaccess.managers.ResourceManager
delete, save
 

Method Detail

createPermission

CentraSitePermission createPermission()
                                      throws javax.xml.registry.JAXRException,
                                             com.softwareag.security.jaas.principals.SagGeneralSecurityException
Create a new instance of non-system level CentraSitePermission.

Throws:
javax.xml.registry.JAXRException - if a JAXR error occurs
com.softwareag.security.jaas.principals.SagGeneralSecurityException - if a security error occurs

createPermission

CentraSitePermission createPermission(boolean systemLevel)
                                      throws javax.xml.registry.JAXRException,
                                             com.softwareag.security.jaas.principals.SagGeneralSecurityException
Create a new instance of CentraSitePermission.

Parameters:
systemLevel - Set to true when creating a system level permission.
Throws:
javax.xml.registry.JAXRException - if a JAXR error occurs
com.softwareag.security.jaas.principals.SagGeneralSecurityException - if a security error occurs

deletePermission

void deletePermission(CentraSitePermission permission)
                      throws javax.xml.registry.JAXRException,
                             com.softwareag.security.jaas.principals.SagGeneralSecurityException
Delete specified permission.

Throws:
javax.xml.registry.JAXRException - if a JAXR error occurs
com.softwareag.security.jaas.principals.SagGeneralSecurityException - if a security error occurs

getPermission

CentraSitePermission getPermission(java.lang.String permissionId)
                                   throws javax.xml.registry.JAXRException,
                                          com.softwareag.security.jaas.principals.SagGeneralSecurityException
Get the permission corresponding to the specified permission identity.

Throws:
javax.xml.registry.JAXRException - if a JAXR error occurs
com.softwareag.security.jaas.principals.SagGeneralSecurityException - if a security error occurs

getPermission

CentraSitePermission getPermission(java.lang.String permissionId,
                                   javax.xml.registry.infomodel.Organization organization)
                                   throws javax.xml.registry.JAXRException,
                                          com.softwareag.security.jaas.principals.SagGeneralSecurityException
Get the permission corresponding to the specified permission identity applicable to the specified organization.

Throws:
javax.xml.registry.JAXRException - if a JAXR error occurs
com.softwareag.security.jaas.principals.SagGeneralSecurityException - if a security error occurs

getPermissions

java.util.Collection<CentraSitePermission> getPermissions(java.lang.String filter)
                                                          throws javax.xml.registry.JAXRException,
                                                                 com.softwareag.security.jaas.principals.SagGeneralSecurityException
Get the permissions using the specified search filter.

Parameters:
filter - search filter - if filter is empty string then no filtering occurs
Returns:
permissions (may be empty but not null)
Throws:
javax.xml.registry.JAXRException - if a JAXR error occurs
com.softwareag.security.jaas.principals.SagGeneralSecurityException - if a security error occurs

getPermissionsEx

java.util.Collection<CentraSitePermission> getPermissionsEx(java.lang.String filter)
                                                            throws javax.xml.registry.JAXRException,
                                                                   com.softwareag.security.jaas.principals.SagGeneralSecurityException
Get the permissions using the specified search filter. The returned collection will support repeated iterations. It must be closed when finished with.

Parameters:
filter - search filter - if filter is empty string then no filtering occurs
Returns:
permissions (may be empty but not null)
Throws:
javax.xml.registry.JAXRException - if a JAXR error occurs
com.softwareag.security.jaas.principals.SagGeneralSecurityException - if a security error occurs

getPermissions

java.util.Collection<CentraSitePermission> getPermissions(javax.xml.registry.infomodel.Organization organization)
                                                          throws javax.xml.registry.JAXRException,
                                                                 com.softwareag.security.jaas.principals.SagGeneralSecurityException
Get all the permissions for a given Organization.

Parameters:
organization - to use in search
Returns:
Collection of CentraSitePermission objects.
Throws:
javax.xml.registry.JAXRException - if a JAXR error occurs
com.softwareag.security.jaas.principals.SagGeneralSecurityException - if a security error occurs

getPermissionsEx

java.util.Collection<CentraSitePermission> getPermissionsEx(javax.xml.registry.infomodel.Organization organization)
                                                            throws javax.xml.registry.JAXRException,
                                                                   com.softwareag.security.jaas.principals.SagGeneralSecurityException
Get all the permissions for a given Organization. The returned collection will support repeated iterations. It must be closed when finished with.

Parameters:
organization - to use in search
Returns:
Collection of CentraSitePermission objects.
Throws:
javax.xml.registry.JAXRException - if a JAXR error occurs
com.softwareag.security.jaas.principals.SagGeneralSecurityException - if a security error occurs

getPermission

CentraSitePermission getPermission(javax.xml.registry.infomodel.RegistryObject permissionRegistryObject)
                                   throws javax.xml.registry.JAXRException,
                                          com.softwareag.security.jaas.principals.SagGeneralSecurityException
Utility method to obtain CentraSitePermission instance of RegistryObject of type "Permission".

Parameters:
permissionRegistryObject - The role RegistryObject.
Returns:
The CentraSiteRole instance
Throws:
javax.xml.registry.JAXRException - if a JAXR error occurs
java.lang.IllegalArgumentException - If permissionRegistryObject is not of Permission type.
com.softwareag.security.jaas.principals.SagGeneralSecurityException