com.netscape.certsrv.dbs

Interface IDBSSession

All Superinterfaces:

java.lang.AutoCloseable

public interface IDBSSession
extends java.lang.AutoCloseable

An interface represents the database session. Operations can be performed with a session. Transaction and Caching support can be integrated into session.

Version:

$Revision$, $Date$

Method Summary

Modifier and Type	Method and Description
void	abandon(netscape.ldap.LDAPSearchResults results)
void	add(java.lang.String name, IDBObj obj) Adds object to backend database.
void	close() Closes this session.
<T> IDBVirtualList<T>	createVirtualList(java.lang.String base, java.lang.String filter, java.lang.String[] attrs) Retrieves a list of objects.
<T> IDBVirtualList<T>	createVirtualList(java.lang.String base, java.lang.String filter, java.lang.String[] attrs, java.lang.String sortKey, int pageSize) Retrieves a list of objects.
<T> IDBVirtualList<T>	createVirtualList(java.lang.String base, java.lang.String filter, java.lang.String[] attrs, java.lang.String startFrom, java.lang.String sortKey, int pageSize) Retrieves a list of objects.
void	delete(java.lang.String name) Deletes object from database.
ISubsystem	getDBSubsystem() Returns database subsystem.
void	modify(java.lang.String name, ModificationSet mods) Modify an object in the database.
netscape.ldap.LDAPSearchResults	persistentSearch(java.lang.String base, java.lang.String filter, java.lang.String[] attrs) Sets persistent search to retrieve modified certificate records.
IDBObj	read(java.lang.String name) Reads an object from the database.
IDBObj	read(java.lang.String name, java.lang.String[] attrs) Reads an object from the database, and only populates the selected attributes.
IDBSearchResults	search(java.lang.String base, java.lang.String filter) Searchs for a list of objects that match the filter.
IDBSearchResults	search(java.lang.String base, java.lang.String filter, int maxSize) Searchs for a list of objects that match the filter.
IDBSearchResults	search(java.lang.String base, java.lang.String filter, int maxSize, int timeLimit) Searchs for a list of objects that match the filter.
IDBSearchResults	search(java.lang.String base, java.lang.String filter, java.lang.String[] attrs) Retrieves a list of object that satifies the given filter.

Method Detail

getDBSubsystem

ISubsystem getDBSubsystem()

Returns database subsystem.

Returns:

subsystem

close

void close()
    throws EDBException

Closes this session.

Specified by:

close in interface java.lang.AutoCloseable

Throws:

EDBException - failed to close session

add

void add(java.lang.String name,
         IDBObj obj)
  throws EBaseException

Adds object to backend database. For example,

 session.add("cn=123459,o=certificate repository,o=airius.com",
             certRec);
 

Parameters:

name - name of the object

obj - object to be added

Throws:

EDBException - failed to add object

EBaseException

read

IDBObj read(java.lang.String name)
     throws EBaseException

Reads an object from the database.

Parameters:

name - name of the object that is to be read

Returns:

database object

Throws:

EBaseException - failed to read object

read

IDBObj read(java.lang.String name,
            java.lang.String[] attrs)
     throws EBaseException

Reads an object from the database, and only populates the selected attributes.

Parameters:

name - name of the object that is to be read

attrs - selected attributes

Returns:

database object

Throws:

EBaseException - failed to read object

delete

void delete(java.lang.String name)
     throws EBaseException

Deletes object from database.

Parameters:

name - name of the object that is to be deleted

Throws:

EBaseException - failed to delete object

modify

void modify(java.lang.String name,
            ModificationSet mods)
     throws EBaseException

Modify an object in the database.

Parameters:

name - name of the object that is to be modified

mods - modifications

Throws:

EBaseException - failed to modify

search

IDBSearchResults search(java.lang.String base,
                        java.lang.String filter)
                 throws EBaseException

Searchs for a list of objects that match the filter.

Parameters:

base - starting point of the search

filter - search filter

Returns:

search results

Throws:

EBaseException - failed to search

search

IDBSearchResults search(java.lang.String base,
                        java.lang.String filter,
                        int maxSize)
                 throws EBaseException

Searchs for a list of objects that match the filter.

Parameters:

base - starting point of the search

filter - search filter

maxSize - max number of entries

Returns:

search results

Throws:

EBaseException - failed to search

search

IDBSearchResults search(java.lang.String base,
                        java.lang.String filter,
                        int maxSize,
                        int timeLimit)
                 throws EBaseException

Searchs for a list of objects that match the filter.

Parameters:

base - starting point of the search

filter - search filter

maxSize - max number of entries

timeLimit - timeout limit

Returns:

search results

Throws:

EBaseException - failed to search

search

IDBSearchResults search(java.lang.String base,
                        java.lang.String filter,
                        java.lang.String[] attrs)
                 throws EBaseException

Retrieves a list of object that satifies the given filter.

Parameters:

base - starting point of the search

filter - search filter

attrs - selected attributes

Returns:

search results

Throws:

EBaseException - failed to search

createVirtualList

<T> IDBVirtualList<T> createVirtualList(java.lang.String base,
                                        java.lang.String filter,
                                        java.lang.String[] attrs)
                                 throws EBaseException

Retrieves a list of objects.

Parameters:

base - starting point of the search

filter - search filter

attrs - selected attributes

Returns:

search results in virtual list

Throws:

EBaseException - failed to search

persistentSearch

netscape.ldap.LDAPSearchResults persistentSearch(java.lang.String base,
                                                 java.lang.String filter,
                                                 java.lang.String[] attrs)
                                          throws EBaseException

Sets persistent search to retrieve modified certificate records.

Parameters:

base - starting point of the search

filter - search filter

attrs - selected attributes

Returns:

LDAP search results

Throws:

EBaseException - failed to search

abandon

void abandon(netscape.ldap.LDAPSearchResults results)
      throws EBaseException

Throws:

EBaseException

createVirtualList

<T> IDBVirtualList<T> createVirtualList(java.lang.String base,
                                        java.lang.String filter,
                                        java.lang.String[] attrs,
                                        java.lang.String sortKey,
                                        int pageSize)
                                 throws EBaseException

Retrieves a list of objects.

Parameters:

base - starting point of the search

filter - search filter

attrs - selected attributes

sortKey - key used to sort the list

pageSize - page size in the virtual list

Returns:

search results in virtual list

Throws:

EBaseException - failed to search

createVirtualList

<T> IDBVirtualList<T> createVirtualList(java.lang.String base,
                                        java.lang.String filter,
                                        java.lang.String[] attrs,
                                        java.lang.String startFrom,
                                        java.lang.String sortKey,
                                        int pageSize)
                                 throws EBaseException

Retrieves a list of objects.

Parameters:

base - starting point of the search

filter - search filter

attrs - selected attributes

startFrom - starting point

sortKey - key used to sort the list

pageSize - page size in the virtual list

Returns:

search results in virtual list

Throws:

EBaseException - failed to search