Interface PersistenceQuery

All Known Implementing Classes:
AbstractCallQuery, MultiRSCallQuery, PostgreSQLCallQuery, ReturnedRSCallQuery, SQLQuery

public interface PersistenceQuery
The persistence engine implements this interface in order to allow queries to be performed and multiple objects to be returned. This is an extension of Persistence.load(java.lang.Object, org.castor.persist.ProposedEntity, org.exolab.castor.persist.spi.Identity, org.exolab.castor.mapping.AccessMode) for dealing with complex queries.

The caller takes full responsibility to assure integrity of transactions and object caching and only relies on the engine to assist in assuring that through the mechanisms available to it.

A query may be created once and used multiple times by calling the execute(Object, AccessMode, boolean) method. Query parameters are set each time prior to executing the query.

See Persistence for information about locks, loading objects, identities and stamps.

Version:
$Revision: 8104 $ $Date: 2006-04-11 15:26:07 -0600 (Tue, 11 Apr 2006) $
Author:
Assaf Arkin
See Also:
  • Method Summary

    Modifier and Type
    Method
    Description
    boolean
    absolute(int row)
    Moves the result of the query to the absolute position in the resultset.
    void
    Close the query and release all resources held by the query.
    void
    execute(Object conn, AccessMode accessMode, boolean scrollable)
    Execute the query with the give connection and lock type.
    void
    fetch(ProposedEntity proposedObject)
    Loades the object.
    Returns the type of object returned by this query.
    Returns the identity of the next object to be returned.
    void
    setParameter(int index, Object value)
    Sets the value of a paramter.
    int
    Finds the size of the resulting resultset from the query.