Field Detail

• _stmt

  protected java.sql.PreparedStatement _stmt

• _rs

  protected java.sql.ResultSet _rs

• _lastIdentity

  protected Identity _lastIdentity

• _values

  protected final java.lang.Object[] _values

• _call

  protected final java.lang.String _call

Constructor Detail

• AbstractCallQuery

  protected AbstractCallQuery​(java.lang.String call,
                              java.lang.Class<?>[] types,
                              java.lang.Class<?> javaClass,
                              int[] sqlTypes)

Method Detail

• nextRow

  protected abstract boolean nextRow()
                              throws java.sql.SQLException

  Throws:

  java.sql.SQLException

• fetch

  public void fetch​(ProposedEntity proposedObject)
             throws PersistenceException

  Description copied from interface: PersistenceQuery
  Loades the object. This method must be called immediately after PersistenceQuery.nextIdentity(org.exolab.castor.persist.spi.Identity) with the same identity.

  If the object is locked by another transaction this method will block until the lock is released, or a timeout occured. If a timeout occurs or the object has been deleted by the other transaction, this method will report an ObjectNotFoundException. The query may proceed to the next identity.

  This method is equivalent to Persistence.load(java.lang.Object, org.castor.persist.ProposedEntity, org.exolab.castor.persist.spi.Identity, org.exolab.castor.mapping.AccessMode) with a known cache engine and access mode and acts on the query results rather than issuing a new query to load the object.

  Specified by:

  fetch in interface PersistenceQuery

  Parameters:

  proposedObject - The fields to load into

  Throws:

  PersistenceException - The object was not found in persistent storage or any other persistence error occured.

  See Also:

  Persistence.load(java.lang.Object, org.castor.persist.ProposedEntity, org.exolab.castor.persist.spi.Identity, org.exolab.castor.mapping.AccessMode)

• close

  public void close()

  Description copied from interface: PersistenceQuery
  Close the query and release all resources held by the query.

  Specified by:

  close in interface PersistenceQuery

• getParameterCount

  public int getParameterCount()

• getParameterType

  public java.lang.Class<?> getParameterType​(int index)
                                      throws java.lang.ArrayIndexOutOfBoundsException

  Throws:

  java.lang.ArrayIndexOutOfBoundsException

• setParameter

  public void setParameter​(int index,
                           java.lang.Object value)
                    throws java.lang.ArrayIndexOutOfBoundsException,
                           java.lang.IllegalArgumentException

  Description copied from interface: PersistenceQuery
  Sets the value of a paramter. Will complain if the parameter is not of the specified type.

  Specified by:

  setParameter in interface PersistenceQuery

  Parameters:

  index - The parameter index

  value - The parameter value

  Throws:

  java.lang.ArrayIndexOutOfBoundsException

  java.lang.IllegalArgumentException

• absolute

  public boolean absolute​(int row)
                   throws PersistenceException

  Description copied from interface: PersistenceQuery
  Moves the result of the query to the absolute position in the resultset.

  Specified by:

  absolute in interface PersistenceQuery

  Parameters:

  row - The row to move to

  Throws:

  PersistenceException - A persistence error occured

• size

  public int size()
           throws PersistenceException

  Description copied from interface: PersistenceQuery
  Finds the size of the resulting resultset from the query.

  Specified by:

  size in interface PersistenceQuery

  Throws:

  PersistenceException

• getResultType

  public java.lang.Class<?> getResultType()

  Description copied from interface: PersistenceQuery
  Returns the type of object returned by this query.

  Specified by:

  getResultType in interface PersistenceQuery

  Returns:

  The type of object returned by this query

• execute

  public void execute​(java.lang.Object conn,
                      AccessMode accessMode,
                      boolean scrollable)
               throws PersistenceException

  Description copied from interface: PersistenceQuery
  Execute the query with the give connection and lock type. After a successful return the query results will be returned by calling PersistenceQuery.nextIdentity(org.exolab.castor.persist.spi.Identity) and PersistenceQuery.fetch(org.castor.persist.ProposedEntity). The query parameters will be reset. A new query may be issued by providing new query parameters and calling PersistenceQuery.execute(Object, AccessMode, boolean).

  Specified by:

  execute in interface PersistenceQuery

  Parameters:

  conn - An open connection

  accessMode - The access mode (null equals shared)

  scrollable - The db cursor mode.

  Throws:

  PersistenceException - An invalid query or an error reported by the persistence engine.

• execute

  protected abstract void execute​(java.lang.Object conn,
                                  AccessMode accessMode)
                           throws PersistenceException

  Throws:

  PersistenceException

• nextIdentity

  public Identity nextIdentity​(Identity identity)
                        throws PersistenceException

  Description copied from interface: PersistenceQuery
  Returns the identity of the next object to be returned. Calling this method multiple time will skip objects. When the result set has been exhuasted, this method will return null.

  Specified by:

  nextIdentity in interface PersistenceQuery

  Parameters:

  identity - The identity of the previous object, null if this method is called for the first time

  Returns:

  The identity of the next object, null if the result set has been exhausted

  Throws:

  PersistenceException - An error reported by the persistence engine