io.github.yeagy.bss

Interface BetterPreparedStatement

All Superinterfaces:

java.lang.AutoCloseable, java.sql.PreparedStatement, java.sql.Statement, java.sql.Wrapper

public interface BetterPreparedStatement
extends java.sql.PreparedStatement

Enhanced delegate class for PreparedStatement -- Null-safe primitive set methods -- Forwards connection create methods -- :named parameters -- java 8 time set methods

Field Summary

Fields inherited from interface java.sql.Statement

CLOSE_ALL_RESULTS, CLOSE_CURRENT_RESULT, EXECUTE_FAILED, KEEP_CURRENT_RESULT, NO_GENERATED_KEYS, RETURN_GENERATED_KEYS, SUCCESS_NO_INFO

Method Summary

Modifier and Type	Method and Description
static BetterPreparedStatement	create(java.sql.Connection connection, java.lang.String statement) use this factory method in order to use :named parameters.
static BetterPreparedStatement	create(java.sql.Connection connection, java.lang.String statement, boolean returnGeneratedKeys, boolean simulatedIn) use this factory method in order to use :named parameters.
java.sql.Array	createArray(java.util.Collection<?> elements)
java.sql.Array	createArray(java.lang.Object[] elements)
java.sql.Array	createArrayOf(java.lang.String typeName, java.lang.Object[] elements)
java.sql.Blob	createBlob()
java.sql.Clob	createClob()
java.sql.NClob	createNClob()
java.sql.SQLXML	createSQLXML()
void	setArray(int parameterIndex, java.util.Collection<?> x)
void	setArray(int parameterIndex, java.lang.Object[] x)
void	setArray(java.lang.String namedParameter, java.sql.Array x)
void	setArray(java.lang.String namedParameter, java.util.Collection<?> x)
void	setArray(java.lang.String namedParameter, java.lang.Object[] x)
void	setAsciiStream(java.lang.String namedParameter, java.io.InputStream x)
void	setAsciiStream(java.lang.String namedParameter, java.io.InputStream x, int length)
void	setAsciiStream(java.lang.String namedParameter, java.io.InputStream x, long length)
void	setBigDecimal(java.lang.String namedParameter, java.math.BigDecimal x)
void	setBinaryStream(java.lang.String namedParameter, java.io.InputStream x)
void	setBinaryStream(java.lang.String namedParameter, java.io.InputStream x, int length)
void	setBinaryStream(java.lang.String namedParameter, java.io.InputStream x, long length)
void	setBlob(java.lang.String namedParameter, java.sql.Blob x)
void	setBlob(java.lang.String namedParameter, java.io.InputStream inputStream)
void	setBlob(java.lang.String namedParameter, java.io.InputStream inputStream, long length)
void	setBoolean(java.lang.String namedParameter, boolean x)
void	setBooleanNullable(int parameterIndex, java.lang.Boolean x)
void	setBooleanNullable(java.lang.String namedParameter, java.lang.Boolean x)
void	setByte(java.lang.String namedParameter, byte x)
void	setByteNullable(int parameterIndex, java.lang.Byte x)
void	setByteNullable(java.lang.String namedParameter, java.lang.Byte x)
void	setBytes(java.lang.String namedParameter, byte[] x)
void	setCharacterStream(java.lang.String namedParameter, java.io.Reader reader)
void	setCharacterStream(java.lang.String namedParameter, java.io.Reader reader, int length)
void	setCharacterStream(java.lang.String namedParameter, java.io.Reader reader, long length)
void	setClob(java.lang.String namedParameter, java.sql.Clob x)
void	setClob(java.lang.String namedParameter, java.io.Reader reader)
void	setClob(java.lang.String namedParameter, java.io.Reader reader, long length)
void	setDate(int parameterIndex, java.time.LocalDate x)
void	setDate(java.lang.String namedParameter, java.sql.Date x)
void	setDate(java.lang.String namedParameter, java.sql.Date x, java.util.Calendar cal)
void	setDate(java.lang.String namedParameter, java.time.LocalDate x)
void	setDouble(java.lang.String namedParameter, double x)
void	setDoubleNullable(int parameterIndex, java.lang.Double x)
void	setDoubleNullable(java.lang.String namedParameter, java.lang.Double x)
void	setFloat(java.lang.String namedParameter, float x)
void	setFloatNullable(int parameterIndex, java.lang.Float x)
void	setFloatNullable(java.lang.String namedParameter, java.lang.Float x)
void	setInt(java.lang.String namedParameter, int x)
void	setIntNullable(int parameterIndex, java.lang.Integer x)
void	setIntNullable(java.lang.String namedParameter, java.lang.Integer x)
void	setLong(java.lang.String namedParameter, long x)
void	setLongNullable(int parameterIndex, java.lang.Long x)
void	setLongNullable(java.lang.String namedParameter, java.lang.Long x)
void	setNCharacterStream(java.lang.String namedParameter, java.io.Reader value)
void	setNCharacterStream(java.lang.String namedParameter, java.io.Reader value, long length)
void	setNClob(java.lang.String namedParameter, java.sql.NClob value)
void	setNClob(java.lang.String namedParameter, java.io.Reader reader)
void	setNClob(java.lang.String namedParameter, java.io.Reader reader, long length)
void	setNString(java.lang.String namedParameter, java.lang.String value)
void	setNull(java.lang.String namedParameter, int sqlType)
void	setNull(java.lang.String namedParameter, int sqlType, java.lang.String typeName)
void	setObject(java.lang.String namedParameter, java.lang.Object x)
void	setObject(java.lang.String namedParameter, java.lang.Object x, int targetSqlType)
void	setObject(java.lang.String namedParameter, java.lang.Object x, int targetSqlType, int scaleOrLength)
void	setObject(java.lang.String namedParameter, java.lang.Object x, java.sql.SQLType targetSqlType)
void	setObject(java.lang.String namedParameter, java.lang.Object x, java.sql.SQLType targetSqlType, int scaleOrLength)
void	setRef(java.lang.String namedParameter, java.sql.Ref x)
void	setRowId(java.lang.String namedParameter, java.sql.RowId x)
void	setShort(java.lang.String namedParameter, short x)
void	setShortNullable(int parameterIndex, java.lang.Short x)
void	setShortNullable(java.lang.String namedParameter, java.lang.Short x)
void	setSQLXML(java.lang.String namedParameter, java.sql.SQLXML xmlObject)
void	setString(java.lang.String namedParameter, java.lang.String x)
void	setTime(int parameterIndex, java.time.LocalTime x)
void	setTime(java.lang.String namedParameter, java.time.LocalTime x)
void	setTime(java.lang.String namedParameter, java.sql.Time x)
void	setTime(java.lang.String namedParameter, java.sql.Time x, java.util.Calendar cal)
void	setTimestamp(int parameterIndex, java.time.Instant x)
void	setTimestamp(int parameterIndex, java.time.LocalDateTime x)
void	setTimestamp(int parameterIndex, java.time.OffsetDateTime x)
void	setTimestamp(java.lang.String namedParameter, java.time.Instant x)
void	setTimestamp(java.lang.String namedParameter, java.time.LocalDateTime x)
void	setTimestamp(java.lang.String namedParameter, java.time.OffsetDateTime x)
void	setTimestamp(java.lang.String namedParameter, java.sql.Timestamp x)
void	setTimestamp(java.lang.String namedParameter, java.sql.Timestamp x, java.util.Calendar cal)
void	setURL(java.lang.String namedParameter, java.net.URL x)

Methods inherited from interface java.sql.PreparedStatement

addBatch, clearParameters, execute, executeLargeUpdate, executeQuery, executeUpdate, getMetaData, getParameterMetaData, setArray, setAsciiStream, setAsciiStream, setAsciiStream, setBigDecimal, setBinaryStream, setBinaryStream, setBinaryStream, setBlob, setBlob, setBlob, setBoolean, setByte, setBytes, setCharacterStream, setCharacterStream, setCharacterStream, setClob, setClob, setClob, setDate, setDate, setDouble, setFloat, setInt, setLong, setNCharacterStream, setNCharacterStream, setNClob, setNClob, setNClob, setNString, setNull, setNull, setObject, setObject, setObject, setObject, setObject, setRef, setRowId, setShort, setSQLXML, setString, setTime, setTime, setTimestamp, setTimestamp, setUnicodeStream, setURL

Methods inherited from interface java.sql.Statement

addBatch, cancel, clearBatch, clearWarnings, close, closeOnCompletion, execute, execute, execute, execute, executeBatch, executeLargeBatch, executeLargeUpdate, executeLargeUpdate, executeLargeUpdate, executeLargeUpdate, executeQuery, executeUpdate, executeUpdate, executeUpdate, executeUpdate, getConnection, getFetchDirection, getFetchSize, getGeneratedKeys, getLargeMaxRows, getLargeUpdateCount, getMaxFieldSize, getMaxRows, getMoreResults, getMoreResults, getQueryTimeout, getResultSet, getResultSetConcurrency, getResultSetHoldability, getResultSetType, getUpdateCount, getWarnings, isClosed, isCloseOnCompletion, isPoolable, setCursorName, setEscapeProcessing, setFetchDirection, setFetchSize, setLargeMaxRows, setMaxFieldSize, setMaxRows, setPoolable, setQueryTimeout

Methods inherited from interface java.sql.Wrapper

isWrapperFor, unwrap

Method Detail

create

static BetterPreparedStatement create(java.sql.Connection connection,
                                      java.lang.String statement)
                               throws java.sql.SQLException

use this factory method in order to use :named parameters. also works with standard ? params. this method does not return generated keys or attempt IN clause array simulation

Parameters:

connection - close this yourself.

statement - your sql statement

Returns:

BetterPreparedStatement

Throws:

java.sql.SQLException - from JDBC

create

static BetterPreparedStatement create(java.sql.Connection connection,
                                      java.lang.String statement,
                                      boolean returnGeneratedKeys,
                                      boolean simulatedIn)
                               throws java.sql.SQLException

use this factory method in order to use :named parameters. also works with standard ? params. IN clause array simulation: This will allow use of the setArray methods without DB array support. This uses parameter expansion at the time of the setArray call, by the array size. This is safe to use with statements that do not have an IN clause.

Parameters:

connection - close this yourself.

statement - your sql statement

returnGeneratedKeys - true if you want to return generated keys

simulatedIn - true if you want IN clause array simulation

Returns:

BetterPreparedStatement

Throws:

java.sql.SQLException - from JDBC

createBlob

java.sql.Blob createBlob()
                  throws java.sql.SQLException

Throws:

java.sql.SQLException

createClob

java.sql.Clob createClob()
                  throws java.sql.SQLException

Throws:

java.sql.SQLException

createNClob

java.sql.NClob createNClob()
                    throws java.sql.SQLException

Throws:

java.sql.SQLException

createSQLXML

java.sql.SQLXML createSQLXML()
                      throws java.sql.SQLException

Throws:

java.sql.SQLException

createArrayOf

java.sql.Array createArrayOf(java.lang.String typeName,
                             java.lang.Object[] elements)
                      throws java.sql.SQLException

Throws:

java.sql.SQLException

createArray

java.sql.Array createArray(java.lang.Object[] elements)
                    throws java.sql.SQLException

Throws:

java.sql.SQLException

createArray

java.sql.Array createArray(java.util.Collection<?> elements)
                    throws java.sql.SQLException

Throws:

java.sql.SQLException

setArray

void setArray(int parameterIndex,
              java.util.Collection<?> x)
       throws java.sql.SQLException

Throws:

java.sql.SQLException

setArray

void setArray(java.lang.String namedParameter,
              java.util.Collection<?> x)
       throws java.sql.SQLException

Throws:

java.sql.SQLException

setArray

void setArray(int parameterIndex,
              java.lang.Object[] x)
       throws java.sql.SQLException

Throws:

java.sql.SQLException

setArray

void setArray(java.lang.String namedParameter,
              java.lang.Object[] x)
       throws java.sql.SQLException

Throws:

java.sql.SQLException

setTime

void setTime(int parameterIndex,
             java.time.LocalTime x)
      throws java.sql.SQLException

Throws:

java.sql.SQLException

setTime

void setTime(java.lang.String namedParameter,
             java.time.LocalTime x)
      throws java.sql.SQLException

Throws:

java.sql.SQLException

setDate

void setDate(int parameterIndex,
             java.time.LocalDate x)
      throws java.sql.SQLException

Throws:

java.sql.SQLException

setDate

void setDate(java.lang.String namedParameter,
             java.time.LocalDate x)
      throws java.sql.SQLException

Throws:

java.sql.SQLException

setTimestamp

void setTimestamp(int parameterIndex,
                  java.time.LocalDateTime x)
           throws java.sql.SQLException

Throws:

java.sql.SQLException

setTimestamp

void setTimestamp(java.lang.String namedParameter,
                  java.time.LocalDateTime x)
           throws java.sql.SQLException

Throws:

java.sql.SQLException

setTimestamp

void setTimestamp(int parameterIndex,
                  java.time.OffsetDateTime x)
           throws java.sql.SQLException

Throws:

java.sql.SQLException

setTimestamp

void setTimestamp(java.lang.String namedParameter,
                  java.time.OffsetDateTime x)
           throws java.sql.SQLException

Throws:

java.sql.SQLException

setTimestamp

void setTimestamp(int parameterIndex,
                  java.time.Instant x)
           throws java.sql.SQLException

Throws:

java.sql.SQLException

setTimestamp

void setTimestamp(java.lang.String namedParameter,
                  java.time.Instant x)
           throws java.sql.SQLException

Throws:

java.sql.SQLException

setNull

void setNull(java.lang.String namedParameter,
             int sqlType)
      throws java.sql.SQLException

Throws:

java.sql.SQLException

setBoolean

void setBoolean(java.lang.String namedParameter,
                boolean x)
         throws java.sql.SQLException

Throws:

java.sql.SQLException

setByte

void setByte(java.lang.String namedParameter,
             byte x)
      throws java.sql.SQLException

Throws:

java.sql.SQLException

setShort

void setShort(java.lang.String namedParameter,
              short x)
       throws java.sql.SQLException

Throws:

java.sql.SQLException

setInt

void setInt(java.lang.String namedParameter,
            int x)
     throws java.sql.SQLException

Throws:

java.sql.SQLException

setLong

void setLong(java.lang.String namedParameter,
             long x)
      throws java.sql.SQLException

Throws:

java.sql.SQLException

setFloat

void setFloat(java.lang.String namedParameter,
              float x)
       throws java.sql.SQLException

Throws:

java.sql.SQLException

setDouble

void setDouble(java.lang.String namedParameter,
               double x)
        throws java.sql.SQLException

Throws:

java.sql.SQLException

setBigDecimal

void setBigDecimal(java.lang.String namedParameter,
                   java.math.BigDecimal x)
            throws java.sql.SQLException

Throws:

java.sql.SQLException

setString

void setString(java.lang.String namedParameter,
               java.lang.String x)
        throws java.sql.SQLException

Throws:

java.sql.SQLException

setBytes

void setBytes(java.lang.String namedParameter,
              byte[] x)
       throws java.sql.SQLException

Throws:

java.sql.SQLException

setDate

void setDate(java.lang.String namedParameter,
             java.sql.Date x)
      throws java.sql.SQLException

Throws:

java.sql.SQLException

setTime

void setTime(java.lang.String namedParameter,
             java.sql.Time x)
      throws java.sql.SQLException

Throws:

java.sql.SQLException

setTimestamp

void setTimestamp(java.lang.String namedParameter,
                  java.sql.Timestamp x)
           throws java.sql.SQLException

Throws:

java.sql.SQLException

setAsciiStream

void setAsciiStream(java.lang.String namedParameter,
                    java.io.InputStream x,
                    int length)
             throws java.sql.SQLException

Throws:

java.sql.SQLException

setBinaryStream

void setBinaryStream(java.lang.String namedParameter,
                     java.io.InputStream x,
                     int length)
              throws java.sql.SQLException

Throws:

java.sql.SQLException

setObject

void setObject(java.lang.String namedParameter,
               java.lang.Object x,
               int targetSqlType)
        throws java.sql.SQLException

Throws:

java.sql.SQLException

setObject

void setObject(java.lang.String namedParameter,
               java.lang.Object x)
        throws java.sql.SQLException

Throws:

java.sql.SQLException

setCharacterStream

void setCharacterStream(java.lang.String namedParameter,
                        java.io.Reader reader,
                        int length)
                 throws java.sql.SQLException

Throws:

java.sql.SQLException

setRef

void setRef(java.lang.String namedParameter,
            java.sql.Ref x)
     throws java.sql.SQLException

Throws:

java.sql.SQLException

setBlob

void setBlob(java.lang.String namedParameter,
             java.sql.Blob x)
      throws java.sql.SQLException

Throws:

java.sql.SQLException

setClob

void setClob(java.lang.String namedParameter,
             java.sql.Clob x)
      throws java.sql.SQLException

Throws:

java.sql.SQLException

setArray

void setArray(java.lang.String namedParameter,
              java.sql.Array x)
       throws java.sql.SQLException

Throws:

java.sql.SQLException

setDate

void setDate(java.lang.String namedParameter,
             java.sql.Date x,
             java.util.Calendar cal)
      throws java.sql.SQLException

Throws:

java.sql.SQLException

setTime

void setTime(java.lang.String namedParameter,
             java.sql.Time x,
             java.util.Calendar cal)
      throws java.sql.SQLException

Throws:

java.sql.SQLException

setTimestamp

void setTimestamp(java.lang.String namedParameter,
                  java.sql.Timestamp x,
                  java.util.Calendar cal)
           throws java.sql.SQLException

Throws:

java.sql.SQLException

setNull

void setNull(java.lang.String namedParameter,
             int sqlType,
             java.lang.String typeName)
      throws java.sql.SQLException

Throws:

java.sql.SQLException

setURL

void setURL(java.lang.String namedParameter,
            java.net.URL x)
     throws java.sql.SQLException

Throws:

java.sql.SQLException

setRowId

void setRowId(java.lang.String namedParameter,
              java.sql.RowId x)
       throws java.sql.SQLException

Throws:

java.sql.SQLException

setNString

void setNString(java.lang.String namedParameter,
                java.lang.String value)
         throws java.sql.SQLException

Throws:

java.sql.SQLException

setNCharacterStream

void setNCharacterStream(java.lang.String namedParameter,
                         java.io.Reader value,
                         long length)
                  throws java.sql.SQLException

Throws:

java.sql.SQLException

setNClob

void setNClob(java.lang.String namedParameter,
              java.sql.NClob value)
       throws java.sql.SQLException

Throws:

java.sql.SQLException

setClob

void setClob(java.lang.String namedParameter,
             java.io.Reader reader,
             long length)
      throws java.sql.SQLException

Throws:

java.sql.SQLException

setBlob

void setBlob(java.lang.String namedParameter,
             java.io.InputStream inputStream,
             long length)
      throws java.sql.SQLException

Throws:

java.sql.SQLException

setNClob

void setNClob(java.lang.String namedParameter,
              java.io.Reader reader,
              long length)
       throws java.sql.SQLException

Throws:

java.sql.SQLException

setSQLXML

void setSQLXML(java.lang.String namedParameter,
               java.sql.SQLXML xmlObject)
        throws java.sql.SQLException

Throws:

java.sql.SQLException

setObject

void setObject(java.lang.String namedParameter,
               java.lang.Object x,
               int targetSqlType,
               int scaleOrLength)
        throws java.sql.SQLException

Throws:

java.sql.SQLException

setAsciiStream

void setAsciiStream(java.lang.String namedParameter,
                    java.io.InputStream x,
                    long length)
             throws java.sql.SQLException

Throws:

java.sql.SQLException

setBinaryStream

void setBinaryStream(java.lang.String namedParameter,
                     java.io.InputStream x,
                     long length)
              throws java.sql.SQLException

Throws:

java.sql.SQLException

setCharacterStream

void setCharacterStream(java.lang.String namedParameter,
                        java.io.Reader reader,
                        long length)
                 throws java.sql.SQLException

Throws:

java.sql.SQLException

setAsciiStream

void setAsciiStream(java.lang.String namedParameter,
                    java.io.InputStream x)
             throws java.sql.SQLException

Throws:

java.sql.SQLException

setBinaryStream

void setBinaryStream(java.lang.String namedParameter,
                     java.io.InputStream x)
              throws java.sql.SQLException

Throws:

java.sql.SQLException

setCharacterStream

void setCharacterStream(java.lang.String namedParameter,
                        java.io.Reader reader)
                 throws java.sql.SQLException

Throws:

java.sql.SQLException

setNCharacterStream

void setNCharacterStream(java.lang.String namedParameter,
                         java.io.Reader value)
                  throws java.sql.SQLException

Throws:

java.sql.SQLException

setClob

void setClob(java.lang.String namedParameter,
             java.io.Reader reader)
      throws java.sql.SQLException

Throws:

java.sql.SQLException

setBlob

void setBlob(java.lang.String namedParameter,
             java.io.InputStream inputStream)
      throws java.sql.SQLException

Throws:

java.sql.SQLException

setNClob

void setNClob(java.lang.String namedParameter,
              java.io.Reader reader)
       throws java.sql.SQLException

Throws:

java.sql.SQLException

setObject

void setObject(java.lang.String namedParameter,
               java.lang.Object x,
               java.sql.SQLType targetSqlType,
               int scaleOrLength)
        throws java.sql.SQLException

Throws:

java.sql.SQLException

setObject

void setObject(java.lang.String namedParameter,
               java.lang.Object x,
               java.sql.SQLType targetSqlType)
        throws java.sql.SQLException

Throws:

java.sql.SQLException

setBooleanNullable

void setBooleanNullable(java.lang.String namedParameter,
                        java.lang.Boolean x)
                 throws java.sql.SQLException

Throws:

java.sql.SQLException

setByteNullable

void setByteNullable(java.lang.String namedParameter,
                     java.lang.Byte x)
              throws java.sql.SQLException

Throws:

java.sql.SQLException

setShortNullable

void setShortNullable(java.lang.String namedParameter,
                      java.lang.Short x)
               throws java.sql.SQLException

Throws:

java.sql.SQLException

setIntNullable

void setIntNullable(java.lang.String namedParameter,
                    java.lang.Integer x)
             throws java.sql.SQLException

Throws:

java.sql.SQLException

setLongNullable

void setLongNullable(java.lang.String namedParameter,
                     java.lang.Long x)
              throws java.sql.SQLException

Throws:

java.sql.SQLException

setFloatNullable

void setFloatNullable(java.lang.String namedParameter,
                      java.lang.Float x)
               throws java.sql.SQLException

Throws:

java.sql.SQLException

setDoubleNullable

void setDoubleNullable(java.lang.String namedParameter,
                       java.lang.Double x)
                throws java.sql.SQLException

Throws:

java.sql.SQLException

setBooleanNullable

void setBooleanNullable(int parameterIndex,
                        java.lang.Boolean x)
                 throws java.sql.SQLException

Throws:

java.sql.SQLException

setByteNullable

void setByteNullable(int parameterIndex,
                     java.lang.Byte x)
              throws java.sql.SQLException

Throws:

java.sql.SQLException

setShortNullable

void setShortNullable(int parameterIndex,
                      java.lang.Short x)
               throws java.sql.SQLException

Throws:

java.sql.SQLException

setIntNullable

void setIntNullable(int parameterIndex,
                    java.lang.Integer x)
             throws java.sql.SQLException

Throws:

java.sql.SQLException

setLongNullable

void setLongNullable(int parameterIndex,
                     java.lang.Long x)
              throws java.sql.SQLException

Throws:

java.sql.SQLException

setFloatNullable

void setFloatNullable(int parameterIndex,
                      java.lang.Float x)
               throws java.sql.SQLException

Throws:

java.sql.SQLException

setDoubleNullable

void setDoubleNullable(int parameterIndex,
                       java.lang.Double x)
                throws java.sql.SQLException

Throws:

java.sql.SQLException