PreparedStatement (Java 2 플랫폼 SE v1. 4.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

메소드의 상세

executeQuery

public ResultSet  executeQuery()
                       throws SQLException

이 PreparedStatement 오브젝트의 SQL 쿠에리-를 실행해, 그 쿠에리-에 의해 생성된 ResultSet 오브젝트를 돌려줍니다.

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

executeUpdate

public int executeUpdate()
                  throws SQLException

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

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

setNull

public void setNull(int parameterIndex,
                    int sqlType)
             throws SQLException

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

주: 파라미터의 SQL 형을 지정하지 않으면 안됩니다.

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

setBoolean

public void setBoolean(int parameterIndex,
                       boolean x)
                throws SQLException

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

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

setByte

public void setByte(int parameterIndex,
                    byte x)
             throws SQLException

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

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

setShort

public void setShort(int parameterIndex,
                     short x)
              throws SQLException

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

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

setInt

public void setInt(int parameterIndex,
                   int x)
            throws SQLException

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

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

setLong

public void setLong(int parameterIndex,
                    long x)
             throws SQLException

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

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

setFloat

public void setFloat(int parameterIndex,
                     float x)
              throws SQLException

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

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

setDouble

public void setDouble(int parameterIndex,
                      double x)
               throws SQLException

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

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

setBigDecimal

public void setBigDecimal(int parameterIndex,
                          BigDecimal  x)
                   throws SQLException

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

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

setString

public void setString(int parameterIndex,
                      String  x)
               throws SQLException

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

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

setBytes

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

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

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

setDate

public void setDate(int parameterIndex,
                    Date  x)
             throws SQLException

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

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

setTime

public void setTime(int parameterIndex,
                    Time  x)
             throws SQLException

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

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

setTimestamp

public void setTimestamp(int parameterIndex,
                         Timestamp  x)
                  throws SQLException

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

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

setAsciiStream

public 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

public 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

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

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

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

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

clearParameters

public void clearParameters()
                     throws SQLException

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

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

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

setObject

public 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

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

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

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

setObject

public 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 형의 값으로 해서 오브젝트를 데이타베이스에 건네주지 않으면 안됩니다.

예를 들어, 오브젝트가 상기의 인터페이스를 복수 구현하는 클래스인 등, 애매함이 있는 경우, 이 메소드는 예외를 슬로우 합니다.

파라미터:: parameterIndex - 최초의 파라미터는 1, 2 번째의 파라미터는 2, 등으로 하는; x - 입력 파라미터치를 포함한 오브젝트
예외:: SQLException - 데이타베이스 액세스 에러가 발생했을 경우, 또는 지정된 오브젝트의 형태가 애매한 경우

execute

public 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

public void addBatch()
              throws SQLException

이 PreparedStatement 오브젝트의 커멘드의 배치에, 파라미터세트를 추가합니다.

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

setCharacterStream

public 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

public void setRef(int i,
                   Ref  x)
            throws SQLException

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

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

setBlob

public void setBlob(int i,
                    Blob  x)
             throws SQLException

지정된 파라미터가 지정된 Blob 오브젝트로 설정합니다. 데이타베이스에 보낼 때에, 드라이버는 이것을 SQL BLOB 치로 변환합니다.

파라미터:: i - 최초의 파라미터는 1, 2 번째의 파라미터는 2, 등으로 하는; x - SQL BLOB 치를 매핑 하는 Blob 오브젝트
예외:: SQLException - 데이타베이스 액세스 에러가 발생했을 경우
도입된 버젼:: 1.2

setClob

public void setClob(int i,
                    Clob  x)
             throws SQLException

지정된 파라미터가 지정된 Clob 오브젝트로 설정합니다. 데이타베이스에 보낼 때에, 드라이버는 이것을 SQL CLOB 치로 변환합니다.

파라미터:: i - 최초의 파라미터는 1, 2 번째의 파라미터는 2, 등으로 하는; x - SQL CLOB 치를 매핑 하는 Clob 오브젝트
예외:: SQLException - 데이타베이스 액세스 에러가 발생했을 경우
도입된 버젼:: 1.2

setArray

public void setArray(int i,
                     Array  x)
              throws SQLException

지정된 파라미터가 지정된 Array 오브젝트로 설정합니다. 데이타베이스에 보낼 때에, 드라이버는 이것을 SQL ARRAY 치로 변환합니다.

파라미터:: i - 최초의 파라미터는 1, 2 번째의 파라미터는 2, 등으로 하는; x - SQL ARRAY 치를 매핑 하는 Array 오브젝트
예외:: SQLException - 데이타베이스 액세스 에러가 발생했을 경우
도입된 버젼:: 1.2

getMetaData

public ResultSetMetaData  getMetaData()
                              throws SQLException

이 PreparedStatement 가 실행될 때 돌려주어지는 ResultSet 오브젝트의 열에 관한 정보를 저장하는 ResultSetMetaData 오브젝트를 취득합니다.

PreparedStatement 오브젝트는 프리컴파일 되므로, 실행되지 않고 돌려주어지는 ResultSet 에 대해 아는 것이 가능합니다. 따라서,PreparedStatement 에 대해 getMetaData 의 실행을 기다려, 그리고 돌려주어진 ResultSet 에 대해 ResultSet.getMetaData 를 호출하는 것이 아니라,getMetaData 를 호출할 수가 있습니다.

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

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

setDate

public 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

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

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

파라미터:: parameterIndex - 최초의 파라미터는 1, 2 번째의 파라미터는 2, 등으로 하는; x - 파라미터치; cal - 드라이버가 시각을 작성하기 위해서 사용하는 Calendar 오브젝트
예외:: SQLException - 데이타베이스 액세스 에러가 발생했을 경우
도입된 버젼:: 1.2

setTimestamp

public 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

public 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

public 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

public ParameterMetaData  getParameterMetaData()
                                       throws SQLException

이 PreparedStatement 오브젝트의 파라미터의 수, 형태, 및 프로퍼티를 취득합니다.

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

개요

패키지

클래스

사용

계층 트리

비추천 API

색인

헬프

Java^TM 2
Platform
Std. Ed. v1. 4.0

전의 클래스 다음의 클래스

프레임 있어 프레임 없음

개요: 상자 | 필드 | constructor | 메소드

상세: 필드 | constructor | 메소드

버그의 보고와 기능의 리퀘스트
이외의 API 레퍼런스 및 개발자용 문서에 대해서는 Java 2 SDK SE 개발자용 문서를 참조해 주세요. 개발자전용의 상세한 해설, 개념의 개요, 용어의 정의, 버그의 회피책, 및 코드 실례가 포함되어 있습니다.

Java, Java 2 D, 및 JDBC 는 미국 및 그 외의 나라에 있어서의 미국 Sun Microsystems, Inc. 의 상표 혹은 등록상표입니다.
Copyright 1993-2002 Sun Microsystems, Inc. 901 San Antonio Road
Palo Alto, California, 94303, U.S.A. All Rights Reserved.

메소드의 개요
`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 인터페이스 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