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 가 슬로우 된 뒤, 드라이버는 배치에 남아 있는 커멘드의 처리를 계속하는 일도, 중지할 수도 있습니다. 실패 후에 드라이버가 처리를 계속하는 경우, 메소드 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 의 배열. 각 요소는 예외가 슬로우 될 때까지 정상적으로 실행된 SQL 커멘드의 갱신 카운트를 나타내는

도입된 버젼:

1.2

BatchUpdateException

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

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

파라미터:

reason - 예외의 설명

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

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

도입된 버젼:

1.2

BatchUpdateException

public BatchUpdateException(String  reason,
                            int[] updateCounts)

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

파라미터:

reason - 예외의 설명

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

도입된 버젼:

1.2

BatchUpdateException

public BatchUpdateException(int[] updateCounts)

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

파라미터:

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

도입된 버젼:

1.2

BatchUpdateException

public BatchUpdateException()

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

도입된 버젼:

1.2

메소드의 상세

getUpdateCounts

public int[] getUpdateCounts()

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

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

반환값:

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

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

도입된 버젼:

1.3