org.apache.cayenne.access
Class DataDomainLegacyQueryAction

java.lang.Object
  extended by org.apache.cayenne.access.DataDomainLegacyQueryAction
All Implemented Interfaces:
OperationHints, OperationObserver, QueryRouter

Deprecated. since 3.0 - this class should not be public

public class DataDomainLegacyQueryAction
extends Object
implements QueryRouter, OperationObserver

DataDomain query action that relies on externally provided OperationObserver to process the results.

Since:
1.2

Method Summary
 QueryEngine engineForDataMap(DataMap map)
          Deprecated. Returns a QueryEngine that is configured to handle a given DataMap.
 boolean isIteratedResult()
          Deprecated. Returns true to indicate that any results of a select operation should be returned as a ResultIterator.
 void nextBatchCount(Query query, int[] resultCount)
          Deprecated. Callback method invoked after a batch update is executed.
 void nextCount(Query query, int resultCount)
          Deprecated. Callback method invoked after an updating query is executed.
 void nextGeneratedRows(Query query, ResultIterator keysIterator)
          Deprecated. Callback method invoked after each batch of generated values is read during an update.
 void nextGlobalException(Exception e)
          Deprecated. Callback method invoked on exceptions that are not tied to a specific query execution, such as JDBC connection exceptions, etc.
 void nextQueryException(Query query, Exception ex)
          Deprecated. Callback method invoked on exceptions that happen during an execution of a specific query.
 void nextRows(Query query, List<?> dataRows)
          Deprecated. Callback method invoked for each processed ResultSet.
 void nextRows(Query q, ResultIterator it)
          Deprecated. Callback method invoked for each opened ResultIterator.
 void route(QueryEngine engine, Query query, Query substitutedQuery)
          Deprecated. A callback method that allows a query to set its preferred engine during the routing phase.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Method Detail

route

public void route(QueryEngine engine,
                  Query query,
                  Query substitutedQuery)
Deprecated. 
Description copied from interface: QueryRouter
A callback method that allows a query to set its preferred engine during the routing phase. It allows query to further customize its routing, e.g. it is possible to implement query chains that pass multiple queries for execution.

Specified by:
route in interface QueryRouter
Parameters:
engine - engine to use for query execution
query - A query to execute.
substitutedQuery - a query that was substituted for "query". Results must be mapped back to substituted query.

engineForDataMap

public QueryEngine engineForDataMap(DataMap map)
Deprecated. 
Description copied from interface: QueryRouter
Returns a QueryEngine that is configured to handle a given DataMap.

Specified by:
engineForDataMap in interface QueryRouter

nextCount

public void nextCount(Query query,
                      int resultCount)
Deprecated. 
Description copied from interface: OperationObserver
Callback method invoked after an updating query is executed.

Specified by:
nextCount in interface OperationObserver

nextBatchCount

public void nextBatchCount(Query query,
                           int[] resultCount)
Deprecated. 
Description copied from interface: OperationObserver
Callback method invoked after a batch update is executed.

Specified by:
nextBatchCount in interface OperationObserver

nextRows

public void nextRows(Query query,
                     List<?> dataRows)
Deprecated. 
Description copied from interface: OperationObserver
Callback method invoked for each processed ResultSet.

Specified by:
nextRows in interface OperationObserver

nextRows

public void nextRows(Query q,
                     ResultIterator it)
Deprecated. 
Description copied from interface: OperationObserver
Callback method invoked for each opened ResultIterator. If this observer requested results to be returned as a ResultIterator, this method is invoked instead of OperationObserver.nextRows(Query, List).

Specified by:
nextRows in interface OperationObserver

nextGeneratedRows

public void nextGeneratedRows(Query query,
                              ResultIterator keysIterator)
Deprecated. 
Description copied from interface: OperationObserver
Callback method invoked after each batch of generated values is read during an update.

Specified by:
nextGeneratedRows in interface OperationObserver

nextQueryException

public void nextQueryException(Query query,
                               Exception ex)
Deprecated. 
Description copied from interface: OperationObserver
Callback method invoked on exceptions that happen during an execution of a specific query.

Specified by:
nextQueryException in interface OperationObserver

nextGlobalException

public void nextGlobalException(Exception e)
Deprecated. 
Description copied from interface: OperationObserver
Callback method invoked on exceptions that are not tied to a specific query execution, such as JDBC connection exceptions, etc.

Specified by:
nextGlobalException in interface OperationObserver

isIteratedResult

public boolean isIteratedResult()
Deprecated. 
Description copied from interface: OperationHints
Returns true to indicate that any results of a select operation should be returned as a ResultIterator. false is returned when the results are expected as a list.

Specified by:
isIteratedResult in interface OperationHints


Copyright © 2001-2011 Apache Cayenne. All Rights Reserved.