java.sql
클래스 BatchUpdateException

java.lang.Object 
  java.lang.Throwable 
      java.lang.Exception 
          java.sql.SQLException 
              java.sql.BatchUpdateException

모든 구현된 인터페이스:

Serializable , Iterable <Throwable >

public class BatchUpdateException
extends SQLException 

배치 갱신 조작중에 에러가 발생했을 때에 throw 되는 SQLException 의 서브 클래스입니다. BatchUpdateException 는,SQLException 에 의해 제공되는 정보에 가세해, 배치 갱신중에 정상적으로 실행된 모든 커멘드, 즉, 에러가 발생하기 전에 실행된 모든 커멘드의 갱신 카운트를 제공합니다. 갱신 카운트의 배열에서의 요소의 순서는, 커멘드가 배치에 추가되었을 때의 순서가 됩니다.

배치 갱신의 커멘드가 올바르게 실행되지 않고 BatchUpdateException 가 throw 된 뒤, 드라이버는 배치에 남아 있는 커멘드의 처리를 계속하는 일도, 중지할 수도 있습니다. 실패 후에 드라이버가 처리를 계속하는 경우,BatchUpdateException.getUpdateCounts 메소드에 의해 반환되는 배열은, 에러까지 정상적으로 실행된 커멘드의 요소 만이 아니고, 배치의 전커멘드의 요소를 포함하고 있습니다. 드라이버가 커멘드의 처리를 계속하는 경우, 실패한 커멘드의 배열 요소는 모두 Statement.EXECUTE_FAILED 가 됩니다.

도입된 버젼:

1.2

관련 항목:

직렬화 된 형식

생성자 의 개요

BatchUpdateException ()
BatchUpdateException 객체를 구축합니다.

BatchUpdateException (int[] updateCounts)
지정된 updateCounts 로 초기화된 BatchUpdateException 객체를 구축합니다.

BatchUpdateException (int[] updateCounts, Throwable cause)
지정된 cause 및 updateCounts 로 초기화된 BatchUpdateException 객체를 구축합니다.

BatchUpdateException (String reason, int[] updateCounts)
지정된 reason 및 updateCounts 로 초기화된 BatchUpdateException 객체를 구축합니다.

BatchUpdateException (String reason, int[] updateCounts, Throwable cause)
지정된 reason,cause, 및 updateCounts 로 초기화된 BatchUpdateException 객체를 구축합니다.

BatchUpdateException (String reason, String SQLState, int[] updateCounts)
지정된 reason,SQLState, 및 updateCounts 로 초기화된 BatchUpdateException 객체를 구축합니다.

BatchUpdateException (String reason, String SQLState, int[] updateCounts, Throwable cause)
지정된 reason,SQLState,cause, 및 updateCounts 로 초기화된 BatchUpdateException 객체를 구축합니다.

BatchUpdateException (String reason, String SQLState, int vendorCode, int[] updateCounts)
지정된 reason,SQLState,vendorCode, 및 updateCounts 로 초기화된 BatchUpdateException 객체를 구축합니다.

BatchUpdateException (String reason, String SQLState, int vendorCode, int[] updateCounts, Throwable cause)
지정된 reason,SQLState,vendorCode,cause, 및 updateCounts 로 초기화된 BatchUpdateException 객체를 구축합니다.

BatchUpdateException (Throwable cause)
지정된 cause 로 초기화된 BatchUpdateException 객체를 구축합니다.

메소드의 개요

int[]

getUpdateCounts () 배치 갱신내의 갱신문 가운데, 이 예외가 발생하기까지 정상적으로 실행된 것 모두에 대한 갱신 계산하기 시작합니다.

클래스 java.sql. SQLException 로부터 상속된 메소드

getErrorCode , getNextException , getSQLState , iterator , setNextException

클래스 java.lang. Throwable 로부터 상속된 메소드

fillInStackTrace , getCause , getLocalizedMessage , getMessage , getStackTrace , initCause , printStackTrace , printStackTrace , printStackTrace , setStackTrace , toString

클래스 java.lang. Object 로부터 상속된 메소드

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

생성자 의 상세

BatchUpdateException

public BatchUpdateException(String  reason,
                            String  SQLState,
                            int vendorCode,
                            int[] updateCounts)

지정된 reason,SQLState,vendorCode, 및 updateCounts 로 초기화된 BatchUpdateException 객체를 구축합니다. cause 는 초기화되지 않습니다. Throwable.initCause(java.lang.Throwable) 메소드를 호출하는 것에 의해, 나중에 이것을 초기화할 수 있습니다.

파라미터:

reason - 에러의 설명

SQLState - 예외를 식별하는 XOPEN 코드 또는 SQL:2003 코드

vendorCode - 특정의 데이타베이스 벤더의 예외 코드

updateCounts - int 의 배열. 각 요소는, 커멘드의 실패 후에 처리를 계속하는 JDBC 드라이버의 배치내에 있는 각 SQL 커멘드의 갱신 카운트,Statement.SUCCESS_NO_INFO 또는 Statement.EXECUTE_FAILED, 혹은 커멘드의 실패 후에 처리를 정지하는 JDBC 드라이버의 배치내에 있는 각 SQL 커멘드의, 실패전의 갱신 카운트 또는 Statement.SUCCESS_NO_INFO 를 나타내는

도입된 버젼:

1.2

BatchUpdateException

public BatchUpdateException(String  reason,
                            String  SQLState,
                            int[] updateCounts)

지정된 reason,SQLState, 및 updateCounts 로 초기화된 BatchUpdateException 객체를 구축합니다. cause 는 초기화되지 않습니다. Throwable.initCause(java.lang.Throwable) 메소드를 호출하는 것에 의해, 나중에 이것을 초기화할 수 있습니다. 벤더 코드는 0 에 초기화됩니다.

파라미터:

reason - 예외의 설명

SQLState - 예외를 식별하는 XOPEN 코드 또는 SQL:2003 코드

updateCounts - int 의 배열. 각 요소는, 커멘드의 실패 후에 처리를 계속하는 JDBC 드라이버의 배치내에 있는 각 SQL 커멘드의 갱신 카운트,Statement.SUCCESS_NO_INFO 또는 Statement.EXECUTE_FAILED, 혹은 커멘드의 실패 후에 처리를 정지하는 JDBC 드라이버의 배치내에 있는 각 SQL 커멘드의, 실패전의 갱신 카운트 또는 Statement.SUCCESS_NO_INFO 를 나타내는

도입된 버젼:

1.2

BatchUpdateException

public BatchUpdateException(String  reason,
                            int[] updateCounts)

지정된 reason 및 updateCounts 로 초기화된 BatchUpdateException 객체를 구축합니다. cause 는 초기화되지 않습니다. Throwable.initCause(java.lang.Throwable) 메소드를 호출하는 것에 의해, 나중에 이것을 초기화할 수 있습니다. SQLState 는 null 에 초기화되어 벤더 코드는 0 에 초기화됩니다.

파라미터:

reason - 예외의 설명

updateCounts - int 의 배열. 각 요소는, 커멘드의 실패 후에 처리를 계속하는 JDBC 드라이버의 배치내에 있는 각 SQL 커멘드의 갱신 카운트,Statement.SUCCESS_NO_INFO 또는 Statement.EXECUTE_FAILED, 혹은 커멘드의 실패 후에 처리를 정지하는 JDBC 드라이버의 배치내에 있는 각 SQL 커멘드의, 실패전의 갱신 카운트 또는 Statement.SUCCESS_NO_INFO 를 나타내는

도입된 버젼:

1.2

BatchUpdateException

public BatchUpdateException(int[] updateCounts)

지정된 updateCounts 로 초기화된 BatchUpdateException 객체를 구축합니다. Throwable.initCause(java.lang.Throwable) 메소드를 호출하는 것에 의해, 초기화됩니다. reason 및 SQLState 는 null 에 초기화되어 벤더 코드는 0 에 초기화됩니다.

파라미터:

updateCounts - int 의 배열. 각 요소는, 커멘드의 실패 후에 처리를 계속하는 JDBC 드라이버의 배치내에 있는 각 SQL 커멘드의 갱신 카운트,Statement.SUCCESS_NO_INFO 또는 Statement.EXECUTE_FAILED, 혹은 커멘드의 실패 후에 처리를 정지하는 JDBC 드라이버의 배치내에 있는 각 SQL 커멘드의, 실패전의 갱신 카운트 또는 Statement.SUCCESS_NO_INFO 를 나타내는

도입된 버젼:

1.2

BatchUpdateException

public BatchUpdateException()

BatchUpdateException 객체를 구축합니다. reason,SQLState, 및 updateCounts 는 null 에 초기화되어 벤더 코드는 0 에 초기화됩니다. cause 는 초기화되지 않습니다. Throwable.initCause(java.lang.Throwable) 메소드를 호출하는 것에 의해, 나중에 이것을 초기화할 수 있습니다.

도입된 버젼:

1.2

BatchUpdateException

public BatchUpdateException(Throwable  cause)

지정된 cause 로 초기화된 BatchUpdateException 객체를 구축합니다. SQLState 및 updateCounts 는 null 에 초기화되어 벤더 코드는 0 에 초기화됩니다. reason 는 cause==null 의 경우에 null 에 초기화되어cause! =null 의 경우에 cause.toString() 에 초기화됩니다.

파라미터:

cause - 이 SQLException 의 기가 되는 원인 (나중에 getCause() 메소드로 취득하기 위해서 보존된다). null 치가 허가되고 있어 원인이 존재하지 않는가 불명한 것을 나타내는

도입된 버젼:

1.6

BatchUpdateException

public BatchUpdateException(int[] updateCounts,
                            Throwable  cause)

지정된 cause 및 updateCounts 로 초기화된 BatchUpdateException 객체를 구축합니다. SQLState 는 null 에 초기화되어 벤더 코드는 0 에 초기화됩니다. reason 는 cause==null 의 경우에 null 에 초기화되어cause! =null 의 경우에 cause.toString() 에 초기화됩니다.

파라미터:

updateCounts - int 의 배열. 각 요소는, 커멘드의 실패 후에 처리를 계속하는 JDBC 드라이버의 배치내에 있는 각 SQL 커멘드의 갱신 카운트,Statement.SUCCESS_NO_INFO 또는 Statement.EXECUTE_FAILED, 혹은 커멘드의 실패 후에 처리를 정지하는 JDBC 드라이버의 배치내에 있는 각 SQL 커멘드의, 실패전의 갱신 카운트 또는 Statement.SUCCESS_NO_INFO 를 나타내는

cause - 이 SQLException 의 기가 되는 원인 (나중에 getCause() 메소드로 취득하기 위해서 보존된다). null 치가 허가되고 있어 원인이 존재하지 않는가 불명한 것을 나타내는

도입된 버젼:

1.6

BatchUpdateException

public BatchUpdateException(String  reason,
                            int[] updateCounts,
                            Throwable  cause)

지정된 reason,cause, 및 updateCounts 로 초기화된 BatchUpdateException 객체를 구축합니다. SQLState 은 null 에 초기화되어 벤더 코드는 0 에 초기화됩니다.

파라미터:

reason - 예외의 설명

updateCounts - int 의 배열. 각 요소는, 커멘드의 실패 후에 처리를 계속하는 JDBC 드라이버의 배치내에 있는 각 SQL 커멘드의 갱신 카운트,Statement.SUCCESS_NO_INFO 또는 Statement.EXECUTE_FAILED, 혹은 커멘드의 실패 후에 처리를 정지하는 JDBC 드라이버의 배치내에 있는 각 SQL 커멘드의, 실패전의 갱신 카운트 또는 Statement.SUCCESS_NO_INFO 를 나타내는

cause - 이 SQLException 의 기가 되는 원인 (나중에 getCause() 메소드로 취득하기 위해서 보존된다). null 치가 허가되고 있어 원인이 존재하지 않는가 불명한 것을 나타내는

도입된 버젼:

1.6

BatchUpdateException

public BatchUpdateException(String  reason,
                            String  SQLState,
                            int[] updateCounts,
                            Throwable  cause)

지정된 reason,SQLState,cause, 및 updateCounts 로 초기화된 BatchUpdateException 객체를 구축합니다. 벤더 코드는 0 에 초기화됩니다.

파라미터:

reason - 예외의 설명

SQLState - 예외를 식별하는 XOPEN 코드 또는 SQL:2003 코드

updateCounts - int 의 배열. 각 요소는, 커멘드의 실패 후에 처리를 계속하는 JDBC 드라이버의 배치내에 있는 각 SQL 커멘드의 갱신 카운트,Statement.SUCCESS_NO_INFO 또는 Statement.EXECUTE_FAILED, 혹은 커멘드의 실패 후에 처리를 정지하는 JDBC 드라이버의 배치내에 있는 각 SQL 커멘드의, 실패전의 갱신 카운트 또는 Statement.SUCCESS_NO_INFO 를 나타내는

cause - 이 SQLException 의 기가 되는 원인 (나중에 getCause() 메소드로 취득하기 위해서 보존된다). null 치가 허가되고 있어 원인이 존재하지 않는가 불명한 것을 나타내는

도입된 버젼:

1.6

BatchUpdateException

public BatchUpdateException(String  reason,
                            String  SQLState,
                            int vendorCode,
                            int[] updateCounts,
                            Throwable  cause)

지정된 reason,SQLState,vendorCode,cause, 및 updateCounts 로 초기화된 BatchUpdateException 객체를 구축합니다.

파라미터:

reason - 에러의 설명

SQLState - 예외를 식별하는 XOPEN 코드 또는 SQL:2003 코드

vendorCode - 특정의 데이타베이스 벤더의 예외 코드

updateCounts - int 의 배열. 각 요소는, 커멘드의 실패 후에 처리를 계속하는 JDBC 드라이버의 배치내에 있는 각 SQL 커멘드의 갱신 카운트,Statement.SUCCESS_NO_INFO 또는 Statement.EXECUTE_FAILED, 혹은 커멘드의 실패 후에 처리를 정지하는 JDBC 드라이버의 배치내에 있는 각 SQL 커멘드의, 실패전의 갱신 카운트 또는 Statement.SUCCESS_NO_INFO 를 나타내는

cause - 이 SQLException 의 기가 되는 원인 (나중에 getCause() 메소드로 취득하기 위해서 보존된다). null 치가 허가되고 있어 원인이 존재하지 않는가 불명한 것을 나타내는

도입된 버젼:

1.6

메소드의 상세

getUpdateCounts

public int[] getUpdateCounts()

배치 갱신내의 갱신문 가운데, 이 예외가 발생하기까지 정상적으로 실행된 것 모두에 대한 갱신 계산하기 시작합니다. 커멘드의 1 개가 올바르게 실행되지 않았던 경우, 배치 갱신을 구현하는 드라이버는, 배치에 남아 있는 커멘드의 처리를 계속하는 일도 중지할 수도 있습니다. 드라이버가 커멘드의 처리를 계속하는 경우, 이 메소드에 의해 반환되는 배열은, 배치에 있는 커멘드와 같은 수의 요소를 가지고 있습니다. 그렇지 않은 경우, 배열은,BatchUpdateException 가 throw 될 때까지 정상적으로 실행된 모든 커멘드에 대한 갱신 카운트를 포함하고 있습니다.

이 메소드에 사용할 수 있는 반환값은, Java 2 SDK, Standard Edition, Version 1.3 으로 변경되었습니다. 이것은,BatchUpdateException 객체가 throw 된 뒤도 배치 갱신내의 커멘드의 처리를 계속한다, 라고 하는 새로운 옵션에 적응하기 위해서 행해졌습니다.

반환값:

이 에러가 발생하기까지 정상적으로 실행된 갱신의 갱신 카운트를 포함한 int 형의 배열. 다만, 에러 후도 드라이버가 커멘드의 처리를 계속하는 경우는, 배치내의 각 커멘드에 대해서 다음의 몇개의 값이 포함된다.

1. 갱신 카운트
2. 커멘드가 정상적으로 실행되었지만 영향을 받은 행수는 불명한 것을 나타내는 Statement.SUCCESS_NO_INFO
3. 커멘드가 정상적으로 실행되지 않았던 것을 나타내는 Statement.EXECUTE_FAILED

도입된 버젼:

1.3