Module seppiko.commons.utils

Package org.seppiko.commons.utils.jdbc

Class SQLExecutor

java.lang.Object

org.seppiko.commons.utils.jdbc.SQLExecutor

All Implemented Interfaces:

Closeable, AutoCloseable

public class SQLExecutor
extends Object
implements Closeable

SQL executor

Author:

Leonard Woo

Constructor Summary

Constructors

Constructor	Description
SQLExecutor(Connection conn)	Initialize SQL executor

Method Summary

Modifier and Type	Method	Description
void	close()	Close Connection
int	execute(String sql)	Execute INSERT UPDATE DELETE or other statement.
int	execute(String sql, Object... params)	Execute INSERT UPDATE DELETE or other statement.
long	executeWithGeneratedKey(String sql)	Execute INSERT UPDATE DELETE or other statement.
long	executeWithGeneratedKey(String sql, Object... params)	Execute INSERT UPDATE DELETE or other statement.
ResultSet	query(String sql)	Query Execute SELECT statement
ResultSet	query(String sql, Object... params)	Query Execute SELECT statement

Methods inherited from class java.lang.Object

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

Constructor Details

SQLExecutor

public SQLExecutor(Connection conn)
            throws NullPointerException

Initialize SQL executor

Parameters:

conn - the connection.

Throws:

NullPointerException - connection is null

Method Details

query

public ResultSet query(String sql)
                throws SQLException,
IllegalArgumentException

Query Execute SELECT statement

Parameters:

sql - SQL Statement.

Returns:

a ResultSet object that contains the data produced by the given query; never null

Throws:

SQLException - if a database access error occurs.

IllegalArgumentException - SQL is empty or null.

query

public ResultSet query(String sql,
 Object... params)
                throws SQLException,
IllegalArgumentException

Query Execute SELECT statement

Parameters:

sql - SQL Statement.

params - parameters.

Returns:

a ResultSet object that contains the data produced by the given query; never null

Throws:

SQLException - if a database access error occurs.

IllegalArgumentException - SQL is empty or null.

execute

public int execute(String sql)
            throws SQLException,
IllegalArgumentException

Execute INSERT UPDATE DELETE or other statement.

Parameters:

sql - SQL Statement.

Returns:

SQL execute row count.

Throws:

SQLException - if a database access error occurs.

IllegalArgumentException - SQL is empty or null.

execute

public int execute(String sql,
 Object... params)
            throws SQLException,
IllegalArgumentException

Execute INSERT UPDATE DELETE or other statement.

Parameters:

sql - SQL Statement.

params - parameters.

Returns:

SQL execute row count.

Throws:

SQLException - if a database access error occurs.

IllegalArgumentException - SQL is empty or null.

executeWithGeneratedKey

public long executeWithGeneratedKey(String sql)
                             throws SQLException,
IllegalArgumentException

Execute INSERT UPDATE DELETE or other statement. And return generated key.

Parameters:

sql - SQL Statement.

Returns:

auto-generated key, -1 is Fail, and 0 is not get key.

Throws:

SQLException - if a database access error occurs.

IllegalArgumentException - SQL is empty or null.

executeWithGeneratedKey

public long executeWithGeneratedKey(String sql,
 Object... params)
                             throws SQLException,
IllegalArgumentException

Execute INSERT UPDATE DELETE or other statement. And return generated key.

Parameters:

sql - SQL Statement.

params - parameters.

Returns:

auto-generated key, -1 is Fail, and 0 is not get key.

Throws:

SQLException - if a database access error occurs.

IllegalArgumentException - SQL is empty or null.

close

public void close()
           throws IOException

Close Connection

Specified by:

close in interface AutoCloseable

Specified by:

close in interface Closeable

Throws:

IOException - if a database access error occurs.