Class DBSSession

java.lang.Object
com.netscape.cmscore.dbs.DBSSession
All Implemented Interfaces:
AutoCloseable
Direct Known Subclasses:
LDAPSession

public class DBSSession extends Object implements AutoCloseable
An interface represents the database session. Operations can be performed with a session. Transaction and Caching support can be integrated into session.
  • Constructor Details

    • DBSSession

      public DBSSession()
  • Method Details

    • close

      public void close() throws EDBException
      Closes this session.
      Specified by:
      close in interface AutoCloseable
      Throws:
      EDBException - failed to close session
    • add

      public void add(String name, IDBObj obj) throws EBaseException
      Adds object to backend database. For example,
       session.add("cn=123459,o=certificate repository,o=airius.com", record);
       
      Parameters:
      name - name of the object
      obj - object to be added
      Throws:
      EDBException - failed to add object
      EBaseException
    • read

      public IDBObj read(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

      public IDBObj read(String name, 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

      public void delete(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

      public void modify(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

      public IDBSearchResults search(String base, 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

      public IDBSearchResults search(String base, 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

      public IDBSearchResults search(String base, 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

      public IDBSearchResults search(String base, String filter, int maxSize, String sortAttribute) 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
      sortAttribute - Field to sort the records on
      Returns:
      search results
      Throws:
      EBaseException - failed to search
    • search

      public IDBSearchResults search(String base, String filter, int maxSize, int timeLimit, String sortAttribute) 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
      sortAttribute - Field to sort the records on
      Returns:
      search results
      Throws:
      EBaseException - failed to search
    • search

      public IDBSearchResults search(String base, String filter, 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
    • persistentSearch

      public netscape.ldap.LDAPSearchResults persistentSearch(String base, String filter, 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
    • createVirtualList

      public <T extends IDBObj> IDBVirtualList<T> createVirtualList(String base, String filter, 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
    • createVirtualList

      public <T extends IDBObj> IDBVirtualList<T> createVirtualList(String base, String filter, String[] attrs, 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

      public <T extends IDBObj> IDBVirtualList<T> createVirtualList(String base, String filter, String[] attrs, String[] sortKeys, int pageSize) throws EBaseException
      Retrieves a list of objects.
      Parameters:
      base - starting point of the search
      filter - search filter
      attrs - selected attributes
      sortKeys - keys used to sort the list
      pageSize - page size in the virtual list
      Returns:
      search results in virtual list
      Throws:
      EBaseException - failed to search
    • createVirtualList

      public <T extends IDBObj> IDBVirtualList<T> createVirtualList(String base, String filter, String[] attrs, String startFrom, 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
    • abandon

      public void abandon(netscape.ldap.LDAPSearchResults results) throws EBaseException
      Throws:
      EBaseException