org.jboss.ejb.plugins.jaws.jdbc
Class JDBCFinderCommand

java.lang.Object
  |
  +--org.jboss.ejb.plugins.jaws.jdbc.JDBCCommand
        |
        +--org.jboss.ejb.plugins.jaws.jdbc.JDBCQueryCommand
              |
              +--org.jboss.ejb.plugins.jaws.jdbc.JDBCFinderCommand

All Implemented Interfaces:

JPMFindEntitiesCommand

Direct Known Subclasses:

JDBCDefinedFinderCommand, JDBCFindAllCommand, JDBCFindByCommand

public abstract class JDBCFinderCommand

extends JDBCQueryCommand

implements JPMFindEntitiesCommand

Abstract superclass of finder commands that return collections. Provides the handleResult() implementation that these all need.

Version:

$Revision: 1.9 $

Author:

Rickard Öberg, Marc Fleury, Joe Shevland, Justin Forder

See Also:

Fields inherited from class org.jboss.ejb.plugins.jaws.jdbc.JDBCCommand

debug, factory, jawsEntity, log, name

Constructor Summary

JDBCFinderCommand(JDBCCommandFactory factory, java.lang.String name)

Method Summary

java.util.Collection	execute(java.lang.reflect.Method finderMethod, java.lang.Object[] args, EntityEnterpriseContext ctx)
protected java.lang.Object	handleResult(java.sql.ResultSet rs, java.lang.Object argOrArgs) Handles the result of successful execution of the query.

Methods inherited from class org.jboss.ejb.plugins.jaws.jdbc.JDBCQueryCommand

executeStatementAndHandleResult

Methods inherited from class org.jboss.ejb.plugins.jaws.jdbc.JDBCCommand

getCMPFieldValue, getConnection, getJawsCMPFieldJDBCType, getJDBCType, getJDBCTypeName, getPkColumnList, getPkColumnWhereList, getPkFieldValue, getResultObject, getResultObject, getSQL, getState, isBinaryType, jdbcExecute, setCMPFieldValue, setParameter, setParameters, setPrimaryKeyParameters, setSQL

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

JDBCFinderCommand

public JDBCFinderCommand(JDBCCommandFactory factory,
                         java.lang.String name)

Method Detail

execute

public java.util.Collection execute(java.lang.reflect.Method finderMethod,
                                    java.lang.Object[] args,
                                    EntityEnterpriseContext ctx)
                             throws java.rmi.RemoteException,
                                    javax.ejb.FinderException

Specified by:

execute in interface JPMFindEntitiesCommand

handleResult

protected java.lang.Object handleResult(java.sql.ResultSet rs,
                                        java.lang.Object argOrArgs)
                                 throws java.lang.Exception

Description copied from class: JDBCQueryCommand

Handles the result of successful execution of the query.

Overrides:

handleResult in class JDBCQueryCommand

Following copied from class: org.jboss.ejb.plugins.jaws.jdbc.JDBCQueryCommand

Parameters:

rs - the result set from the query.

argOrArgs - argument or array of arguments passed in from subclass execute method.

Returns:

any result produced by the handling of the result of executing the prepared statement.

Throws:

java.lang.Exception - if execution or result handling fails.