개요   패키지    클래스  사용   계층 트리   비추천 API   색인   헬프  
JavaTM Platform
Standard Ed. 6
 전의 클래스    다음의 클래스 프레임 있어    프레임 없음    
개요: 상자 | 필드 | 생성자  | 메소드 상세: 필드 | 생성자  | 메소드

java.sql
인터페이스 PreparedStatement

모든 슈퍼 인터페이스:
Statement , Wrapper
기존의 서브 인터페이스의 일람:
CallableStatement 
public interface PreparedStatement
extends Statement

프리컴파일 된 SQL 문을 나타내는 객체입니다.  

SQL 문은, 프리컴파일 되어PreparedStatement 객체에 포함됩니다. 거기서, 이 객체는, 이 문장을 여러 차례 효율적으로 실행하는 목적으로 사용할 수 있습니다.

주: 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 데이터 조작 언어 (DML) 문 (INSERT 문,UPDATE 문,DELETE 문등)을 실행합니다.
 ResultSetMetaData getMetaData ()
          이 PreparedStatement 가 실행될 때 반환되는 ResultSet 객체의 열에 관한 정보를 포함하는 ResultSetMetaData 객체를 가져옵니다.
 ParameterMetaData getParameterMetaData ()
          이 PreparedStatement 객체의 파라미터의 수, 형태, 및 프로퍼티을 가져옵니다.
 void setArray (int parameterIndex, Array  x)
          지정된 파라미터를, 지정된 java.sql.Array 객체로 설정합니다.
 void setAsciiStream (int parameterIndex, InputStream  x)
          지정된 파라미터를, 지정된 입력 스트림로 설정합니다.
 void setAsciiStream (int parameterIndex, InputStream  x, int length)
          지정된 파라미터를, 지정된 바이트수를 가지는 지정된 입력 스트림로 설정합니다.
 void setAsciiStream (int parameterIndex, InputStream  x, long length)
          지정된 파라미터를, 지정된 바이트수를 가지는 지정된 입력 스트림로 설정합니다.
 void setBigDecimal (int parameterIndex, BigDecimal  x)
          지정된 파라미터가 지정된 java.math.BigDecimal 치로 설정합니다.
 void setBinaryStream (int parameterIndex, InputStream  x)
          지정된 파라미터를, 지정된 입력 스트림로 설정합니다.
 void setBinaryStream (int parameterIndex, InputStream  x, int length)
          지정된 파라미터를, 지정된 바이트수를 가지는 지정된 입력 스트림로 설정합니다.
 void setBinaryStream (int parameterIndex, InputStream  x, long length)
          지정된 파라미터를, 지정된 바이트수를 가지는 지정된 입력 스트림로 설정합니다.
 void setBlob (int parameterIndex, Blob  x)
          지정된 파라미터를, 지정된 java.sql.Blob 객체로 설정합니다.
 void setBlob (int parameterIndex, InputStream  inputStream)
          지정된 파라미터를 InputStream 객체로 설정합니다.
 void setBlob (int parameterIndex, InputStream  inputStream, long length)
          지정된 파라미터를 InputStream 객체로 설정합니다.
 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)
          지정된 파라미터를, 지정된 Java 의 Reader 객체로 설정합니다.
 void setCharacterStream (int parameterIndex, Reader  reader, int length)
          지정된 파라미터를, 지정된 문자수인 지정된 Reader 객체로 설정합니다.
 void setCharacterStream (int parameterIndex, Reader  reader, long length)
          지정된 파라미터를, 지정된 문자수인 지정된 Reader 객체로 설정합니다.
 void setClob (int parameterIndex, Clob  x)
          지정된 파라미터를, 지정된 java.sql.Clob 객체로 설정합니다.
 void setClob (int parameterIndex, Reader  reader)
          지정된 파라미터를 Reader 객체로 설정합니다.
 void setClob (int parameterIndex, Reader  reader, long length)
          지정된 파라미터를 Reader 객체로 설정합니다.
 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 setNCharacterStream (int parameterIndex, Reader  value)
          지정된 파라미터를 Reader 객체로 설정합니다.
 void setNCharacterStream (int parameterIndex, Reader  value, long length)
          지정된 파라미터를 Reader 객체로 설정합니다.
 void setNClob (int parameterIndex, NClob  value)
          지정된 파라미터를 java.sql.NClob 객체로 설정합니다.
 void setNClob (int parameterIndex, Reader  reader)
          지정된 파라미터를 Reader 객체로 설정합니다.
 void setNClob (int parameterIndex, Reader  reader, long length)
          지정된 파라미터를 Reader 객체로 설정합니다.
 void setNString (int parameterIndex, String  value)
          지정된 파라미터를, 지정된 Java 의 String 객체로 설정합니다.
 void setNull (int parameterIndex, int sqlType)
          지정된 파라미터를 SQL NULL 로 설정합니다.
 void setNull (int parameterIndex, 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 scaleOrLength)
          지정된 파라미터의 값을, 지정된 객체로 설정합니다.
 void setRef (int parameterIndex, Ref  x)
          지정된 파라미터를, 지정된 REF(<구조화형 >) 치로 설정합니다.
 void setRowId (int parameterIndex, RowId  x)
          지정된 파라미터를, 지정된 java.sql.RowId 객체로 설정합니다.
 void setShort (int parameterIndex, short x)
          지정된 파라미터가 지정된 Java 의 short 치로 설정합니다.
 void setSQLXML (int parameterIndex, SQLXML  xmlObject)
          지정된 파라미터를, 지정된 java.sql.SQLXML 객체로 설정합니다.
 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 , isClosed , isPoolable , setCursorName , setEscapeProcessing , setFetchDirection , setFetchSize , setMaxFieldSize , setMaxRows , setPoolable , setQueryTimeout
 
인터페이스 java.sql. Wrapper 로부터 상속된 메소드
isWrapperFor , unwrap
 

메소드의 상세

executeQuery

ResultSet  executeQuery()
                       throws SQLException
이 PreparedStatement 객체의 SQL 쿼리를 실행해, 그 쿼리에 의해 생성된 ResultSet 객체를 돌려줍니다.

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

executeUpdate

int executeUpdate()
                  throws SQLException
이 PreparedStatement 객체의 SQL 데이터 조작 언어 (DML) 문 (INSERT 문,UPDATE 문,DELETE 문등)을 실행합니다. 게다가 DDL 문과 같은 아무것도 돌려주지 않는 SQL 문을 실행할 수도 있습니다.

반환값:
(1) SQL 데이터 조작 언어 (DML) 문의 경우는 행수, (2) 아무것도 돌려주지 않는 SQL 문의 경우는 0
예외:
SQLException - 데이타베이스 액세스 에러가 발생했을 경우, 이 메소드가 클로즈 된 PreparedStatement 로 불려 갔을 경우, 또는 SQL 문이 ResultSet 객체를 돌려주는 경우

setNull

void setNull(int parameterIndex,
             int sqlType)
             throws SQLException
지정된 파라미터를 SQL NULL 로 설정합니다.

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

파라미터:
parameterIndex - 최초의 파라미터는 1, 2 번째의 파라미터는 2,... 되는
sqlType - java.sql.Types 로 정의되는 SQL 형 코드
예외:
SQLException - parameterIndex 가 SQL 문의 파라미터 마커에 대응하지 않는 경우, 데이타베이스 액세스 에러가 발생했을 경우, 또는 이 메소드가 클로즈 된 PreparedStatement 로 불려 갔을 경우
SQLFeatureNotSupportedException - sqlType 의 데이터형이,ARRAY,BLOB,CLOB,DATALINK,JAVA_OBJECT,NCHAR,NCLOB,NVARCHAR,LONGNVARCHAR,REF,ROWID,SQLXML, 또는 STRUCT 로, JDBC 드라이버가 이 데이터형을 지원하고 있지 않는 경우

setBoolean

void setBoolean(int parameterIndex,
                boolean x)
                throws SQLException
지정된 파라미터가 지정된 Java 의 boolean 치로 설정합니다. 데이타베이스에 보낼 때에, 드라이버는 이것을 SQL BIT 또는 BOOLEAN 치로 변환합니다.

파라미터:
parameterIndex - 최초의 파라미터는 1, 2 번째의 파라미터는 2,... 되는
x - 파라미터치
예외:
SQLException - parameterIndex 가 SQL 문의 파라미터 마커에 대응하지 않는 경우, 데이타베이스 액세스 에러가 발생했을 경우, 또는 이 메소드가 클로즈 된 PreparedStatement 로 불려 갔을 경우

setByte

void setByte(int parameterIndex,
             byte x)
             throws SQLException
지정된 파라미터가 지정된 Java 의 byte 치로 설정합니다. 데이타베이스에 보낼 때에, 드라이버는 이것을 SQL TINYINT 치로 변환합니다.

파라미터:
parameterIndex - 최초의 파라미터는 1, 2 번째의 파라미터는 2,... 되는
x - 파라미터치
예외:
SQLException - parameterIndex 가 SQL 문의 파라미터 마커에 대응하지 않는 경우, 데이타베이스 액세스 에러가 발생했을 경우, 또는 이 메소드가 클로즈 된 PreparedStatement 로 불려 갔을 경우

setShort

void setShort(int parameterIndex,
              short x)
              throws SQLException
지정된 파라미터가 지정된 Java 의 short 치로 설정합니다. 데이타베이스에 보낼 때에, 드라이버는 이것을 SQL SMALLINT 치로 변환합니다.

파라미터:
parameterIndex - 최초의 파라미터는 1, 2 번째의 파라미터는 2,... 되는
x - 파라미터치
예외:
SQLException - parameterIndex 가 SQL 문의 파라미터 마커에 대응하지 않는 경우, 데이타베이스 액세스 에러가 발생했을 경우, 또는 이 메소드가 클로즈 된 PreparedStatement 로 불려 갔을 경우

setInt

void setInt(int parameterIndex,
            int x)
            throws SQLException
지정된 파라미터가 지정된 Java 의 int 치로 설정합니다. 데이타베이스에 보낼 때에, 드라이버는 이것을 SQL INTEGER 치로 변환합니다.

파라미터:
parameterIndex - 최초의 파라미터는 1, 2 번째의 파라미터는 2,... 되는
x - 파라미터치
예외:
SQLException - parameterIndex 가 SQL 문의 파라미터 마커에 대응하지 않는 경우, 데이타베이스 액세스 에러가 발생했을 경우, 또는 이 메소드가 클로즈 된 PreparedStatement 로 불려 갔을 경우

setLong

void setLong(int parameterIndex,
             long x)
             throws SQLException
지정된 파라미터가 지정된 Java 의 long 치로 설정합니다. 데이타베이스에 보낼 때에, 드라이버는 이것을 SQL BIGINT 치로 변환합니다.

파라미터:
parameterIndex - 최초의 파라미터는 1, 2 번째의 파라미터는 2,... 되는
x - 파라미터치
예외:
SQLException - parameterIndex 가 SQL 문의 파라미터 마커에 대응하지 않는 경우, 데이타베이스 액세스 에러가 발생했을 경우, 또는 이 메소드가 클로즈 된 PreparedStatement 로 불려 갔을 경우

setFloat

void setFloat(int parameterIndex,
              float x)
              throws SQLException
지정된 파라미터가 지정된 Java 의 float 치로 설정합니다. 데이타베이스에 보낼 때에, 드라이버는 이것을 SQL REAL 치로 변환합니다.

파라미터:
parameterIndex - 최초의 파라미터는 1, 2 번째의 파라미터는 2,... 되는
x - 파라미터치
예외:
SQLException - parameterIndex 가 SQL 문의 파라미터 마커에 대응하지 않는 경우, 데이타베이스 액세스 에러가 발생했을 경우, 또는 이 메소드가 클로즈 된 PreparedStatement 로 불려 갔을 경우

setDouble

void setDouble(int parameterIndex,
               double x)
               throws SQLException
지정된 파라미터가 지정된 Java 의 double 치로 설정합니다. 데이타베이스에 보낼 때에, 드라이버는 이것을 SQL DOUBLE 치로 변환합니다.

파라미터:
parameterIndex - 최초의 파라미터는 1, 2 번째의 파라미터는 2,... 되는
x - 파라미터치
예외:
SQLException - parameterIndex 가 SQL 문의 파라미터 마커에 대응하지 않는 경우, 데이타베이스 액세스 에러가 발생했을 경우, 또는 이 메소드가 클로즈 된 PreparedStatement 로 불려 갔을 경우

setBigDecimal

void setBigDecimal(int parameterIndex,
                   BigDecimal  x)
                   throws SQLException
지정된 파라미터가 지정된 java.math.BigDecimal 치로 설정합니다. 데이타베이스에 보낼 때에, 드라이버는 이것을 SQL NUMERIC 치로 변환합니다.

파라미터:
parameterIndex - 최초의 파라미터는 1, 2 번째의 파라미터는 2,... 되는
x - 파라미터치
예외:
SQLException - parameterIndex 가 SQL 문의 파라미터 마커에 대응하지 않는 경우, 데이타베이스 액세스 에러가 발생했을 경우, 또는 이 메소드가 클로즈 된 PreparedStatement 로 불려 갔을 경우

setString

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

파라미터:
parameterIndex - 최초의 파라미터는 1, 2 번째의 파라미터는 2,... 되는
x - 파라미터치
예외:
SQLException - parameterIndex 가 SQL 문의 파라미터 마커에 대응하지 않는 경우, 데이타베이스 액세스 에러가 발생했을 경우, 또는 이 메소드가 클로즈 된 PreparedStatement 로 불려 갔을 경우

setBytes

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

파라미터:
parameterIndex - 최초의 파라미터는 1, 2 번째의 파라미터는 2,... 되는
x - 파라미터치
예외:
SQLException - parameterIndex 가 SQL 문의 파라미터 마커에 대응하지 않는 경우, 데이타베이스 액세스 에러가 발생했을 경우, 또는 이 메소드가 클로즈 된 PreparedStatement 로 불려 갔을 경우

setDate

void setDate(int parameterIndex,
             Date  x)
             throws SQLException
어플리케이션을 실행하고 있는 가상 머신의 디폴트의 타임 존을 사용해, 지정된 파라미터가 지정된 java.sql.Date 치로 설정합니다. 데이타베이스에 보낼 때에, 드라이버는 이것을 SQL DATE 치로 변환합니다.

파라미터:
parameterIndex - 최초의 파라미터는 1, 2 번째의 파라미터는 2,... 되는
x - 파라미터치
예외:
SQLException - parameterIndex 가 SQL 문의 파라미터 마커에 대응하지 않는 경우, 데이타베이스 액세스 에러가 발생했을 경우, 또는 이 메소드가 클로즈 된 PreparedStatement 로 불려 갔을 경우

setTime

void setTime(int parameterIndex,
             Time  x)
             throws SQLException
지정된 파라미터를, 지정된 java.sql.Time 치로 설정합니다. 데이타베이스에 보낼 때에, 드라이버는 이것을 SQL TIME 치로 변환합니다.

파라미터:
parameterIndex - 최초의 파라미터는 1, 2 번째의 파라미터는 2,... 되는
x - 파라미터치
예외:
SQLException - parameterIndex 가 SQL 문의 파라미터 마커에 대응하지 않는 경우, 데이타베이스 액세스 에러가 발생했을 경우, 또는 이 메소드가 클로즈 된 PreparedStatement 로 불려 갔을 경우

setTimestamp

void setTimestamp(int parameterIndex,
                  Timestamp  x)
                  throws SQLException
지정된 파라미터를, 지정된 java.sql.Timestamp 치로 설정합니다. 데이타베이스에 보낼 때에, 드라이버는 이것을 SQL TIMESTAMP 치로 변환합니다.

파라미터:
parameterIndex - 최초의 파라미터는 1, 2 번째의 파라미터는 2,... 되는
x - 파라미터치
예외:
SQLException - parameterIndex 가 SQL 문의 파라미터 마커에 대응하지 않는 경우, 데이타베이스 액세스 에러가 발생했을 경우, 또는 이 메소드가 클로즈 된 PreparedStatement 로 불려 갔을 경우

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 - parameterIndex 가 SQL 문의 파라미터 마커에 대응하지 않는 경우, 데이타베이스 액세스 에러가 발생했을 경우, 또는 이 메소드가 클로즈 된 PreparedStatement 로 불려 갔을 경우

setUnicodeStream

void setUnicodeStream(int parameterIndex,
                      InputStream  x,
                      int length)
                      throws SQLException
추천 되고 있지 않습니다.  

지정된 파라미터를, 지정된 바이트수를 가지는 지정된 입력 스트림로 설정합니다. LONGVARCHAR 파라미터에 매우 큰 Unicode 치가 입력될 때는,java.io.InputStream 객체를 개입시켜 보내는 것이 현실적입니다. 파일의 마지막에 이를 때까지 필요에 따라서 스트림로부터 데이터가 읽힙니다. JDBC 드라이버는, 데이터를 Unicode 로부터 데이타베이스의 char 형식으로 변환합니다. Unicode 스트림의 바이트 형식은, Java 가상 머신 스펙에 정의되고 있는 대로 Java UTF-8 일 필요가 있습니다.

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

파라미터:
parameterIndex - 최초의 파라미터는 1, 2 번째의 파라미터는 2,... 되는
x - Unicode 파라미터치를 포함한 java.io.InputStream 객체
length - 스트림의 바이트수
예외:
SQLException - parameterIndex 가 SQL 문의 파라미터 마커에 대응하지 않는 경우, 데이타베이스 액세스 에러가 발생했을 경우, 또는 이 메소드가 클로즈 된 PreparedStatement 로 불려 갔을 경우
SQLFeatureNotSupportedException - JDBC 드라이버가 이 메소드를 지원하지 않는 경우

setBinaryStream

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

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

파라미터:
parameterIndex - 최초의 파라미터는 1, 2 번째의 파라미터는 2,... 되는
x - 바이너리 파라미터치를 포함한 Java 입력 스트림
length - 스트림의 바이트수
예외:
SQLException - parameterIndex 가 SQL 문의 파라미터 마커에 대응하지 않는 경우, 데이타베이스 액세스 에러가 발생했을 경우, 또는 이 메소드가 클로즈 된 PreparedStatement 로 불려 갔을 경우

clearParameters

void clearParameters()
                     throws SQLException
현재의 파라미터치를 곧바로 클리어 합니다.  

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

예외:
SQLException - 데이타베이스 액세스 에러가 발생했을 경우, 또는 이 메소드가 클로즈 된 PreparedStatement 에 대해 불려 갔을 경우

setObject

void setObject(int parameterIndex,
               Object  x,
               int targetSqlType)
               throws SQLException
지정된 파라미터의 값을, 지정된 객체로 설정합니다. 이 메소드는, 상기의 setObject 메소드를 닮아 있습니다만, 스케일에 0 을 가정하고 있는 점이 다릅니다.

파라미터:
parameterIndex - 최초의 파라미터는 1, 2 번째의 파라미터는 2,... 되는
x - 입력 파라미터치를 포함한 객체
targetSqlType - 데이타베이스에 보내지는 (java.sql.Types 로 정의된다) SQL 형
예외:
SQLException - parameterIndex 가 SQL 문의 파라미터 마커에 대응하지 않는 경우, 데이타베이스 액세스 에러가 발생했을 경우, 또는 이 메소드가 클로즈 된 PreparedStatement 로 불려 갔을 경우
SQLFeatureNotSupportedException - targetSqlType 의 데이터형이,ARRAY,BLOB,CLOB,DATALINK,JAVA_OBJECT,NCHAR,NCLOB,NVARCHAR,LONGNVARCHAR,REF,ROWID,SQLXML, 또는 STRUCT 로, JDBC 드라이버가 이 데이터형을 지원하고 있지 않는 경우
관련 항목:
Types

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,NClob,Struct,java.net.URL,RowId,SQLXML, 또는 Array 를 구현하는 클래스의 객체인 경우, 드라이버는 이 객체를 대응하는 SQL 형의 값으로 해서 데이타베이스에 건네줄 필요가 있습니다.  

주: 모든 데이타베이스로, 연구 최종 단계에 대한 형태가 없는 Null 의 송신이 허가되는 것은 아닙니다. 이식성을 최대한으로 하려면 ,setObject(int parameterIndex, Object x) 대신에 setNull 메소드 또는 setObject(int parameterIndex, Object x, int sqlType) 메소드를 사용하지 않으면 안됩니다.

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

파라미터:
parameterIndex - 최초의 파라미터는 1, 2 번째의 파라미터는 2,... 되는
x - 입력 파라미터치를 포함한 객체
예외:
SQLException - parameterIndex 가 SQL 문의 파라미터 마커에 대응하지 않는 경우, 데이타베이스 액세스 에러가 발생했을 경우, 이 메소드가 클로즈 된 PreparedStatement 로 불려 갔을 경우, 또는 지정된 객체의 형태가 애매한 경우

execute

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

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

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

addBatch

void addBatch()
              throws SQLException
이 PreparedStatement 객체의 커멘드의 배치에, 파라미터세트를 추가합니다.

예외:
SQLException - 데이타베이스 액세스 에러가 발생했을 경우, 또는 이 메소드가 클로즈 된 PreparedStatement 에 대해 불려 갔을 경우
도입된 버젼:
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 - parameterIndex 가 SQL 문의 파라미터 마커에 대응하지 않는 경우, 데이타베이스 액세스 에러가 발생했을 경우, 또는 이 메소드가 클로즈 된 PreparedStatement 로 불려 갔을 경우
도입된 버젼:
1.2

setRef

void setRef(int parameterIndex,
            Ref  x)
            throws SQLException
지정된 파라미터를, 지정된 REF(<구조화형 >) 치로 설정합니다. 데이타베이스에 보낼 때에, 드라이버는 이것을 SQL REF 치로 변환합니다.

파라미터:
parameterIndex - 최초의 파라미터는 1, 2 번째의 파라미터는 2,... 되는
x - SQL REF 치
예외:
SQLException - parameterIndex 가 SQL 문의 파라미터 마커에 대응하지 않는 경우, 데이타베이스 액세스 에러가 발생했을 경우, 또는 이 메소드가 클로즈 된 PreparedStatement 로 불려 갔을 경우
SQLFeatureNotSupportedException - JDBC 드라이버가 이 메소드를 지원하지 않는 경우
도입된 버젼:
1.2

setBlob

void setBlob(int parameterIndex,
             Blob  x)
             throws SQLException
지정된 파라미터를, 지정된 java.sql.Blob 객체로 설정합니다. 데이타베이스에 보낼 때에, 드라이버는 이것을 SQL BLOB 치로 변환합니다.

파라미터:
parameterIndex - 최초의 파라미터는 1, 2 번째의 파라미터는 2,... 되는
x - SQL BLOB 치를 매핑 하는 Blob 객체
예외:
SQLException - parameterIndex 가 SQL 문의 파라미터 마커에 대응하지 않는 경우, 데이타베이스 액세스 에러가 발생했을 경우, 또는 이 메소드가 클로즈 된 PreparedStatement 로 불려 갔을 경우
SQLFeatureNotSupportedException - JDBC 드라이버가 이 메소드를 지원하지 않는 경우
도입된 버젼:
1.2

setClob

void setClob(int parameterIndex,
             Clob  x)
             throws SQLException
지정된 파라미터를, 지정된 java.sql.Clob 객체로 설정합니다. 데이타베이스에 보낼 때에, 드라이버는 이것을 SQL CLOB 치로 변환합니다.

파라미터:
parameterIndex - 최초의 파라미터는 1, 2 번째의 파라미터는 2,... 되는
x - SQL CLOB 치를 매핑 하는 Clob 객체
예외:
SQLException - parameterIndex 가 SQL 문의 파라미터 마커에 대응하지 않는 경우, 데이타베이스 액세스 에러가 발생했을 경우, 또는 이 메소드가 클로즈 된 PreparedStatement 로 불려 갔을 경우
SQLFeatureNotSupportedException - JDBC 드라이버가 이 메소드를 지원하지 않는 경우
도입된 버젼:
1.2

setArray

void setArray(int parameterIndex,
              Array  x)
              throws SQLException
지정된 파라미터를, 지정된 java.sql.Array 객체로 설정합니다. 데이타베이스에 보낼 때에, 드라이버는 이것을 SQL ARRAY 치로 변환합니다.

파라미터:
parameterIndex - 최초의 파라미터는 1, 2 번째의 파라미터는 2,... 되는
x - SQL ARRAY 치를 매핑 하는 Array 객체
예외:
SQLException - parameterIndex 가 SQL 문의 파라미터 마커에 대응하지 않는 경우, 데이타베이스 액세스 에러가 발생했을 경우, 또는 이 메소드가 클로즈 된 PreparedStatement 로 불려 갔을 경우
SQLFeatureNotSupportedException - JDBC 드라이버가 이 메소드를 지원하지 않는 경우
도입된 버젼:
1.2

getMetaData

ResultSetMetaData  getMetaData()
                              throws SQLException
이 PreparedStatement 가 실행될 때 반환되는 ResultSet 객체의 열에 관한 정보를 포함하는 ResultSetMetaData 객체를 가져옵니다.  

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

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

반환값:
ResultSet 객체의 열의 기술, 또는 드라이버가 ResultSetMetaData 객체를 돌려줄 수가 없는 경우는 null
예외:
SQLException - 데이타베이스 액세스 에러가 발생했을 경우, 또는 이 메소드가 클로즈 된 PreparedStatement 에 대해 불려 갔을 경우
SQLFeatureNotSupportedException - JDBC 드라이버가 이 메소드를 지원하지 않는 경우
도입된 버젼:
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 - parameterIndex 가 SQL 문의 파라미터 마커에 대응하지 않는 경우, 데이타베이스 액세스 에러가 발생했을 경우, 또는 이 메소드가 클로즈 된 PreparedStatement 로 불려 갔을 경우
도입된 버젼:
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 - parameterIndex 가 SQL 문의 파라미터 마커에 대응하지 않는 경우, 데이타베이스 액세스 에러가 발생했을 경우, 또는 이 메소드가 클로즈 된 PreparedStatement 로 불려 갔을 경우
도입된 버젼:
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 - parameterIndex 가 SQL 문의 파라미터 마커에 대응하지 않는 경우, 데이타베이스 액세스 에러가 발생했을 경우, 또는 이 메소드가 클로즈 된 PreparedStatement 로 불려 갔을 경우
도입된 버젼:
1.2

setNull

void setNull(int parameterIndex,
             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 는 무시됩니다.

파라미터:
parameterIndex - 최초의 파라미터는 1, 2 번째의 파라미터는 2,... 되는
sqlType - java.sql.Types 로부터의 값
typeName - SQL 사용자 정의형의 완전 지정의 이름. 파라미터가 사용자 정의형도 REF 도 아닌 경우는 무시된다
예외:
SQLException - parameterIndex 가 SQL 문의 파라미터 마커에 대응하지 않는 경우, 데이타베이스 액세스 에러가 발생했을 경우, 또는 이 메소드가 클로즈 된 PreparedStatement 로 불려 갔을 경우
SQLFeatureNotSupportedException - sqlType 의 데이터형이,ARRAY,BLOB,CLOB,DATALINK,JAVA_OBJECT,NCHAR,NCLOB,NVARCHAR,LONGNVARCHAR,REF,ROWID,SQLXML, 또는 STRUCT 로, JDBC 드라이버가 이 데이터형을 지원하고 있지 않는 경우. 또는 JDBC 드라이버가 이 메소드를 지원하고 있지 않는 경우
도입된 버젼:
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 - parameterIndex 가 SQL 문의 파라미터 마커에 대응하지 않는 경우, 데이타베이스 액세스 에러가 발생했을 경우, 또는 이 메소드가 클로즈 된 PreparedStatement 로 불려 갔을 경우
SQLFeatureNotSupportedException - JDBC 드라이버가 이 메소드를 지원하지 않는 경우
도입된 버젼:
1.4

getParameterMetaData

ParameterMetaData  getParameterMetaData()
                                       throws SQLException
이 PreparedStatement 객체의 파라미터의 수, 형태, 및 프로퍼티을 가져옵니다.

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

setRowId

void setRowId(int parameterIndex,
              RowId  x)
              throws SQLException
지정된 파라미터를, 지정된 java.sql.RowId 객체로 설정합니다. 데이타베이스에 보낼 때에, 드라이버는 이것을 SQL ROWID 치로 변환합니다.

파라미터:
parameterIndex - 최초의 파라미터는 1, 2 번째의 파라미터는 2,... 되는
x - 파라미터치
예외:
SQLException - parameterIndex 가 SQL 문의 파라미터 마커에 대응하지 않는 경우, 데이타베이스 액세스 에러가 발생했을 경우, 또는 이 메소드가 클로즈 된 PreparedStatement 로 불려 갔을 경우
SQLFeatureNotSupportedException - JDBC 드라이버가 이 메소드를 지원하지 않는 경우
도입된 버젼:
1.6

setNString

void setNString(int parameterIndex,
                String  value)
                throws SQLException
지정된 파라미터를, 지정된 Java 의 String 객체로 설정합니다. 데이타베이스에 보낼 때에, 드라이버는 이것을 SQL NCHAR,NVARCHAR, 또는 LONGNVARCHAR 치 (드라이버의 NVARCHAR 치에 관한 제한에 관한 인수의 사이즈에 의존)로 변환합니다.

파라미터:
parameterIndex - 최초의 파라미터의 인덱스는 1, 2 번째의 파라미터의 인덱스는 2,... 되는
value - 파라미터치
예외:
SQLException - parameterIndex 가 SQL 문의 파라미터 마커에 대응하지 않는 경우, 드라이버가 각국의 캐릭터 세트를 지원하지 않는 경우, 드라이버가 데이터 변환 에러가 발생한 것을 검출할 수 있는 경우, 데이타베이스 액세스 에러가 발생했을 경우, 또는 이 메소드가 클로즈 된 PreparedStatement 로 불려 갔을 경우
SQLFeatureNotSupportedException - JDBC 드라이버가 이 메소드를 지원하지 않는 경우
도입된 버젼:
1.6

setNCharacterStream

void setNCharacterStream(int parameterIndex,
                         Reader  value,
                         long length)
                         throws SQLException
지정된 파라미터를 Reader 객체로 설정합니다. Reader 는, 파일의 마지막에 이를 때까지 데이터를 읽어들입니다. 드라이버는, 필요에 따라서, Java 의 문자 표현을 데이타베이스내의 각국 캐릭터 세트로 변환합니다.

파라미터:
parameterIndex - 최초의 파라미터의 인덱스는 1, 2 번째의 파라미터의 인덱스는 2,... 되는
value - 파라미터치
length - 파라미터 데이터내의 문자수
예외:
SQLException - parameterIndex 가 SQL 문의 파라미터 마커에 대응하지 않는 경우, 드라이버가 각국의 캐릭터 세트를 지원하지 않는 경우, 드라이버가 데이터 변환 에러가 발생한 것을 검출할 수 있는 경우, 데이타베이스 액세스 에러가 발생했을 경우, 또는 이 메소드가 클로즈 된 PreparedStatement 로 불려 갔을 경우
SQLFeatureNotSupportedException - JDBC 드라이버가 이 메소드를 지원하지 않는 경우
도입된 버젼:
1.6

setNClob

void setNClob(int parameterIndex,
              NClob  value)
              throws SQLException
지정된 파라미터를 java.sql.NClob 객체로 설정합니다. 데이타베이스에 보낼 때에, 드라이버는 이것을 SQL NCLOB 치로 변환합니다.

파라미터:
parameterIndex - 최초의 파라미터의 인덱스는 1, 2 번째의 파라미터의 인덱스는 2,... 되는
value - 파라미터치
예외:
SQLException - parameterIndex 가 SQL 문의 파라미터 마커에 대응하지 않는 경우, 드라이버가 각국의 캐릭터 세트를 지원하지 않는 경우, 드라이버가 데이터 변환 에러가 발생한 것을 검출할 수 있는 경우, 데이타베이스 액세스 에러가 발생했을 경우, 또는 이 메소드가 클로즈 된 PreparedStatement 로 불려 갔을 경우
SQLFeatureNotSupportedException - JDBC 드라이버가 이 메소드를 지원하지 않는 경우
도입된 버젼:
1.6

setClob

void setClob(int parameterIndex,
             Reader  reader,
             long length)
             throws SQLException
지정된 파라미터를 Reader 객체로 설정합니다. reader 에는, length 로 지정되는 문자수가 포함될 필요가 있습니다. 그렇지 않은 경우,PreparedStatement 의 실행시에 SQLException 가 생성됩니다. 이 메소드는,setCharacterStream (int, Reader, int) 메소드와 달리, 파라미터치를 CLOB 로서 서버에 송신해야 하는 것을 드라이버에 통지합니다. setCharacterStream 메소드를 사용하면(자), 드라이버는, 파라미터 데이터를 LONGVARCHAR 와 CLOB 의 어느 쪽으로서 서버에 송신할까를 판단하기 위해서(때문에) 불필요한 작업을 실시할 필요가 있을 가능성이 있습니다.

파라미터:
parameterIndex - 최초의 파라미터의 인덱스는 1, 2 번째의 파라미터의 인덱스는 2,... 되는
reader - 파라미터치로 설정되는 데이터를 포함한 객체
length - 파라미터 데이터내의 문자수
예외:
SQLException - parameterIndex 가 SQL 문의 파라미터 마커에 대응하지 않는 경우, 데이타베이스 액세스 에러가 발생했을 경우, 이 메소드가 클로즈 된 PreparedStatement 로 불려 갔을 경우, 또는 지정된 length 가 0 보다 작은 경우
SQLFeatureNotSupportedException - JDBC 드라이버가 이 메소드를 지원하지 않는 경우
도입된 버젼:
1.6

setBlob

void setBlob(int parameterIndex,
             InputStream  inputStream,
             long length)
             throws SQLException
지정된 파라미터를 InputStream 객체로 설정합니다. inputStream 에는, length 로 지정되는 문자수가 포함될 필요가 있습니다. 그렇지 않은 경우,PreparedStatement 의 실행시에 SQLException 가 생성됩니다. 이 메소드는,setBinaryStream (int, InputStream, int) 메소드와 달리, 파라미터치를 BLOB 로서 서버에 송신해야 하는 것을 드라이버에 통지합니다. setBinaryStream 메소드를 사용하면(자), 드라이버는, 파라미터 데이터를 LONGVARBINARY 와 BLOB 의 어느 쪽으로서 서버에 송신할까를 판단하기 위해서(때문에) 불필요한 작업을 실시할 필요가 있을 가능성이 있습니다.

파라미터:
parameterIndex - 최초의 파라미터의 인덱스는 1, 2 번째의 파라미터의 인덱스는 2,... 되는
inputStream - 파라미터치로 설정되는 데이터를 포함한 객체
length - 파라미터 데이터내의 바이트수
예외:
SQLException - parameterIndex 가 SQL 문의 파라미터 마커에 대응하지 않는 경우, 데이타베이스 액세스 에러가 발생했을 경우, 이 메소드가 클로즈 된 PreparedStatement 로 불려 갔을 경우, 지정된 length 가 0 보다 작은 경우, 또는 inputStream 내의 바이트수가 지정된 length 에 일치하지 않는 경우
SQLFeatureNotSupportedException - JDBC 드라이버가 이 메소드를 지원하지 않는 경우
도입된 버젼:
1.6

setNClob

void setNClob(int parameterIndex,
              Reader  reader,
              long length)
              throws SQLException
지정된 파라미터를 Reader 객체로 설정합니다. reader 에는, length 로 지정되는 문자수가 포함될 필요가 있습니다. 그렇지 않은 경우,PreparedStatement 의 실행시에 SQLException 가 생성됩니다. 이 메소드는,setCharacterStream (int, Reader, int) 메소드와 달리, 파라미터치를 NCLOB 로서 서버에 송신해야 하는 것을 드라이버에 통지합니다. setCharacterStream 메소드를 사용하면(자), 드라이버는, 파라미터 데이터를 LONGNVARCHAR 와 NCLOB 의 어느 쪽으로서 서버에 송신할까를 판단하기 위해서(때문에) 불필요한 작업을 실시할 필요가 있을 가능성이 있습니다.

파라미터:
parameterIndex - 최초의 파라미터의 인덱스는 1, 2 번째의 파라미터의 인덱스는 2,... 되는
reader - 파라미터치로 설정되는 데이터를 포함한 객체
length - 파라미터 데이터내의 문자수
예외:
SQLException - parameterIndex 가 SQL 문의 파라미터 마커에 대응하지 않는 경우, 지정된 length 가 0 보다 작은 경우, 드라이버가 각국의 캐릭터 세트를 지원하지 않는 경우, 드라이버가 데이터 변환 에러가 발생한 것을 검출할 수 있는 경우, 데이타베이스 액세스 에러가 발생했을 경우, 또는 이 메소드가 클로즈 된 PreparedStatement 로 불려 갔을 경우
SQLFeatureNotSupportedException - JDBC 드라이버가 이 메소드를 지원하지 않는 경우
도입된 버젼:
1.6

setSQLXML

void setSQLXML(int parameterIndex,
               SQLXML  xmlObject)
               throws SQLException
지정된 파라미터를, 지정된 java.sql.SQLXML 객체로 설정합니다. 데이타베이스에 보낼 때에, 드라이버는 이것을 SQL XML 치로 변환합니다.  

파라미터:
parameterIndex - 최초의 파라미터의 인덱스는 1, 2 번째의 파라미터의 인덱스는 2,... 되는
xmlObject - SQL XML 치를 매핑 하는 SQLXML 객체
예외:
SQLException - parameterIndex 가 지정된 SQL 문의 파라미터 마커에 대응하지 않는 경우, 데이타베이스 액세스 에러가 발생했을 경우, 이 메소드가 클로즈 된 PreparedStatement 또는 java.xml.transform.Result 로 불려 갔을 경우,Writer 또는 OutputStream 가 SQLXML 객체에 대해서 클로즈되어 있지 않은 경우
SQLFeatureNotSupportedException - JDBC 드라이버가 이 메소드를 지원하지 않는 경우
도입된 버젼:
1.6

setObject

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

지정된 파라미터의 값을, 지정된 객체로 설정합니다. 2 번째의 인수는, 객체의 형태가 아니면 안됩니다. 필요한 모든 값에 대해서, 등가인 java.lang 객체를 사용할 필요가 있습니다. 2 번째의 인수가 InputStream 인 경우, 스트림에는 scaleOrLength 로 지정되는 바이트수가 포함될 필요가 있습니다. 2 번째의 인수가 Reader 인 경우, 리더에게는 scaleOrLength 로 지정되는 문자수가 포함될 필요가 있습니다. 이러한 조건이 true 가 아닌 경우, 준비된 문장의 실행시에 드라이버는 SQLException 를 생성합니다.

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

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

파라미터:
parameterIndex - 최초의 파라미터는 1, 2 번째의 파라미터는 2,... 되는
x - 입력 파라미터치를 포함한 객체
targetSqlType - 데이타베이스에 보내지는 (java.sql.Types 로 정의된다) SQL 형. 스케일 인수로, 한층 더 형태를 한정할 수 있는
scaleOrLength - java.sql.Types.DECIMAL 이나 java.sql.Types.NUMERIC 형에서는, 소수점 이하의 자리수. Java 객체형 InputStream 및 Reader 의 경우는, 스트림 또는 리더의 데이터 길이. 다른 모든 형태에서는, 이 값은 무시된다
예외:
SQLException - parameterIndex 가 SQL 문의 파라미터 마커에 대응하지 않는 경우, 데이타베이스 액세스 에러가 발생했을 경우, 이 메소드가 클로즈 된 PreparedStatement 로 불려 갔을 경우, 또는 x 로 지정된 Java 객체가 InputStream 객체나 Reader 객체로, 한편 scale 파라미터의 값이 0 보다 작은 경우
SQLFeatureNotSupportedException - targetSqlType 의 데이터형이,ARRAY,BLOB,CLOB,DATALINK,JAVA_OBJECT,NCHAR,NCLOB,NVARCHAR,LONGNVARCHAR,REF,ROWID,SQLXML, 또는 STRUCT 로, JDBC 드라이버가 이 데이터형을 지원하고 있지 않는 경우
도입된 버젼:
1.6
관련 항목:
Types

setAsciiStream

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

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

파라미터:
parameterIndex - 최초의 파라미터는 1, 2 번째의 파라미터는 2,... 되는
x - ASCII 파라미터치를 포함한 Java 입력 스트림
length - 스트림의 바이트수
예외:
SQLException - parameterIndex 가 SQL 문의 파라미터 마커에 대응하지 않는 경우, 데이타베이스 액세스 에러가 발생했을 경우, 또는 이 메소드가 클로즈 된 PreparedStatement 로 불려 갔을 경우
도입된 버젼:
1.6

setBinaryStream

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

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

파라미터:
parameterIndex - 최초의 파라미터는 1, 2 번째의 파라미터는 2,... 되는
x - 바이너리 파라미터치를 포함한 Java 입력 스트림
length - 스트림의 바이트수
예외:
SQLException - parameterIndex 가 SQL 문의 파라미터 마커에 대응하지 않는 경우, 데이타베이스 액세스 에러가 발생했을 경우, 또는 이 메소드가 클로즈 된 PreparedStatement 로 불려 갔을 경우
도입된 버젼:
1.6

setCharacterStream

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

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

파라미터:
parameterIndex - 최초의 파라미터는 1, 2 번째의 파라미터는 2,... 되는
reader - Unicode 데이터를 포함하는 java.io.Reader 객체
length - 스트림내의 문자수
예외:
SQLException - parameterIndex 가 SQL 문의 파라미터 마커에 대응하지 않는 경우, 데이타베이스 액세스 에러가 발생했을 경우, 또는 이 메소드가 클로즈 된 PreparedStatement 로 불려 갔을 경우
도입된 버젼:
1.6

setAsciiStream

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

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

주: length 파라미터를 사용하는 버젼의 setAsciiStream 를 사용하는 (분)편이 효율적인가 어떤가를 판단하려면 , JDBC 드라이버의 문서를 참조해 주세요.

파라미터:
parameterIndex - 최초의 파라미터는 1, 2 번째의 파라미터는 2,... 되는
x - ASCII 파라미터치를 포함한 Java 입력 스트림
예외:
SQLException - parameterIndex 가 SQL 문의 파라미터 마커에 대응하지 않는 경우, 데이타베이스 액세스 에러가 발생했을 경우, 또는 이 메소드가 클로즈 된 PreparedStatement 로 불려 갔을 경우
SQLFeatureNotSupportedException - JDBC 드라이버가 이 메소드를 지원하지 않는 경우
도입된 버젼:
1.6

setBinaryStream

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

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

주: length 파라미터를 사용하는 버젼의 setBinaryStream 를 사용하는 (분)편이 효율적인가 어떤가를 판단하려면 , JDBC 드라이버의 문서를 참조해 주세요.

파라미터:
parameterIndex - 최초의 파라미터는 1, 2 번째의 파라미터는 2,... 되는
x - 바이너리 파라미터치를 포함한 Java 입력 스트림
예외:
SQLException - parameterIndex 가 SQL 문의 파라미터 마커에 대응하지 않는 경우, 데이타베이스 액세스 에러가 발생했을 경우, 또는 이 메소드가 클로즈 된 PreparedStatement 로 불려 갔을 경우
SQLFeatureNotSupportedException - JDBC 드라이버가 이 메소드를 지원하지 않는 경우
도입된 버젼:
1.6

setCharacterStream

void setCharacterStream(int parameterIndex,
                        Reader  reader)
                        throws SQLException
지정된 파라미터를, 지정된 Java 의 Reader 객체로 설정합니다. LONGVARCHAR 파라미터에 매우 큰 Unicode 치가 입력될 때는,java.io.Reader 객체를 개입시켜 보내는 것이 현실적입니다. 파일의 마지막에 이를 때까지 필요에 따라서 스트림로부터 데이터가 읽힙니다. JDBC 드라이버는, 데이터를 UNICODE 로부터 데이타베이스의 char 형식으로 변환합니다.

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

주: length 파라미터를 사용하는 버젼의 setCharacterStream 를 사용하는 (분)편이 효율적인가 어떤가를 판단하려면 , JDBC 드라이버의 문서를 참조해 주세요.

파라미터:
parameterIndex - 최초의 파라미터는 1, 2 번째의 파라미터는 2,... 되는
reader - Unicode 데이터를 포함하는 java.io.Reader 객체
예외:
SQLException - parameterIndex 가 SQL 문의 파라미터 마커에 대응하지 않는 경우, 데이타베이스 액세스 에러가 발생했을 경우, 또는 이 메소드가 클로즈 된 PreparedStatement 로 불려 갔을 경우
SQLFeatureNotSupportedException - JDBC 드라이버가 이 메소드를 지원하지 않는 경우
도입된 버젼:
1.6

setNCharacterStream

void setNCharacterStream(int parameterIndex,
                         Reader  value)
                         throws SQLException
지정된 파라미터를 Reader 객체로 설정합니다. Reader 는, 파일의 마지막에 이를 때까지 데이터를 읽어들입니다. 드라이버는, 필요에 따라서, Java 의 문자 표현을 데이타베이스내의 각국 캐릭터 세트로 변환합니다.

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

주: length 파라미터를 사용하는 버젼의 setNCharacterStream 를 사용하는 (분)편이 효율적인가 어떤가를 판단하려면 , JDBC 드라이버의 문서를 참조해 주세요.

파라미터:
parameterIndex - 최초의 파라미터의 인덱스는 1, 2 번째의 파라미터의 인덱스는 2,... 되는
value - 파라미터치
예외:
SQLException - parameterIndex 가 SQL 문의 파라미터 마커에 대응하지 않는 경우, 드라이버가 각국의 캐릭터 세트를 지원하지 않는 경우, 드라이버가 데이터 변환 에러가 발생한 것을 검출할 수 있는 경우, 데이타베이스 액세스 에러가 발생했을 경우, 또는 이 메소드가 클로즈 된 PreparedStatement 로 불려 갔을 경우
SQLFeatureNotSupportedException - JDBC 드라이버가 이 메소드를 지원하지 않는 경우
도입된 버젼:
1.6

setClob

void setClob(int parameterIndex,
             Reader  reader)
             throws SQLException
지정된 파라미터를 Reader 객체로 설정합니다. 이 메소드는,setCharacterStream (int, Reader) 메소드와 달리, 파라미터치를 CLOB 로서 서버에 송신해야 하는 것을 드라이버에 통지합니다. setCharacterStream 메소드를 사용하면(자), 드라이버는, 파라미터 데이터를 LONGVARCHAR 와 CLOB 의 어느 쪽으로서 서버에 송신할까를 판단하기 위해서(때문에) 불필요한 작업을 실시할 필요가 있을 가능성이 있습니다.

주: length 파라미터를 사용하는 버젼의 setClob 를 사용하는 (분)편이 효율적인가 어떤가를 판단하려면 , JDBC 드라이버의 문서를 참조해 주세요.

파라미터:
parameterIndex - 최초의 파라미터의 인덱스는 1, 2 번째의 파라미터의 인덱스는 2,... 되는
reader - 파라미터치로 설정되는 데이터를 포함한 객체
예외:
SQLException - parameterIndex 가 SQL 문의 파라미터 마커에 대응하지 않는 경우, 데이타베이스 액세스 에러가 발생했을 경우, 이 메소드가 클로즈 된 PreparedStatement 로 불려 갔을 경우, 또는 parameterIndex 가 SQL 문의 파라미터 마커에 대응하지 않는 경우
SQLFeatureNotSupportedException - JDBC 드라이버가 이 메소드를 지원하지 않는 경우
도입된 버젼:
1.6

setBlob

void setBlob(int parameterIndex,
             InputStream  inputStream)
             throws SQLException
지정된 파라미터를 InputStream 객체로 설정합니다. 이 메소드는,setBinaryStream (int, InputStream) 메소드와 달리, 파라미터치를 BLOB 로서 서버에 송신해야 하는 것을 드라이버에 통지합니다. setBinaryStream 메소드를 사용하면(자), 드라이버는, 파라미터 데이터를 LONGVARBINARY 와 BLOB 의 어느 쪽으로서 서버에 송신할까를 판단하기 위해서(때문에) 불필요한 작업을 실시할 필요가 있을 가능성이 있습니다.

주: length 파라미터를 사용하는 버젼의 setBlob 를 사용하는 (분)편이 효율적인가 어떤가를 판단하려면 , JDBC 드라이버의 문서를 참조해 주세요.

파라미터:
parameterIndex - 최초의 파라미터의 인덱스는 1, 2 번째의 파라미터의 인덱스는 2,... 되는
inputStream - 파라미터치로 설정되는 데이터를 포함한 객체
예외:
SQLException - parameterIndex 가 SQL 문의 파라미터 마커에 대응하지 않는 경우, 데이타베이스 액세스 에러가 발생했을 경우, 이 메소드가 클로즈 된 PreparedStatement 로 불려 갔을 경우, 또는 parameterIndex 가 SQL 문의 파라미터 마커에 대응하지 않는 경우
SQLFeatureNotSupportedException - JDBC 드라이버가 이 메소드를 지원하지 않는 경우
도입된 버젼:
1.6

setNClob

void setNClob(int parameterIndex,
              Reader  reader)
              throws SQLException
지정된 파라미터를 Reader 객체로 설정합니다. 이 메소드는,setCharacterStream (int, Reader) 메소드와 달리, 파라미터치를 NCLOB 로서 서버에 송신해야 하는 것을 드라이버에 통지합니다. setCharacterStream 메소드를 사용하면(자), 드라이버는, 파라미터 데이터를 LONGNVARCHAR 와 NCLOB 의 어느 쪽으로서 서버에 송신할까를 판단하기 위해서(때문에) 불필요한 작업을 실시할 필요가 있을 가능성이 있습니다.

주: length 파라미터를 사용하는 버젼의 setNClob 를 사용하는 (분)편이 효율적인가 어떤가를 판단하려면 , JDBC 드라이버의 문서를 참조해 주세요.

파라미터:
parameterIndex - 최초의 파라미터의 인덱스는 1, 2 번째의 파라미터의 인덱스는 2,... 되는
reader - 파라미터치로 설정되는 데이터를 포함한 객체
예외:
SQLException - parameterIndex 가 SQL 문의 파라미터 마커에 대응하지 않는 경우, 드라이버가 각국의 캐릭터 세트를 지원하지 않는 경우, 드라이버가 데이터 변환 에러가 발생한 것을 검출할 수 있는 경우, 데이타베이스 액세스 에러가 발생했을 경우, 또는 이 메소드가 클로즈 된 PreparedStatement 로 불려 갔을 경우
SQLFeatureNotSupportedException - JDBC 드라이버가 이 메소드를 지원하지 않는 경우
도입된 버젼:
1.6
개요   패키지    클래스  사용   계층 트리   비추천 API   색인   헬프  
JavaTM Platform
Standard Ed. 6
 전의 클래스    다음의 클래스 프레임 있어    프레임 없음    
개요: 상자 | 필드 | 생성자  | 메소드 상세: 필드 | 생성자  | 메소드
버그의 보고와 기능의 요청
한층 더 자세한 API 레퍼런스 및 개발자 문서에 대해서는,Java SE 개발자용 문서를 참조해 주세요. 개발자전용의 상세한 해설, 개념의 개요, 용어의 정의, 버그의 회피책, 및 코드 실례가 포함되어 있습니다.

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms . Documentation Redistribution Policy 도 참조해 주세요.