Overview  Package   Class  Use  Deprecated  Index
Home >> All >> org >> objectstyle >> cayenne >> [ access overview ]	PREV CLASS  NEXT CLASS
SUMMARY:  JAVADOC |  SOURCE |  DOWNLOAD | NESTED | FIELD | CONSTR | METHOD	DETAIL: FIELD | CONSTR | METHOD

---

org.objectstyle.cayenne.access
Interface OperationObserver  

All Superinterfaces:

OperationHints

All Known Implementing Classes:

DefaultOperationObserver, org.objectstyle.cayenne.access.util.DefaultOperationObserver

---

public interface OperationObserver

extends OperationHints

Defines a set of callback methods for a QueryEngine to notify interested object about different stages of queries execution. Superinterface, OperationHints, defines information methods that are needed to define query execution strategy. This Interface adds callback methods.

Implementing objects are passed to a QueryEngine that will execute one or more queries. QueryEngine will pass results of the execution of any kind of queries - selects, updates, store proc. calls, etc.. to the interested objects. This includes result counts, created objects, thrown exceptions, etc.

For more information see Cayenne User Guide.

---

Method Summary
void	nextBatchCount(org.objectstyle.cayenne.query.Query query, int[] resultCount)           Invoked after the batch update is executed
void	nextCount(org.objectstyle.cayenne.query.Query query, int resultCount)           Invoked after the update (can be insert, delete or update query) is executed.
void	nextDataRows(org.objectstyle.cayenne.query.Query query, java.util.List dataRows)           Invoked after the next query results are read.
void	nextDataRows(org.objectstyle.cayenne.query.Query q, ResultIterator it)           Invoked after the next query is invoked, if a query required results to be returned as a ResultIterator.
void	nextGlobalException(java.lang.Exception ex)           Invoked when a "global" exception occurred, such as JDBC connection exception, etc.
void	nextQueryException(org.objectstyle.cayenne.query.Query query, java.lang.Exception ex)           Invoked when an exception occurs during query execution.
void	transactionCommitted()           Invoked when a batch of queries was processed as a single transaction, and this transaction was successfully committed.
void	transactionRolledback()           Invoked when a batch of queries was processed as a single transaction, and this transaction was failed and was rolled back.

 

Methods inherited from interface org.objectstyle.cayenne.access.OperationHints

getLoggingLevel, isIteratedResult, useAutoCommit

 

Method Detail

nextCount

public void nextCount(org.objectstyle.cayenne.query.Query query,
                      int resultCount)

Invoked after the update (can be insert, delete or update query) is executed.

---

nextBatchCount

public void nextBatchCount(org.objectstyle.cayenne.query.Query query,
                           int[] resultCount)

Invoked after the batch update is executed

---

nextDataRows

public void nextDataRows(org.objectstyle.cayenne.query.Query query,
                         java.util.List dataRows)

Invoked after the next query results are read.

---

nextDataRows

public void nextDataRows(org.objectstyle.cayenne.query.Query q,
                         ResultIterator it)

Invoked after the next query is invoked, if a query required results to be returned as a ResultIterator. OperationObserver is responsible for closing the ResultIterator.

---

nextQueryException

public void nextQueryException(org.objectstyle.cayenne.query.Query query,
                               java.lang.Exception ex)

Invoked when an exception occurs during query execution.

---

nextGlobalException

public void nextGlobalException(java.lang.Exception ex)

Invoked when a "global" exception occurred, such as JDBC connection exception, etc.

---

transactionCommitted

public void transactionCommitted()

Invoked when a batch of queries was processed as a single transaction, and this transaction was successfully committed.

---

transactionRolledback

public void transactionRolledback()

Invoked when a batch of queries was processed as a single transaction, and this transaction was failed and was rolled back.

---

Overview  Package   Class  Use  Deprecated  Index
Home >> All >> org >> objectstyle >> cayenne >> [ access overview ]	PREV CLASS  NEXT CLASS
SUMMARY:  JAVADOC |  SOURCE |  DOWNLOAD | NESTED | FIELD | CONSTR | METHOD	DETAIL: FIELD | CONSTR | METHOD

---