org.noorm.jdbc

Class JDBCStatementProcessor<T>

java.lang.Object

org.noorm.jdbc.JDBCStatementProcessor<T>

public class JDBCStatementProcessor<T>
extends Object

Processor for JDBC database access. This class only supports access to stored procedures and generic queries as specified with the Maven plugin. Based on the expectation that all data-driven business logic is implemented in stored procedures or views, there is no need for overcomplex SQL support.

Author:

Ulf Pietruschka / ulf.pietruschka@etenso.com

Field Summary

Fields

Modifier and Type	Field and Description
static String	NOORM_ID_LIST_ORACLE_TYPE_NAME

Method Summary

Methods

Modifier and Type	Method and Description
void	callPLSQL(String pPLSQLCallable, Map<String,Object> pInParameters) Call a PL/SQL procedure without OUT parameter.
T	callPLSQL(String pPLSQLCallable, String pOutParamName, Map<String,Object> pInParameters, Class<T> pOutClass) Call a PL/SQL procedure with a scalar OUT parameter or without OUT parameter.
void	debugPLSQLCall(String pPLSQLCallable, Map<String,Object> pInParameters, Class<T> pBeanClass)
List<Map<String,Object>>	executeGenericSelect(String pSelectStatement) Convenience method to a provide some minimal SQL functionality for the application.
T	getBeanFromPLSQL(String pPLSQLCallable, String pRefCursorName, Map<String,Object> pInParameters, Class<T> pBeanClass) Calls a PL/SQL procedure with a ref cursor as OUT parameter.
List<T>	getBeanListFromPLSQL(String pPLSQLCallable, String pRefCursorName, Class<T> pBeanClass) Calls a PL/SQL procedure with a ref cursor as OUT parameter.
List<T>	getBeanListFromPLSQL(String pPLSQLCallable, String pRefCursorName, Map<String,Object> pInParameters, Class<T> pBeanClass)
List<T>	getBeanListFromSQL(String pTableName, Map<QueryColumn,Object> pInParameters, Class<T> pBeanClass, boolean pAcquireLock) Executes a generic SQL statement for the given table (or view) name with the given query parameters.
static <T> JDBCStatementProcessor<T>	getInstance()

Methods inherited from class java.lang.Object

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

Field Detail

NOORM_ID_LIST_ORACLE_TYPE_NAME

public static final String NOORM_ID_LIST_ORACLE_TYPE_NAME

See Also:

Constant Field Values

Method Detail

getInstance

public static <T> JDBCStatementProcessor<T> getInstance()

callPLSQL

public void callPLSQL(String pPLSQLCallable,
             Map<String,Object> pInParameters)

Call a PL/SQL procedure without OUT parameter.

Parameters:

pPLSQLCallable - the name of PL/SQL procedure or the notation PACKAGENAME.PROCEDURE.

pInParameters - the map containing all IN parameters.

callPLSQL

public T callPLSQL(String pPLSQLCallable,
          String pOutParamName,
          Map<String,Object> pInParameters,
          Class<T> pOutClass)

Call a PL/SQL procedure with a scalar OUT parameter or without OUT parameter.

Parameters:

pPLSQLCallable - the name of PL/SQL procedure or the notation PACKAGENAME.PROCEDURE.

pOutParamName - the name of the scalar OUT parameter.

pInParameters - the map containing all IN parameters.

pOutClass - the type of the scalar OUT parameter.

Returns:

The scalar data-type returned by the PL/SQL procedure, if any.

getBeanFromPLSQL

public T getBeanFromPLSQL(String pPLSQLCallable,
                 String pRefCursorName,
                 Map<String,Object> pInParameters,
                 Class<T> pBeanClass)

Calls a PL/SQL procedure with a ref cursor as OUT parameter. This method is expected to return a single record or no record as a result. In case of multiple records matching the given parameter map, a DataAccessException is thrown.

Parameters:

pPLSQLCallable - the name of PL/SQL procedure or the notation PACKAGENAME.PROCEDURE.

pRefCursorName - the parameter name of the procedure out parameter ref cursor.

pInParameters - the map containing all IN parameters.

pBeanClass - the type of the Bean matching the fields of the ResultSet.

Returns:

The Beans containing the retrieved data.

getBeanListFromPLSQL

public List<T> getBeanListFromPLSQL(String pPLSQLCallable,
                           String pRefCursorName,
                           Class<T> pBeanClass)

Calls a PL/SQL procedure with a ref cursor as OUT parameter.

Parameters:

pPLSQLCallable - the name of PL/SQL procedure or the notation PACKAGENAME.PROCEDURE.

pRefCursorName - the parameter name of the procedure out parameter ref cursor.

pBeanClass - the type of the Bean matching the fields of the ResultSet.

Returns:

The list of Beans containing the retrieved data.

getBeanListFromSQL

public List<T> getBeanListFromSQL(String pTableName,
                         Map<QueryColumn,Object> pInParameters,
                         Class<T> pBeanClass,
                         boolean pAcquireLock)

Executes a generic SQL statement for the given table (or view) name with the given query parameters. This functionality is designated to support the query declaration available in the Maven generator plugin. Any complex SQL like joins is expected to be encapsulated within a database view definition and is not supported here.

Parameters:

pTableName - the table or view name used for the SQL query

pInParameters - the parameters for the where-clause of the SQL query

pBeanClass - the return type

Returns:

a list containing the results of type pBeanClass

getBeanListFromPLSQL

public List<T> getBeanListFromPLSQL(String pPLSQLCallable,
                           String pRefCursorName,
                           Map<String,Object> pInParameters,
                           Class<T> pBeanClass)

executeGenericSelect

public List<Map<String,Object>> executeGenericSelect(String pSelectStatement)

Convenience method to a provide some minimal SQL functionality for the application. Usage of this method is discouraged, but maybe helpful under some circumstances.

Parameters:

pSelectStatement - The SELECT statement for generic execution.

Returns:

A list containing a map for each record with a column-name to object mapping.

debugPLSQLCall

public void debugPLSQLCall(String pPLSQLCallable,
                  Map<String,Object> pInParameters,
                  Class<T> pBeanClass)