persistencemanagerrdbms.java

GridSphere 门户 提供一个基于 portlet 的高级开放源代码门户。GridSphere 是在欧盟提供基金的 GridLab 项目下开发的

/*
 * @author <a href="mailto:[e-mail]">Oliver Wehrens</a>
 * @author <a href="mailto:[e-mail]">Jason Novotny</a>
 * @version $Id: PersistenceManagerRdbms.java 4793 2006-05-17 20:35:20Z novotny $
 */
package org.gridsphere.services.core.persistence;

import java.util.List;

public interface PersistenceManagerRdbms {

    public void setClassLoader(ClassLoader loader);

    public void beginTransaction();

    public void endTransaction();

    public void rollbackTransaction();

    /**
     * Creates the given object in the permanent storage.
     *
     * @param object object to be saved
     * @throws PersistenceManagerException if the object could not be created
     */
    public void create(Object object) throws PersistenceManagerException;

    /**
     * Updates the given (already existing) object in the permanent storage.
     *
     * @param object Object to be updated
     * @throws PersistenceManagerException If object could not be updated
     */
    public void update(Object object) throws PersistenceManagerException;

    /**
     * Saves or updates the given (already existing) object in the permanent storage.
     *
     * @param object Object to be updated
     * @throws PersistenceManagerException If object could not be updated
     */
    public void saveOrUpdate(Object object) throws PersistenceManagerException;

    /**
     * Restores an object matching the query. If multiple are found the first
     * is returned.
     *
     * @param query Query describing the object which should be restored
     * @return object Returns queried object or null if none was found
     * @throws PersistenceManagerException
     */
    public Object restore(String query) throws PersistenceManagerException;

    /**
     * Restores objects from storage matching the query.
     *
     * @param query Query describing the objects
     * @return list List of objects from OQL query
     * @throws PersistenceManagerException If a persistence error occurs
     */
    public List restoreList(String query) throws PersistenceManagerException;

    /**
     * Restores objects from storage matching the query and the supplied query filter
     *
     * @param query       Query describing the objects
     * @param queryFilter a query filter specifying a subset of the list of objects to return
     * @return list List of objects from OQL query
     * @throws PersistenceManagerException
     */
    public List restoreList(String query, QueryFilter queryFilter) throws PersistenceManagerException;

    /**
     * @param query Query describing the objects
     * @return the number of objects returned by the query
     * @throws PersistenceManagerException
     */
    public int count(String query) throws PersistenceManagerException;

    /**
     * Deletes the given object from the storage.
     *
     * @param object Object to be deleted.
     * @throws PersistenceManagerException If a persistence error occurs
     */
    public void delete(Object object) throws PersistenceManagerException;

    /**
     * Deletes objects from the storage matching the given query.
     *
     * @param query Query describing the objects to be deleted
     * @throws PersistenceManagerException If a persistence error occurs
     */
    public void deleteList(String query) throws PersistenceManagerException;

    /**
     * Shuts down the PersistenceManager. Used to free any ressources
     * still used by it.
     *
     * @throws PersistenceManagerException
     */
    public void destroy();
}