PreparedStatement (Java 2 Platform SE 5.0)

주: IN 파라미터값를 설정하는 설정 기능 메서드 (setShort, setString 등)는 입력 파라미터의 정의된 SQL 형과 호환이 있는 형태를 지정하지 않으면 안됩니다. 예를 들어 IN 파라미터에 INTEGER 라고 하는 SQL 형이 있는 경우, setInt 메서드를 사용하지 않으면 안됩니다.

임의의 파라미터형 변환이 필요한 경우는 setObject 메서드는 목적의 SQL 형으로 사용하지 않으면 안됩니다.

파라미터 설정의 예를 다음에 나타냅니다. con는 활성화된 접속을 나타냅니다.

 PreparedStatement pstmt = con.prepareStatement("UPDATE EMPLOYEES SET SALARY = ?  WHERE ID = ? "); pstmt.setBigDecimal(1, 153833.00) pstmt.setInt(2, 110592)

관련 항목:: Connection.prepareStatement(java.lang.String), ResultSet

필드 개요

인터페이스 java.sql. Statement 로부터 상속된 필드
`CLOSE_ALL_RESULTS, CLOSE_CURRENT_RESULT, EXECUTE_FAILED, KEEP_CURRENT_RESULT, NO_GENERATED_KEYS, RETURN_GENERATED_KEYS, SUCCESS_NO_INFO`

메서드 개요
`void`	`addBatch ()` 이 `PreparedStatement` 객체의 커멘드의 배치에 파라미터세트를 추가합니다.
`void`	`clearParameters ()` 현재의 파라미터값를 곧바로 클리어 합니다.
`boolean`	`execute ()` 이 `PreparedStatement` 객체의, 모든 종류의 SQL 문을 실행합니다.
`ResultSet`	`executeQuery ()` 이 `PreparedStatement` 객체의 SQL 쿼리를 실행해, 그 쿼리에 의해 생성된 `ResultSet` 객체를 리턴합니다.
`int`	`executeUpdate ()` 이 `PreparedStatement` 객체의 SQL `INSERT` 문, `UPDATE` 문, 또는 `DELETE` 문을 실행합니다.
`ResultSetMetaData`	`getMetaData ()` 이 `PreparedStatement`이 실행될 때 리턴된 `ResultSet` 객체의 열에 관한 정보를 포함하는 `ResultSetMetaData` 객체를 취득합니다.
`ParameterMetaData`	`getParameterMetaData ()` 이 `PreparedStatement` 객체의 파라미터의 수, 형태 및 프로퍼티를 취득합니다.
`void`	`setArray (int i, Array x)` 지정된 파라미터가 지정된 `Array` 객체로 설정합니다.
`void`	`setAsciiStream (int parameterIndex, InputStream x, int length)` 지정된 파라미터를, 지정된 바이트수를 가지는 지정된 입력 스트림로 설정합니다.
`void`	`setBigDecimal (int parameterIndex, BigDecimal x)` 지정된 파라미터가 지정된 `java.math.BigDecimal`값으로 설정합니다.
`void`	`setBinaryStream (int parameterIndex, InputStream x, int length)` 지정된 파라미터를, 지정된 바이트수를 가지는 지정된 입력 스트림로 설정합니다.
`void`	`setBlob (int i, Blob x)` 지정된 파라미터가 지정된 `Blob` 객체로 설정합니다.
`void`	`setBoolean (int parameterIndex, boolean x)` 지정된 파라미터가 지정된 Java `boolean`값으로 설정합니다.
`void`	`setByte (int parameterIndex, byte x)` 지정된 파라미터가 지정된 Java `byte`값으로 설정합니다.
`void`	`setBytes (int parameterIndex, byte[] x)` 지정된 파라미터가 지정된 Java 바이트 배열로 설정합니다.
`void`	`setCharacterStream (int parameterIndex, Reader reader, int length)` 지정된 파라미터를, 지정된 문자수인 지정된 `Reader` 객체로 설정합니다.
`void`	`setClob (int i, Clob x)` 지정된 파라미터가 지정된 `Clob` 객체로 설정합니다.
`void`	`setDate (int parameterIndex, Date x)` 지정된 파라미터가 지정된 `java.sql.Date`값으로 설정합니다.
`void`	`setDate (int parameterIndex, Date x, Calendar cal)` 지정된 `Calendar` 객체를 사용해, 지정된 파라미터가 지정된 `java.sql.Date`값으로 설정합니다.
`void`	`setDouble (int parameterIndex, double x)` 지정된 파라미터가 지정된 Java `double`값으로 설정합니다.
`void`	`setFloat (int parameterIndex, float x)` 지정된 파라미터가 지정된 Java `float`값으로 설정합니다.
`void`	`setInt (int parameterIndex, int x)` 지정된 파라미터가 지정된 Java `int`값으로 설정합니다.
`void`	`setLong (int parameterIndex, long x)` 지정된 파라미터가 지정된 Java `long`값으로 설정합니다.
`void`	`setNull (int parameterIndex, int sqlType)` 지정된 파라미터를 SQL `NULL`로 설정합니다.
`void`	`setNull (int paramIndex, int sqlType, String typeName)` 지정된 파라미터를 SQL `NULL`로 설정합니다.
`void`	`setObject (int parameterIndex, Object x)` 지정된 파라미터의 값을 지정된 객체를 사용해 설정합니다.
`void`	`setObject (int parameterIndex, Object x, int targetSqlType)` 지정된 파라미터의 값을 지정된 객체로 설정합니다.
`void`	`setObject (int parameterIndex, Object x, int targetSqlType, int scale)` 지정된 파라미터의 값을 지정된 객체를 사용해 설정합니다.
`void`	`setRef (int i, Ref x)` 지정된 파라미터가 지정된 `REF(<structured-type>)`값으로 설정합니다.
`void`	`setShort (int parameterIndex, short x)` 지정된 파라미터가 지정된 Java `short`값으로 설정합니다.
`void`	`setString (int parameterIndex, String x)` 지정된 파라미터가 지정된 Java `String`값으로 설정합니다.
`void`	`setTime (int parameterIndex, Time x)` 지정된 파라미터가 지정된 `java.sql.Time`값으로 설정합니다.
`void`	`setTime (int parameterIndex, Time x, Calendar cal)` 지정된 `Calendar` 객체를 사용해, 지정된 파라미터가 지정된 `java.sql.Time`값으로 설정합니다.
`void`	`setTimestamp (int parameterIndex, Timestamp x)` 지정된 파라미터가 지정된 `java.sql.Timestamp`값으로 설정합니다.
`void`	`setTimestamp (int parameterIndex, Timestamp x, Calendar cal)` 지정된 `Calendar` 객체를 사용해, 지정된 파라미터가 지정된 `java.sql.Timestamp`값으로 설정합니다.
`void`	`setUnicodeStream (int parameterIndex, InputStream x, int length)` 추천하지 않습니다.
`void`	`setURL (int parameterIndex, URL x)` 지정된 파라미터가 지정된 `java.net.URL`값으로 설정합니다.

인터페이스 java.sql. Statement 로부터 상속된 메서드
addBatch, cancel, clearBatch, clearWarnings, close, execute, execute, execute, execute, executeBatch, executeQuery, executeUpdate, executeUpdate, executeUpdate, executeUpdate, getConnection, getFetchDirection, getFetchSize, getGeneratedKeys, getMaxFieldSize, getMaxRows, getMoreResults, getMoreResults, getQueryTimeout, getResultSet, getResultSetConcurrency, getResultSetHoldability, getResultSetType, getUpdateCount, getWarnings, setCursorName, setEscapeProcessing, setFetchDirection, setFetchSize, setMaxFieldSize, setMaxRows, setQueryTimeout

인터페이스 java.sql. Statement 로부터 상속된 메서드

addBatch,
 cancel,
 clearBatch,
 clearWarnings,
 close,
 execute,
 execute,
 execute,
 execute,
 executeBatch,
 executeQuery,
 executeUpdate,
 executeUpdate,
 executeUpdate,
 executeUpdate,
 getConnection,
 getFetchDirection,
 getFetchSize,
 getGeneratedKeys,
 getMaxFieldSize,
 getMaxRows,
 getMoreResults,
 getMoreResults,
 getQueryTimeout,
 getResultSet,
 getResultSetConcurrency,
 getResultSetHoldability,
 getResultSetType,
 getUpdateCount,
 getWarnings,
 setCursorName,
 setEscapeProcessing,
 setFetchDirection,
 setFetchSize,
 setMaxFieldSize,
 setMaxRows,
 setQueryTimeout

메서드의 상세

executeQuery

ResultSet  executeQuery()
                       throws SQLException

이 PreparedStatement 객체의 SQL 쿼리를 실행해, 그 쿼리에 의해 생성된 ResultSet 객체를 리턴합니다.

반환값:: 쿼리에 의해 작성된 데이터를 포함한 ResultSet 객체. null은 되지 않는다
예외:: SQLException - 데이타베이스 액세스 에러가 발생했을 경우, 또는 SQL 문이 ResultSet 객체를 돌려주지 않는 경우

executeUpdate

int executeUpdate()
                  throws SQLException

이 PreparedStatement 객체의 SQL INSERT 문, UPDATE 문, 또는 DELETE 문을 실행합니다. 게다가 DDL 문과 같은 아무것도 돌려주지 않는 SQL 문을 실행할 수도 있습니다.

반환값:: INSERT 문, UPDATE 문, DELETE 문의 경우는 행수. 아무것도 돌려주지 않는 SQL 문의 경우는 0
예외:: SQLException - 데이타베이스 액세스 에러가 발생했을 경우, 또는 SQL 문이 ResultSet 객체를 돌려주는 경우

setNull

void setNull(int parameterIndex,
             int sqlType)
             throws SQLException

지정된 파라미터를 SQL NULL로 설정합니다.

주: 파라미터의 SQL 형태를 지정할 필요가 있습니다.

파라미터:: parameterIndex - 최초의 파라미터는 1, 2번째의 파라미터는 2,... 되는; sqlType - java.sql.Types로 정의되는 SQL 형 코드
예외:: SQLException - 데이타베이스 액세스 에러가 발생했을 경우

setBoolean

void setBoolean(int parameterIndex,
                boolean x)
                throws SQLException

지정된 파라미터가 지정된 Java boolean값으로 설정합니다. 데이타베이스에 보낼 때에 드라이버는 이것을 SQL BIT값으로 변환합니다.

파라미터:: parameterIndex - 최초의 파라미터는 1, 2번째의 파라미터는 2,... 되는; x - 파라미터값
예외:: SQLException - 데이타베이스 액세스 에러가 발생했을 경우

setByte

void setByte(int parameterIndex,
             byte x)
             throws SQLException

지정된 파라미터가 지정된 Java byte값으로 설정합니다. 데이타베이스에 보낼 때에 드라이버는 이것을 SQL TINYINT값으로 변환합니다.

파라미터:: parameterIndex - 최초의 파라미터는 1, 2번째의 파라미터는 2,... 되는; x - 파라미터값
예외:: SQLException - 데이타베이스 액세스 에러가 발생했을 경우

setShort

void setShort(int parameterIndex,
              short x)
              throws SQLException

지정된 파라미터가 지정된 Java short값으로 설정합니다. 데이타베이스에 보낼 때에 드라이버는 이것을 SQL SMALLINT값으로 변환합니다.

파라미터:: parameterIndex - 최초의 파라미터는 1, 2번째의 파라미터는 2,... 되는; x - 파라미터값
예외:: SQLException - 데이타베이스 액세스 에러가 발생했을 경우

setInt

void setInt(int parameterIndex,
            int x)
            throws SQLException

지정된 파라미터가 지정된 Java int값으로 설정합니다. 데이타베이스에 보낼 때에 드라이버는 이것을 SQL INTEGER값으로 변환합니다.

파라미터:: parameterIndex - 최초의 파라미터는 1, 2번째의 파라미터는 2,... 되는; x - 파라미터값
예외:: SQLException - 데이타베이스 액세스 에러가 발생했을 경우

setLong

void setLong(int parameterIndex,
             long x)
             throws SQLException

지정된 파라미터가 지정된 Java long값으로 설정합니다. 데이타베이스에 보낼 때에 드라이버는 이것을 SQL BIGINT값으로 변환합니다.

파라미터:: parameterIndex - 최초의 파라미터는 1, 2번째의 파라미터는 2,... 되는; x - 파라미터값
예외:: SQLException - 데이타베이스 액세스 에러가 발생했을 경우

setFloat

void setFloat(int parameterIndex,
              float x)
              throws SQLException

지정된 파라미터가 지정된 Java float값으로 설정합니다. 데이타베이스에 보낼 때에 드라이버는 이것을 SQL FLOAT값으로 변환합니다.

파라미터:: parameterIndex - 최초의 파라미터는 1, 2번째의 파라미터는 2,... 되는; x - 파라미터값
예외:: SQLException - 데이타베이스 액세스 에러가 발생했을 경우

setDouble

void setDouble(int parameterIndex,
               double x)
               throws SQLException

지정된 파라미터가 지정된 Java double값으로 설정합니다. 데이타베이스에 보낼 때에 드라이버는 이것을 SQL DOUBLE값으로 변환합니다.

파라미터:: parameterIndex - 최초의 파라미터는 1, 2번째의 파라미터는 2,... 되는; x - 파라미터값
예외:: SQLException - 데이타베이스 액세스 에러가 발생했을 경우

setBigDecimal

void setBigDecimal(int parameterIndex,
                   BigDecimal  x)
                   throws SQLException

지정된 파라미터가 지정된 java.math.BigDecimal값으로 설정합니다. 데이타베이스에 보낼 때에 드라이버는 이것을 SQL NUMERIC값으로 변환합니다.

파라미터:: parameterIndex - 최초의 파라미터는 1, 2번째의 파라미터는 2,... 되는; x - 파라미터값
예외:: SQLException - 데이타베이스 액세스 에러가 발생했을 경우

setString

void setString(int parameterIndex,
               String  x)
               throws SQLException

지정된 파라미터가 지정된 Java String값으로 설정합니다. 데이타베이스에 보낼 때에 드라이버는 이것을 SQL VARCHAR 또는 LONGVARCHAR 치 (드라이버의 VARCHAR 치에 관한 제한에 관한 인수의 사이즈에 존)로 변환합니다.

파라미터:: parameterIndex - 최초의 파라미터는 1, 2번째의 파라미터는 2,... 되는; x - 파라미터값
예외:: SQLException - 데이타베이스 액세스 에러가 발생했을 경우

setBytes

void setBytes(int parameterIndex,
              byte[] x)
              throws SQLException

지정된 파라미터가 지정된 Java 바이트 배열로 설정합니다. 데이타베이스에 보낼 때에 드라이버는 이것을 SQL VARBINARY 또는 LONGVARBINARY (드라이버의 VARBINARY 치에 관한 제한에 관한 인수의 사이즈에 존)로 변환합니다.

파라미터:: parameterIndex - 최초의 파라미터는 1, 2번째의 파라미터는 2,... 되는; x - 파라미터값
예외:: SQLException - 데이타베이스 액세스 에러가 발생했을 경우

setDate

void setDate(int parameterIndex,
             Date  x)
             throws SQLException

지정된 파라미터가 지정된 java.sql.Date값으로 설정합니다. 데이타베이스에 보낼 때에 드라이버는 이것을 SQL DATE값으로 변환합니다.

파라미터:: parameterIndex - 최초의 파라미터는 1, 2번째의 파라미터는 2,... 되는; x - 파라미터값
예외:: SQLException - 데이타베이스 액세스 에러가 발생했을 경우

setTime

void setTime(int parameterIndex,
             Time  x)
             throws SQLException

지정된 파라미터가 지정된 java.sql.Time값으로 설정합니다. 데이타베이스에 보낼 때에 드라이버는 이것을 SQL TIME값으로 변환합니다.

파라미터:: parameterIndex - 최초의 파라미터는 1, 2번째의 파라미터는 2,... 되는; x - 파라미터값
예외:: SQLException - 데이타베이스 액세스 에러가 발생했을 경우

setTimestamp

void setTimestamp(int parameterIndex,
                  Timestamp  x)
                  throws SQLException

지정된 파라미터가 지정된 java.sql.Timestamp값으로 설정합니다. 데이타베이스에 보낼 때에 드라이버는 이것을 SQL TIMESTAMP값으로 변환합니다.

파라미터:: parameterIndex - 최초의 파라미터는 1, 2번째의 파라미터는 2,... 되는; x - 파라미터값
예외:: SQLException - 데이타베이스 액세스 에러가 발생했을 경우

setAsciiStream

void setAsciiStream(int parameterIndex,
                    InputStream  x,
                    int length)
                    throws SQLException

지정된 파라미터를, 지정된 바이트수를 가지는 지정된 입력 스트림로 설정합니다. LONGVARCHAR 파라미터에 매우 큰 ASCII 값이 입력될 때는 java.io.InputStream를 개입시켜 보내는 것이 현실적입니다. 파일의 마지막에 이를 때까지 필요에 따라서 스트림로부터 데이터가 읽힙니다. JDBC 드라이버는 데이터를 ASCII 로부터 데이타베이스의 char 형식으로 변환합니다.

주: 이 스트림 객체는 표준의 Java 스트림 객체, 또는 표준 인터페이스를 구현하는 독자적인 서브 클래스의 어디라도 괜찮습니다.

파라미터:: parameterIndex - 최초의 파라미터는 1, 2번째의 파라미터는 2,... 되는; x - ASCII 파라미터값를 포함한 Java 입력 스트림; length - 스트림의 바이트수
예외:: SQLException - 데이타베이스 액세스 에러가 발생했을 경우

setUnicodeStream

@Deprecated 
void setUnicodeStream(int parameterIndex,
                                 InputStream  x,
                                 int length)
                      throws SQLException

추천하지 않습니다.

지정된 파라미터를, 지정된 바이트수를 가지는 지정된 입력 스트림로 설정합니다. Unicode 문자는 2 바이트로부터 되어, 최초의 바이트가 상위 바이트, 2번째가 하위 바이트입니다. LONGVARCHAR 파라미터에 매우 큰 Unicode값이 입력될 때는 java.io.InputStream를 개입시켜 보내는 것이 현실적입니다. 파일의 마지막에 이를 때까지 필요에 따라서 스트림로부터 데이터가 읽힙니다. JDBC 드라이버는 데이터를 Unicode 로부터 데이타베이스의 char 형식으로 변환합니다.

주: 이 스트림 객체는 표준의 Java 스트림 객체, 또는 표준 인터페이스를 구현하는 독자적인 서브 클래스의 어디라도 괜찮습니다.

파라미터:: parameterIndex - 최초의 파라미터는 1, 2번째의 파라미터는 2,... 되는; x - Unicode 파라미터를 2 바이트의 Unicode 문자로서 포함하는 java.io.InputStream 객체; length - 스트림의 바이트수
예외:: SQLException - 데이타베이스 액세스 에러가 발생했을 경우

setBinaryStream

void setBinaryStream(int parameterIndex,
                     InputStream  x,
                     int length)
                     throws SQLException

지정된 파라미터를, 지정된 바이트수를 가지는 지정된 입력 스트림로 설정합니다. LONGVARBINARY 파라미터에 매우 큰 바이너리값이 입력될 때는 java.io.InputStream 객체를 개입시켜 보내는 것이 현실적입니다. 파일의 마지막에 이를 때까지 필요에 따라서 스트림로부터 데이터가 읽힙니다.

주: 이 스트림 객체는 표준의 Java 스트림 객체, 또는 표준 인터페이스를 구현하는 독자적인 서브 클래스의 어디라도 괜찮습니다.

파라미터:: parameterIndex - 최초의 파라미터는 1, 2번째의 파라미터는 2,... 되는; x - 바이너리 파라미터값를 포함한 Java 입력 스트림; length - 스트림의 바이트수
예외:: SQLException - 데이타베이스 액세스 에러가 발생했을 경우

clearParameters

void clearParameters()
                     throws SQLException

현재의 파라미터값를 곧바로 클리어 합니다.

보통, 문장을 반복해 사용하기 위해서 파라미터값는 강제적으로 남겨집니다. 파라미터값를 설정하면, 전의 값은 자동적으로 클리어 됩니다. 그러나, 현재의 파라미터값에 의해 사용된 자원을 즉시 해방하는 편이 도움이 되는 경우가 있습니다. 이것은 메서드 clearParameters를 호출해 실행할 수 있습니다 .

예외:: SQLException - 데이타베이스 액세스 에러가 발생했을 경우

setObject

void setObject(int parameterIndex,
               Object  x,
               int targetSqlType,
               int scale)
               throws SQLException

지정된 파라미터의 값을 지정된 객체를 사용해 설정합니다. 2번째의 인수는 객체의 형태가 아니면 안됩니다. 필요한 모든 값에 대해서 등가인 java.lang 객체를 사용할 필요가 있습니다.

지정된 Java 객체는 데이타베이스에 보내지기 전에 지정된 targetSqlType에 변환됩니다. 객체가 커스텀 매핑을 가지는 경우 (객체가 인터페이스 SQLData를 구현하는 클래스의 인스턴스인 경우), JDBC 드라이버는 SQLData.writeSQL 메서드를 호출해, 그 객체를 SQL 데이터 스트림에 출력할 필요가 있습니다. 또, 객체가 Ref, Blob, Clob, Struct, 또는 Array를 구현하는 클래스의 인스턴스인 경우, 드라이버는 객체를, 대응하는 SQL 형의 값으로 해서 데이타베이스에 건네줄 필요가 있습니다.

이 메서드는 데이타베이스 고유의 추상 데이터형을 건네주기 위해서 사용하는 것에 주의해 주세요.

파라미터:: parameterIndex - 최초의 파라미터는 1, 2번째의 파라미터는 2,... 되는; x - 입력 파라미터값를 포함한 객체; targetSqlType - 데이타베이스에 보내지는 (java.sql.Types 로 정의된다) SQL 형. 스케일 인수로 또한 형태를 한정할 수 있는; scale - java.sql.Types.DECIMAL 이나 java.sql.Types.NUMERIC 형에서는 소수점 아래의 자리수. 다른 모든 형태에서는 이 값은 무시된다
예외:: SQLException - 데이타베이스 액세스 에러가 발생했을 경우
관련 항목:: Types

setObject

void setObject(int parameterIndex,
               Object  x,
               int targetSqlType)
               throws SQLException

지정된 파라미터의 값을 지정된 객체로 설정합니다. 이 메서드는 상기의 메서드 setObject를 닮아 있습니다만, 스케일에 0을 가정하고 있는 점이 다릅니다.

파라미터:: parameterIndex - 최초의 파라미터는 1, 2번째의 파라미터는 2,... 되는; x - 입력 파라미터값를 포함한 객체; targetSqlType - 데이타베이스에 보내지는 (java.sql.Types 로 정의된다) SQL 형
예외:: SQLException - 데이타베이스 액세스 에러가 발생했을 경우

setObject

void setObject(int parameterIndex,
               Object  x)
               throws SQLException

지정된 파라미터의 값을 지정된 객체를 사용해 설정합니다. 2번째의 파라미터는 Object 형태가 아니면 안됩니다. 따라서, 빌트인형의 경우, 등가인 java.lang 객체를 사용할 필요가 있습니다.

JDBC는 Java Object 형으로부터 SQL 형에의 표준 매핑을 지정하고 있습니다. 지정된 인수는 데이타베이스에 보내지기 전에 대응하는 SQL 형에 변환됩니다.

이 메서드는 드라이버 고유의 Java 형을 사용해, 데이타베이스 고유의 추상 데이터형을 건네주기 위해서 사용하는 것에 주의해 주세요. 객체가 인터페이스 SQLData를 구현하는 클래스의 인스턴스인 경우, JDBC 드라이버는 SQLData.writeSQL 메서드를 호출해, 그 객체를 SQL 데이터 스트림에 출력할 필요가 있습니다. 또, 객체가 Ref, Blob, Clob, Struct, 또는 Array를 구현하는 클래스의 인스턴스인 경우, 드라이버는 객체를, 대응하는 SQL 형의 값으로 해서 데이타베이스에 건네줄 필요가 있습니다.

예를 들어 객체가 상기의 인터페이스를 복수 구현하는 클래스인 등, 애매함이 있는 경우, 이 메서드는 예외를 Throw 합니다.

파라미터:: parameterIndex - 최초의 파라미터는 1, 2번째의 파라미터는 2,... 되는; x - 입력 파라미터값를 포함한 객체
예외:: SQLException - 데이타베이스 액세스 에러가 발생했을 경우, 또는 지정된 객체의 형태가 애매한 경우

execute

boolean execute()
                throws SQLException

이 PreparedStatement 객체의, 모든 종류의 SQL 문을 실행합니다. PreparedStatement 객체로 준비된 문장에는 복수의 결과를 돌려주는 것이 있습니다. execute 메서드는 executeQuery 메서드와 executeUpdate 메서드에 의해 처리되는 보다 간단한 형식의 문장과 같게, 복잡한 문장도 처리합니다.

execute 메서드는 boolean을 돌려주고 최초의 결과의 형식을 나타냅니다. getResultSet 또는 getUpdateCount 메서드를 호출해 결과를 취득합니다. 그리고, getMoreResults를 호출해 계속 임의의 결과의 취득 (복수가능)으로 이동합니다.

반환값:: 최초의 결과가 ResultSet 객체의 경우는 true. 갱신 카운트인지, 또는 결과가 없는 경우는 false
예외:: SQLException - 데이타베이스 액세스 에러가 발생했을 경우, 또는 이 메서드에 인수가 지정되었을 경우
관련 항목:: Statement.execute(java.lang.String), Statement.getResultSet(), Statement.getUpdateCount(), Statement.getMoreResults()

addBatch

void addBatch()
              throws SQLException

이 PreparedStatement 객체의 커멘드의 배치에 파라미터세트를 추가합니다.

예외:: SQLException - 데이타베이스 액세스 에러가 발생했을 경우
도입된 버전 :: 1.2
관련 항목:: Statement.addBatch(java.lang.String)

setCharacterStream

void setCharacterStream(int parameterIndex,
                        Reader  reader,
                        int length)
                        throws SQLException

지정된 파라미터를, 지정된 문자수인 지정된 Reader 객체로 설정합니다. LONGVARCHAR 파라미터에 매우 큰 UNICODE 치를 입력할 경우에는 java.io.Reader 객체를 개입시켜 보내는 편이 현실적입니다. 파일의 마지막에 이를 때까지 필요에 따라서 스트림로부터 데이터가 읽힙니다. JDBC 드라이버는 데이터를 UNICODE 로부터 데이타베이스의 char 형식으로 변환합니다.

주: 이 스트림 객체는 표준의 Java 스트림 객체, 또는 표준 인터페이스를 구현하는 독자적인 서브 클래스의 어디라도 괜찮습니다.

파라미터:: parameterIndex - 최초의 파라미터는 1, 2번째의 파라미터는 2,... 되는; reader - Unicode 데이터를 포함하는 java.io.Reader 객체; length - 스트림내의 문자수
예외:: SQLException - 데이타베이스 액세스 에러가 발생했을 경우
도입된 버전 :: 1.2

setRef

void setRef(int i,
            Ref  x)
            throws SQLException

지정된 파라미터가 지정된 REF(<structured-type>)값으로 설정합니다. 데이타베이스에 보낼 때에 드라이버는 이것을 SQL REF값으로 변환합니다.

파라미터:: i - 최초의 파라미터는 1, 2번째의 파라미터는 2,... 되는; x - SQL REF 치
예외:: SQLException - 데이타베이스 액세스 에러가 발생했을 경우
도입된 버전 :: 1.2

setBlob

void setBlob(int i,
             Blob  x)
             throws SQLException

지정된 파라미터가 지정된 Blob 객체로 설정합니다. 데이타베이스에 보낼 때에 드라이버는 이것을 SQL BLOB값으로 변환합니다.

파라미터:: i - 최초의 파라미터는 1, 2번째의 파라미터는 2,... 되는; x - SQL BLOB값을 매핑 하는 Blob 객체
예외:: SQLException - 데이타베이스 액세스 에러가 발생했을 경우
도입된 버전 :: 1.2

setClob

void setClob(int i,
             Clob  x)
             throws SQLException

지정된 파라미터가 지정된 Clob 객체로 설정합니다. 데이타베이스에 보낼 때에 드라이버는 이것을 SQL CLOB값으로 변환합니다.

파라미터:: i - 최초의 파라미터는 1, 2번째의 파라미터는 2,... 되는; x - SQL CLOB값을 매핑 하는 Clob 객체
예외:: SQLException - 데이타베이스 액세스 에러가 발생했을 경우
도입된 버전 :: 1.2

setArray

void setArray(int i,
              Array  x)
              throws SQLException

지정된 파라미터가 지정된 Array 객체로 설정합니다. 데이타베이스에 보낼 때에 드라이버는 이것을 SQL ARRAY값으로 변환합니다.

파라미터:: i - 최초의 파라미터는 1, 2번째의 파라미터는 2,... 되는; x - SQL ARRAY값을 매핑 하는 Array 객체
예외:: SQLException - 데이타베이스 액세스 에러가 발생했을 경우
도입된 버전 :: 1.2

getMetaData

ResultSetMetaData  getMetaData()
                              throws SQLException

이 PreparedStatement이 실행될 때 리턴된 ResultSet 객체의 열에 관한 정보를 포함하는 ResultSetMetaData 객체를 취득합니다.

PreparedStatement객체는 프리컴파일 되므로 실행되지 않고 리턴된 ResultSet에 대해 아는 것이 가능합니다. 따라서, PreparedStatement에 대해 getMetaData 실행을 기다려, 그리고 리턴된 ResultSet에 대해 ResultSet.getMetaData를 호출하는 것이 아니라, getMetaData를 호출할 수 있습니다 .

주: 이 메서드의 사용은 드라이버에 따라서는 기본이 되는 DBMS 지원가 부족하기 때문에 부하가 커지는 경우가 있습니다.

반환값:: ResultSet 객체의 열의 기술, 또는 드라이버가 ResultSetMetaData 객체를 돌려줄 수가 없는 경우는 null
예외:: SQLException - 데이타베이스 액세스 에러가 발생했을 경우
도입된 버전 :: 1.2

setDate

void setDate(int parameterIndex,
             Date  x,
             Calendar  cal)
             throws SQLException

지정된 Calendar 객체를 사용해, 지정된 파라미터가 지정된 java.sql.Date값으로 설정합니다. 드라이버는 Calendar 객체를 사용해 SQL DATE값을 작성해, 계속되어 그것을 데이타베이스에 보냅니다. Calendar 객체를 사용하면, 드라이버는 커스텀 타임 존을 고려해 날짜와 시간를 계산할 수 있습니다. Calendar 객체를 지정하지 않는 경우, 드라이버는 어플리케이션으로 실행되는 가상 머신의 타임 존인 디폴트의 타임 존을 사용합니다.

파라미터:: parameterIndex - 최초의 파라미터는 1, 2번째의 파라미터는 2,... 되는; x - 파라미터값; cal - 드라이버가 날짜와 시간를 작성하기 위해서 사용하는 Calendar 객체
예외:: SQLException - 데이타베이스 액세스 에러가 발생했을 경우
도입된 버전 :: 1.2

setTime

void setTime(int parameterIndex,
             Time  x,
             Calendar  cal)
             throws SQLException

지정된 Calendar 객체를 사용해, 지정된 파라미터가 지정된 java.sql.Time값으로 설정합니다. 드라이버는 Calendar 객체를 사용해 SQL java.sql.Time값을 작성해, 계속되어 그것을 데이타베이스에 보냅니다. Calendar 객체를 사용하면, 드라이버는 커스텀 타임 존을 고려해 시각을 계산할 수 있습니다. Calendar 객체를 지정하지 않는 경우, 드라이버는 어플리케이션으로 실행되는 가상 머신의 타임 존인 디폴트의 타임 존을 사용합니다.

파라미터:: parameterIndex - 최초의 파라미터는 1, 2번째의 파라미터는 2,... 되는; x - 파라미터값; cal - 드라이버가 시각을 작성하기 위해서 사용하는 Calendar 객체
예외:: SQLException - 데이타베이스 액세스 에러가 발생했을 경우
도입된 버전 :: 1.2

setTimestamp

void setTimestamp(int parameterIndex,
                  Timestamp  x,
                  Calendar  cal)
                  throws SQLException

지정된 Calendar 객체를 사용해, 지정된 파라미터가 지정된 java.sql.Timestamp값으로 설정합니다. 드라이버는 Calendar 객체를 사용해 SQL TIMESTAMP값을 작성해, 계속되어 그것을 데이타베이스에 보냅니다. Calendar 객체를 사용하면, 드라이버는 커스텀 타임 존을 고려해 타임 스탬프를 계산할 수 있습니다. Calendar 객체를 지정하지 않는 경우, 드라이버는 어플리케이션으로 실행되는 가상 머신의 타임 존인 디폴트의 타임 존을 사용합니다.

파라미터:: parameterIndex - 최초의 파라미터는 1, 2번째의 파라미터는 2,... 되는; x - 파라미터값; cal - 드라이버가 타임 스탬프를 작성하기 위해서 사용하는 Calendar 객체
예외:: SQLException - 데이타베이스 액세스 에러가 발생했을 경우
도입된 버전 :: 1.2

setNull

void setNull(int paramIndex,
             int sqlType,
             String  typeName)
             throws SQLException

지정된 파라미터를 SQL NULL로 설정합니다. 사용자 정의형 및 REF 형의 파라미터에서는 이 버전의 메서드 setNull를 사용하지 않으면 안됩니다. 사용자 정의형의 예에는 STRUCT, DISTINCT, JAVA_OBJECT 및 이름 첨부 배열이 있습니다.

주: 이식성을 실현하기 위해서는 어플리케이션은 NULL 사용자 정의 파라미터 또는 REF 파라미터를 지정할 경우에 SQL 형 코드 및 완전 지정의 SQL 형명을 지정하지 않으면 안됩니다. 사용자 정의형의 경우, 이름은 파라미터 자체의 형명입니다. REF 파라미터의 경우, 이름은 참조되는 형태의 형명입니다. JDBC 드라이버가 형태 코드 또는 형명의 정보를 필요로 하지 않는 경우, 그것은 무시됩니다. 사용자 정의 파라미터 및 REF 파라미터를 대상으로 하고 있습니다만, 이 메서드는 임의의 JDBC 형의 null 파라미터를 설정하기 위해서 사용할 수 있습니다. 파라미터가 사용자 정의의 형태 또는 REF 형을 가지지 않는 경우, 지정된 typeName는 무시됩니다.

파라미터:: paramIndex - 최초의 파라미터는 1, 2번째의 파라미터는 2,... 되는; sqlType - java.sql.Types로 부터의 값; typeName - SQL 사용자 정의형의 완전 지정의 이름. 파라미터가 사용자 정의형도 REF도 아닌 경우는 무시된다
예외:: SQLException - 데이타베이스 액세스 에러가 발생했을 경우
도입된 버전 :: 1.2

setURL

void setURL(int parameterIndex,
            URL  x)
            throws SQLException

지정된 파라미터가 지정된 java.net.URL값으로 설정합니다. 데이타베이스에 보낼 때에 드라이버는 이것을 SQL DATALINK값으로 변환합니다.

파라미터:: parameterIndex - 최초의 파라미터는 1, 2번째의 파라미터는 2,... 되는; x - 설정되는 java.net.URL 객체
예외:: SQLException - 데이타베이스 액세스 에러가 발생했을 경우
도입된 버전 :: 1.4

getParameterMetaData

ParameterMetaData  getParameterMetaData()
                                       throws SQLException

이 PreparedStatement 객체의 파라미터의 수, 형태 및 프로퍼티를 취득합니다.

반환값:: 이 PreparedStatement 객체의 파라미터의 수, 형태 및 프로퍼티에 대한 정보를 포함하는 ParameterMetaData 객체
예외:: SQLException - 데이타베이스 액세스 에러가 발생했을 경우
도입된 버전 :: 1.4
관련 항목:: ParameterMetaData

개요

패키지

클래스

사용

계층 트리

비추천 API

색인

헬프

Java^TM 2 Platform
Standard Ed. 5.0

이전 클래스 다음 클래스

프레임으로 프레임 없이

개요: NESTED | 필드 | 생성자 | 메서드

상세: 필드 | 생성자 | 메서드

java.sql 인터페이스 PreparedStatement

executeQuery

executeUpdate

setNull

setBoolean

setByte

setShort

setInt

setLong

setFloat

setDouble

setBigDecimal

setString

setBytes

setDate

setTime

setTimestamp

setAsciiStream

setUnicodeStream

setBinaryStream

clearParameters

setObject

setObject

setObject

execute

addBatch

setCharacterStream

setRef

setBlob

setClob

setArray

getMetaData

setDate

setTime

setTimestamp

setNull

setURL

getParameterMetaData

java.sql
인터페이스 PreparedStatement