org.glite.security.delegation.storage
Interface GrDPStorage

All Known Implementing Classes:
GrDPStorageDatabase, GrDPStorageFilesystem

public interface GrDPStorage

Defines the internal interface to information storage in the delegation service.

It is assumed that two different storage areas exist:

Both areas also hold additional information about the request/proxy: list of VOMS attributes, client DN.

The exposed operations match the ones that exist in a normal relational database: insert / update / delete / find.


Method Summary
 void deleteGrDPStorageCacheElement(java.lang.String delegationID, java.lang.String DN)
          Deletes an existing delegation request.
 void deleteGrDPStorageElement(java.lang.String delegationID, java.lang.String DN)
          Deletes an existing delegated proxy.
 GrDPStorageCacheElement findGrDPStorageCacheElement(java.lang.String delegationID, java.lang.String DN)
          Retrieves an existing delegation request from the storage cache area.
 GrDPStorageElement findGrDPStorageElement(java.lang.String delegationID, java.lang.String DN)
          Retrieves an existing delegated proxy from the storage area.
 void insertGrDPStorageCacheElement(GrDPStorageCacheElement elem)
          Insert new delegation request into storage cache area.
 void insertGrDPStorageElement(GrDPStorageElement elem)
          Insert new delegated proxy into storage area.
 void updateGrDPStorageCacheElement(GrDPStorageCacheElement elem)
          Updates existing delegation request in storage cache area.
 void updateGrDPStorageElement(GrDPStorageElement elem)
          Updates existing delegated proxy information in storage area.
 

Method Detail

insertGrDPStorageCacheElement

void insertGrDPStorageCacheElement(GrDPStorageCacheElement elem)
                                   throws GrDPStorageException
Insert new delegation request into storage cache area.

Parameters:
elem - Object containing the information about the delegation request.
Throws:
GrDPStorageException - Failed to store new delegation request in storage cache area.

updateGrDPStorageCacheElement

void updateGrDPStorageCacheElement(GrDPStorageCacheElement elem)
                                   throws GrDPStorageException
Updates existing delegation request in storage cache area.

Parameters:
elem - Object containing the information about the delegation request.
Throws:
GrDPStorageException - Failed to storage new delegation request in storage cache area.

findGrDPStorageCacheElement

GrDPStorageCacheElement findGrDPStorageCacheElement(java.lang.String delegationID,
                                                    java.lang.String DN)
                                                    throws GrDPStorageException
Retrieves an existing delegation request from the storage cache area.

Parameters:
delegationID - The id of the delegation request to be returned.
DN - The dn of the user owning the delegation request.
Returns:
The object containing the information on the delegation request.
Throws:
GrDPStorageException - Could not retrieve a delegation request because either it does not exist or an error occured while tried to access it.

deleteGrDPStorageCacheElement

void deleteGrDPStorageCacheElement(java.lang.String delegationID,
                                   java.lang.String DN)
                                   throws GrDPStorageException
Deletes an existing delegation request.

Parameters:
delegationID - The id of the delegation request to be deleted.
DN - The dn of the owner of the delegation request.
Throws:
GrDPStorageException - Failed to delete the delegation request as either it does not exist or could not be accessed.

insertGrDPStorageElement

void insertGrDPStorageElement(GrDPStorageElement elem)
                              throws GrDPStorageException
Insert new delegated proxy into storage area.

Parameters:
elem - Object containing the information about the delegation proxy.
Throws:
GrDPStorageException - Failed to storage new delegation proxy in storage area.

updateGrDPStorageElement

void updateGrDPStorageElement(GrDPStorageElement elem)
                              throws GrDPStorageException
Updates existing delegated proxy information in storage area.

Parameters:
elem - Object containing the information about the delegated proxy.
Throws:
GrDPStorageException - Failed to store new delegated proxy in storage area.

findGrDPStorageElement

GrDPStorageElement findGrDPStorageElement(java.lang.String delegationID,
                                          java.lang.String DN)
                                          throws GrDPStorageException
Retrieves an existing delegated proxy from the storage area.

Parameters:
delegationID - The id of the delegated proxy to be returned.
DN - The dn of the user owning the delegated proxy.
Returns:
The object containing the information on the delegated proxy.
Throws:
GrDPStorageException - Could not retrieve a delegated proxy because either it does not exist or an error occured while tried to access it.

deleteGrDPStorageElement

void deleteGrDPStorageElement(java.lang.String delegationID,
                              java.lang.String DN)
                              throws GrDPStorageException
Deletes an existing delegated proxy.

Parameters:
delegationID - The id of the delegated proxy to be deleted.
DN - The dn of the owner of the delegated proxy.
Throws:
GrDPStorageException - Failed to delete the delegated proxy as either it does not exist or could not be accessed.


Copyright © 2004-2008. EU-EGEE