org.smyld.db

Class Utility

java.lang.Object

org.smyld.db.Utility

Direct Known Subclasses:

OracleDBUtil

public class Utility
extends Object

To facilitate the use of JDBC classes and methods and strengthen the sql statements fetch and update operations

Version:

1.0 03/03/03

Author:

Mohammed Jamil

Field Summary

Fields

Modifier and Type	Field and Description
protected Connection	dbConnection Represents the connection object that is used by the class to execute SQL statements
static int	ERR_CATEGORY_CONNECTION
static int	ERR_CATEGORY_SQL
static int	ERR_CATEGORY_STORED_PROCEDURES_ERROR
static int	ERR_CATEGORY_STORED_PROCEDURES_RECOMPILED
static int	EXCEPTION_CONNECTION_RESET
static int	EXCEPTION_CONNECTION_SHUT
protected DBErrorHandler	handler Handles the errors regarding this connection
protected DBIOHandler	ioHandler
protected DBConnection	smyldDbConnection

Constructor Summary

Constructors

Constructor and Description
Utility(DBConnection activeDBConnection, DBErrorHandler e) Constructs the class with the given connection object to be used for the execution of statements

Method Summary

Modifier and Type	Method and Description
void	closeCursor(PreparedStatement stRecords) Close the cursor opened through the given prepared statement object
void	closeCursor(ResultSet rsRecords) Close the cursor opened through the given result set object
static String	constructDoubleParamFunctionCall(String functionName)
static String	constructDoubleParamProcedureCall(String ProcedureName)
static String	constructMultiParamFunctionCall(String functionName, int paramsNo)
static String	constructMultiParamProcedureCall(String ProcedureName, int paramsNo)
static String	constructSingleParamFunctionCall(String functionName)
static String	constructSingleParamProcedureCall(String ProcedureName)
static String	constructTrippleParamFunctionCall(String functionName)
static String	constructTrippleParamProcedureCall(String ProcedureName)
String	createInsertSQL(String tableName)
String	detectLongFieldError(PreparedStatement st)
boolean	doDoubleParamSQL(String firstParam, String secondParam, String sqlText) To invoke the given sql and set the given 2 parameters using execute method
int	doDoubleParamUpdateSQL(String firstParam, String secondParam, String sqlText) To invoke the given sql and set the given 2 parameters using executeUpdate method
int	doQuadParamUpdateSQL(String firstParam, String secondParam, String thirdParam, String fourthParam, String sqlText) To invoke the given sql and set the given 3 parameters using executeUpdate method
boolean	doSingleParamSQL(int firstParam, String sqlText) To invoke the given sql and set the given integer parameter using execute method
boolean	doSingleParamSQL(String firstParam, String sqlText) To invoke the given sql and set the given string parameter using execute method
int	doSingleParamUpdateSQL(String firstParam, String sqlText) To invoke the given sql and set the given string parameter using executeUpdate method and returns the affected records number
int	doTrippleParamUpdateSQL(String firstParam, String secondParam, String thirdParam, String sqlText) To invoke the given sql and set the given 3 parameters using executeUpdate method
void	executeDoubleParamFunction(String function, int param1, int param2)
void	executeDoubleParamFunction(String function, String param1, String param2)
void	executeDoubleParamProcedure(String procedure, int param1, int param2)
void	executeDoubleParamProcedure(String procedure, String param1, String param2)
void	executeMultiParamProcedure(String procedure, String[] params)
ResultSet	executeQuery(String sqlText) To invoke the given sql using executeQuery method
void	executeTrippleParamFunction(String function, String param1, String param2, String param3)
void	executeTrippleParamProcedure(String procedure, String param1, int param2, int param3)
ResultSet	fetchTableData(String tableName) Fetches the all the records of the given table with out any conditions
HashMap<String,Field>	FetchTableFields(String TableName, String FieldName, String FieldValue) Fetchs the given table name data and returns HashMap object containing org.smyld.db.Field objects created upon the given field Name/Value pair (represents 2 column names in the given table name)
void	FillColumnNames(ResultSetMetaData rsMetaData, HashMap<String,Integer> results)
Connection	getConnection()
int	getCount(ResultSet rs)
ResultSet	getDoubleParamSQL(int firstParam, int secondParam, String sqlText) To invoke the given sql using executeQuery method,setting the given 2 parameter and returning the resultant result set
ResultSet	getDoubleParamSQL(int firstParam, String secondParam, String sqlText) To invoke the given sql using executeQuery method,setting the given 2 parameter and returning the resultant result set
ResultSet	getDoubleParamSQL(String firstParam, String secondParam, String sqlText) To invoke the given sql using executeQuery method,setting the given 2 parameter and returning the resultant result set
static int	getErrorCategory(Exception ex)
protected static String	getParamsText(int paramsNo)
ResultSet	getQuadParamSQL(String firstParam, String secondParam, String thirdParam, String fourthParam, String sqlText)
int	getSequenceValue(String seqName)
int	getSequentialID(String tableName, String idColName) Calculate the value of the given column name in the given table and increase it by one.
int	getSequentialID(String tableName, String idColName, String whereColumnName, String whereColumnValue) Calculate the value of the given column name in the given table and increase it by one.
ResultSet	getSingleParamSQL(String paramValue, String sqlText) To invoke the given sql using executeQuery method,setting the given parameter and returning the resultant result set
String	getSingleParamSQLData(String firstParam, String sqlText, String columnName) To invoke the given sql using class getSingleParamSQL method,setting the given parameter and returning the gievn column name value
String	getSQLData(String sqlText, String columnName) To invoke the given sql using class executeQuery method, and returning the gievn column name value
ResultSet	getSQLResultSet(String sqlText)
static String	getStringIndex(int digitWidth, int index) Returns the index represented as the required number of digit text.
Vector<TableColumn>	getTableCols(String tableName)
ResultSet	getTrippleParamSQL(int firstParam, int secondParam, String thirdParam, String sqlText) To invoke the given sql and set the given 3 parameters using executeQuery method and returns the resultant result set
ResultSet	getTrippleParamSQL(String firstParam, String secondParam, String thirdParam, String sqlText) To invoke the given sql and set the given 3 parameters using executeQuery method and returns the resultant result set
void	handleDBError(Exception ex)
void	importFile(String targetTable, String fileName)
boolean	isDoubleExist(String firstParam, String secondParam, String sqlText) Checking if the given double parameter sql statement contains records or not
boolean	isExist(ResultSet rsRecords) Checking if the given result set contains records or not
boolean	isExist(String sqlText) Checking if the given single parameter sql statement contains records or not
boolean	isSingleExist(String firstParam, String sqlText) Checking if the given single parameter sql statement contains records or not
boolean	isTrippleExist(String firstParam, String secondParam, String thirdParam, String sqlText) Checking if the given tripple parameter sql statement contains records or not
void	setSMYLDConnection(DBConnection activeConnection)

Methods inherited from class java.lang.Object

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

Field Detail

dbConnection

protected Connection dbConnection

Represents the connection object that is used by the class to execute SQL statements

smyldDbConnection

protected DBConnection smyldDbConnection

ioHandler

protected DBIOHandler ioHandler

handler

protected DBErrorHandler handler

Handles the errors regarding this connection

ERR_CATEGORY_SQL

public static final int ERR_CATEGORY_SQL

See Also:

Constant Field Values

ERR_CATEGORY_CONNECTION

public static final int ERR_CATEGORY_CONNECTION

See Also:

Constant Field Values

ERR_CATEGORY_STORED_PROCEDURES_RECOMPILED

public static final int ERR_CATEGORY_STORED_PROCEDURES_RECOMPILED

See Also:

Constant Field Values

ERR_CATEGORY_STORED_PROCEDURES_ERROR

public static final int ERR_CATEGORY_STORED_PROCEDURES_ERROR

See Also:

Constant Field Values

EXCEPTION_CONNECTION_RESET

public static final int EXCEPTION_CONNECTION_RESET

See Also:

Constant Field Values

EXCEPTION_CONNECTION_SHUT

public static final int EXCEPTION_CONNECTION_SHUT

See Also:

Constant Field Values

Constructor Detail

Utility

public Utility(DBConnection activeDBConnection,
               DBErrorHandler e)

Constructs the class with the given connection object to be used for the execution of statements

Parameters:

activeConnection - the active data base connection object

e - the error handler object that takes care of the errors raised during this connection

Method Detail

closeCursor

public void closeCursor(ResultSet rsRecords)

Close the cursor opened through the given result set object

Parameters:

rsRecords - the result set of the opened cursor

closeCursor

public void closeCursor(PreparedStatement stRecords)

Close the cursor opened through the given prepared statement object

Parameters:

stRecords - the prepared statement of the opened cursor

doDoubleParamSQL

public boolean doDoubleParamSQL(String firstParam,
                                String secondParam,
                                String sqlText)

To invoke the given sql and set the given 2 parameters using execute method

Parameters:

firstParam - the first parameter value

secondParam - the second parameter value

sqlText - the SQL statement

Returns:

true if the operation succeded false otherwise

setSMYLDConnection

public void setSMYLDConnection(DBConnection activeConnection)

doDoubleParamUpdateSQL

public int doDoubleParamUpdateSQL(String firstParam,
                                  String secondParam,
                                  String sqlText)

To invoke the given sql and set the given 2 parameters using executeUpdate method

Parameters:

firstParam - the first parameter value

secondParam - the second parameter value

sqlText - the SQL statement

Returns:

>0 means the number of affected records in data base after executing the statement or 0 if nothing returned

doSingleParamSQL

public boolean doSingleParamSQL(int firstParam,
                                String sqlText)

To invoke the given sql and set the given integer parameter using execute method

Parameters:

firstParam - the first parameter value

sqlText - the SQL statement

Returns:

true if the operation succeded false otherwise

detectLongFieldError

public String detectLongFieldError(PreparedStatement st)
                            throws SQLException

Throws:

SQLException

doTrippleParamUpdateSQL

public int doTrippleParamUpdateSQL(String firstParam,
                                   String secondParam,
                                   String thirdParam,
                                   String sqlText)

To invoke the given sql and set the given 3 parameters using executeUpdate method

Parameters:

firstParam - the first parameter value

secondParam - the second parameter value

thirdParam - the third parameter value

sqlText - the SQL statement

Returns:

>0 means the number of affected records in data base after executing the statement or 0 if nothing returned

doQuadParamUpdateSQL

public int doQuadParamUpdateSQL(String firstParam,
                                String secondParam,
                                String thirdParam,
                                String fourthParam,
                                String sqlText)

To invoke the given sql and set the given 3 parameters using executeUpdate method

Parameters:

firstParam - the first parameter value

secondParam - the second parameter value

thirdParam - the third parameter value

sqlText - the SQL statement

Returns:

>0 means the number of affected records in data base after executing the statement or 0 if nothing returned

getTrippleParamSQL

public ResultSet getTrippleParamSQL(String firstParam,
                                    String secondParam,
                                    String thirdParam,
                                    String sqlText)

To invoke the given sql and set the given 3 parameters using executeQuery method and returns the resultant result set

Parameters:

firstParam - the first parameter value

secondParam - the second parameter value

thirdParam - the third parameter value

sqlText - the SQL statement

Returns:

The resultant result set if succeded and null otherwise

getQuadParamSQL

public ResultSet getQuadParamSQL(String firstParam,
                                 String secondParam,
                                 String thirdParam,
                                 String fourthParam,
                                 String sqlText)

getTrippleParamSQL

public ResultSet getTrippleParamSQL(int firstParam,
                                    int secondParam,
                                    String thirdParam,
                                    String sqlText)

To invoke the given sql and set the given 3 parameters using executeQuery method and returns the resultant result set

Parameters:

firstParam - the first parameter value

secondParam - the second parameter value

thirdParam - the third parameter value

sqlText - the SQL statement

Returns:

The resultant result set if succeded and null otherwise

doSingleParamUpdateSQL

public int doSingleParamUpdateSQL(String firstParam,
                                  String sqlText)

To invoke the given sql and set the given string parameter using executeUpdate method and returns the affected records number

Parameters:

firstParam - the first parameter value

sqlText - the SQL statement

Returns:

>0 means the number of affected records in data base after executing the statement or 0 if nothing returned

doSingleParamSQL

public boolean doSingleParamSQL(String firstParam,
                                String sqlText)

To invoke the given sql and set the given string parameter using execute method

Parameters:

firstParam - the first parameter value

sqlText - the SQL statement

Returns:

true if the operation succeded false otherwise

executeQuery

public ResultSet executeQuery(String sqlText)

To invoke the given sql using executeQuery method

Parameters:

sqlText - the SQL statement

Returns:

The resultant result set if succeded and null otherwise

getSQLData

public String getSQLData(String sqlText,
                         String columnName)

To invoke the given sql using class executeQuery method, and returning the gievn column name value

Parameters:

sqlText - the SQL statement

columnName - the column name of the desired column value

Returns:

The column value if succeded and null otherwise

getSingleParamSQLData

public String getSingleParamSQLData(String firstParam,
                                    String sqlText,
                                    String columnName)

To invoke the given sql using class getSingleParamSQL method,setting the given parameter and returning the gievn column name value

Parameters:

firstParam - the first parameter value

sqlText - the SQL statement

columnName - the column name of the desired column value

Returns:

The column value if succeded and null otherwise

getCount

public int getCount(ResultSet rs)

getSingleParamSQL

public ResultSet getSingleParamSQL(String paramValue,
                                   String sqlText)

To invoke the given sql using executeQuery method,setting the given parameter and returning the resultant result set

Parameters:

firstParam - the first parameter value

sqlText - the SQL statement

Returns:

The resultant result set if succeded and null otherwise

getSQLResultSet

public ResultSet getSQLResultSet(String sqlText)

getDoubleParamSQL

public ResultSet getDoubleParamSQL(String firstParam,
                                   String secondParam,
                                   String sqlText)

To invoke the given sql using executeQuery method,setting the given 2 parameter and returning the resultant result set

Parameters:

firstParam - the first parameter value

secondParam - the second parameter value

sqlText - the SQL statement

Returns:

The resultant result set if succeded and null otherwise

getDoubleParamSQL

public ResultSet getDoubleParamSQL(int firstParam,
                                   String secondParam,
                                   String sqlText)

To invoke the given sql using executeQuery method,setting the given 2 parameter and returning the resultant result set

Parameters:

firstParam - the first parameter value

secondParam - the second parameter value

sqlText - the SQL statement

Returns:

The resultant result set if succeded and null otherwise

getDoubleParamSQL

public ResultSet getDoubleParamSQL(int firstParam,
                                   int secondParam,
                                   String sqlText)

To invoke the given sql using executeQuery method,setting the given 2 parameter and returning the resultant result set

Parameters:

firstParam - the first parameter value

secondParam - the second parameter value

sqlText - the SQL statement

Returns:

The resultant result set if succeded and null otherwise

getSequentialID

public int getSequentialID(String tableName,
                           String idColName)

Calculate the value of the given column name in the given table and increase it by one. To use it for the increased records counter columns

Parameters:

tableName - required table name

Returns:

the resultant column value if succeded and -1 otherwise

getSequentialID

public int getSequentialID(String tableName,
                           String idColName,
                           String whereColumnName,
                           String whereColumnValue)

Calculate the value of the given column name in the given table and increase it by one. To use it for the increased records counter columns

Parameters:

tableName - required table name

Returns:

the resultant column value if succeded and -1 otherwise

getSequenceValue

public int getSequenceValue(String seqName)

isExist

public boolean isExist(ResultSet rsRecords)

Checking if the given result set contains records or not

Parameters:

rsRecords - The result set to be checked

Returns:

true if it contains at least one record and false otherwise

isSingleExist

public boolean isSingleExist(String firstParam,
                             String sqlText)

Checking if the given single parameter sql statement contains records or not

Parameters:

firstParam - The first parameter value

sqlText - The SQL text

Returns:

true if it contains at least one record and false otherwise

isExist

public boolean isExist(String sqlText)

Checking if the given single parameter sql statement contains records or not

Parameters:

firstParam - The first parameter value

sqlText - The SQL text

Returns:

true if it contains at least one record and false otherwise

isDoubleExist

public boolean isDoubleExist(String firstParam,
                             String secondParam,
                             String sqlText)

Checking if the given double parameter sql statement contains records or not

Parameters:

firstParam - The first parameter value

secondParam - The second parameter value

sqlText - The SQL text

Returns:

true if it contains at least one record and false otherwise

isTrippleExist

public boolean isTrippleExist(String firstParam,
                              String secondParam,
                              String thirdParam,
                              String sqlText)

Checking if the given tripple parameter sql statement contains records or not

Parameters:

firstParam - The first parameter value

secondParam - The second parameter value

thirdParam - The third parameter value

sqlText - The SQL text

Returns:

true if it contains at least one record and false otherwise

fetchTableData

public ResultSet fetchTableData(String tableName)

Fetches the all the records of the given table with out any conditions

Parameters:

tableName - comments

Returns:

The resultant result set and null if any error happened

FetchTableFields

public HashMap<String,Field> FetchTableFields(String TableName,
                                              String FieldName,
                                              String FieldValue)

Fetchs the given table name data and returns HashMap object containing org.smyld.db.Field objects created upon the given field Name/Value pair (represents 2 column names in the given table name)

Parameters:

TableName - the target table of data

FieldName - the target table column representing the field Name

FieldValue - the target table column representing the field Value

Returns:

returns HashMap object of org.smyld.db.Field type, holding the information of the table records or null in case of any error

FillColumnNames

public void FillColumnNames(ResultSetMetaData rsMetaData,
                            HashMap<String,Integer> results)

getStringIndex

public static String getStringIndex(int digitWidth,
                                    int index)

Returns the index represented as the required number of digit text. For example index with the value of 5 and a digitWidth of 3 means "005" and so on

Parameters:

digitWidth - the width of the required digits

Returns:

the index represented as the 3 digit text

handleDBError

public void handleDBError(Exception ex)

constructSingleParamProcedureCall

public static String constructSingleParamProcedureCall(String ProcedureName)

constructDoubleParamProcedureCall

public static String constructDoubleParamProcedureCall(String ProcedureName)

constructTrippleParamProcedureCall

public static String constructTrippleParamProcedureCall(String ProcedureName)

constructSingleParamFunctionCall

public static String constructSingleParamFunctionCall(String functionName)

constructDoubleParamFunctionCall

public static String constructDoubleParamFunctionCall(String functionName)

constructTrippleParamFunctionCall

public static String constructTrippleParamFunctionCall(String functionName)

constructMultiParamFunctionCall

public static String constructMultiParamFunctionCall(String functionName,
                                                     int paramsNo)

constructMultiParamProcedureCall

public static String constructMultiParamProcedureCall(String ProcedureName,
                                                      int paramsNo)

getParamsText

protected static String getParamsText(int paramsNo)

executeDoubleParamFunction

public void executeDoubleParamFunction(String function,
                                       String param1,
                                       String param2)

executeTrippleParamFunction

public void executeTrippleParamFunction(String function,
                                        String param1,
                                        String param2,
                                        String param3)

executeDoubleParamFunction

public void executeDoubleParamFunction(String function,
                                       int param1,
                                       int param2)

executeMultiParamProcedure

public void executeMultiParamProcedure(String procedure,
                                       String[] params)

executeDoubleParamProcedure

public void executeDoubleParamProcedure(String procedure,
                                        int param1,
                                        int param2)

executeDoubleParamProcedure

public void executeDoubleParamProcedure(String procedure,
                                        String param1,
                                        String param2)

executeTrippleParamProcedure

public void executeTrippleParamProcedure(String procedure,
                                         String param1,
                                         int param2,
                                         int param3)

getConnection

public Connection getConnection()

importFile

public void importFile(String targetTable,
                       String fileName)
                throws Exception

Throws:

Exception

getErrorCategory

public static int getErrorCategory(Exception ex)

createInsertSQL

public String createInsertSQL(String tableName)
                       throws SQLException

Throws:

SQLException

getTableCols

public Vector<TableColumn> getTableCols(String tableName)
                                 throws SQLException

Throws:

SQLException