java.sql
클래스 BatchUpdateException

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

모든 구현된 인터페이스:

Serializable

public class BatchUpdateException
extends SQLException 

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

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

도입된 버전 :

1.2

관련 항목:

직렬화 된 형식

생성자 개요

BatchUpdateException ()
reason, SQLState 및 갱신 카운트가 null, 벤더 코드가 0에 초기화된, BatchUpdateException 객체를 구축합니다.

BatchUpdateException (int[] updateCounts)
reason와 SQLState가 null, 벤더 코드가 0 으로 초기화된, BatchUpdateException을 구축합니다.

BatchUpdateException (String reason, int[] updateCounts)
reason, updateCounts, null SQLState 및 0 vendorCode 로 초기화된, BatchUpdateException을 구축합니다.

BatchUpdateException (String reason, String SQLState, int[] updateCounts)
지정된 인수 (reason, SQLState, updateCounts) 및 벤더 코드 0 으로 초기화된, BatchUpdateException을 구축합니다.

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

메서드 개요

int[]

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

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

getErrorCode, getNextException, getSQLState, 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)

완전 지정의 BatchUpdateException 객체를 구축해, 지정된 값으로 초기화합니다.

파라미터:

reason - 에러의 설명

SQLState - 에러를 식별하는 X/OPEN 코드

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

updateCounts - int 배열. 각 요소는 예외가 Throw 될 때까지 정상적으로 실행된 SQL 커멘드의 갱신 카운트를 나타내는

도입된 버전 :

1.2

BatchUpdateException

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

지정된 인수 (reason, SQLState, updateCounts) 및 벤더 코드 0 으로 초기화된, BatchUpdateException을 구축합니다.

파라미터:

reason - 예외의 설명

SQLState - 예외를 식별하는 X/OPEN 코드

updateCounts - int 배열. 각 요소는 예외가 Throw 될 때까지 정상적으로 실행된 SQL 커멘드의 갱신 카운트를 나타내는

도입된 버전 :

1.2

BatchUpdateException

public BatchUpdateException(String  reason,
                            int[] updateCounts)

reason, updateCounts, null SQLState 및 0 vendorCode 로 초기화된, BatchUpdateException을 구축합니다.

파라미터:

reason - 예외의 설명

updateCounts - int 배열. 각 요소는 예외가 Throw 될 때까지 정상적으로 실행된 SQL 커멘드의 갱신 카운트를 나타내는

도입된 버전 :

1.2

BatchUpdateException

public BatchUpdateException(int[] updateCounts)

reason와 SQLState가 null, 벤더 코드가 0 으로 초기화된, BatchUpdateException을 구축합니다.

파라미터:

updateCounts - int 배열. 각 요소는 예외가 Throw 될 때까지 정상적으로 실행된 SQL 커멘드의 갱신 카운트를 나타내는

도입된 버전 :

1.2

BatchUpdateException

public BatchUpdateException()

reason, SQLState 및 갱신 카운트가 null, 벤더 코드가 0에 초기화된, BatchUpdateException 객체를 구축합니다.

도입된 버전 :

1.2

메서드의 상세

getUpdateCounts

public int[] getUpdateCounts()

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

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

반환값:

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

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

도입된 버전 :

1.3