BatchUpdateException (Платформа Java SE 7)

java.lang. Объект
- java.lang. Throwable
- - java.lang. Исключение
  - - java.sql. SQLException
    - - java.sql. BatchUpdateException

Все Реализованные Интерфейсы:

Сериализуемый, Повторяемый <Throwable>
```
public class BatchUpdateException
extends SQLException
```
Подкласс SQLException брошенный, когда ошибка происходит во время работы пакетного обновления. В дополнение к информации, предоставленной SQLException, a BatchUpdateException обеспечивает счета обновления для всех команд, которые выполнялись успешно во время пакетного обновления, то есть, всех команд, которые выполнялись прежде, чем ошибка произошла. Порядок элементов в массиве количеств обновления соответствует порядку, в котором команды были добавлены к пакету.
После того, как команда в пакетном обновлении не в состоянии выполниться должным образом и a BatchUpdateException бросается, драйвер может или, возможно, не продолжает обрабатывать остающиеся команды в пакете. Если драйвер продолжает обрабатывать после отказа, массив, возвращенный методом BatchUpdateException.getUpdateCounts будет иметь элемент для каждой команды в пакетном, а не только элементы для команд, которые выполнились успешно перед ошибкой. В случае, где драйвер продолжает обрабатывать команды, элемент массива для любой команды, которая перестала работать, Statement.EXECUTE_FAILED.

С тех пор:

1.2

См. Также:
Сериализированная Форма

Сводка конструктора

Конструкторы
Конструктор и Описание
`BatchUpdateException()` Конструкции a `BatchUpdateException` объект.
`BatchUpdateException(int[] updateCounts)` Конструкции a `BatchUpdateException` объект инициализируется с данным `updateCounts`.
`BatchUpdateException(int[] updateCounts, Throwable cause)` Конструкции a `BatchUpdateException` объект инициализируется с данным `cause` и `updateCounts`.
`BatchUpdateException(String reason, int[] updateCounts)` Конструкции a `BatchUpdateException` объект инициализируется с данным `reason` и `updateCounts`.
`BatchUpdateException(String reason, int[] updateCounts, Throwable cause)` Конструкции a `BatchUpdateException` объект инициализируется с данным `reason`, `cause` и `updateCounts`.
`BatchUpdateException(String reason, String SQLState, int[] updateCounts)` Конструкции a `BatchUpdateException` объект инициализируется с данным `reason`, `SQLState` и `updateCounts`.
`BatchUpdateException(String reason, String SQLState, int[] updateCounts, Throwable cause)` Конструкции a `BatchUpdateException` объект инициализируется с данным `reason`, `SQLState`,`cause`, и `updateCounts`.
`BatchUpdateException(String reason, String SQLState, int vendorCode, int[] updateCounts)` Конструкции a `BatchUpdateException` объект инициализируется с данным `reason`, `SQLState`, `vendorCode` и `updateCounts`.
`BatchUpdateException(String reason, String SQLState, int vendorCode, int[] updateCounts, Throwable cause)` Конструкции a `BatchUpdateException` объект инициализируется с данным `reason`, `SQLState`, `vendorCode` `cause` и `updateCounts`.
`BatchUpdateException(Throwable cause)` Конструкции a `BatchUpdateException` объект инициализируется с данным `cause`.

Сводка метода

Методы
Модификатор и Тип	Метод и Описание
`int[]`	`getUpdateCounts()` Получает счет обновления для каждого оператора обновления в пакетном обновлении, которое выполнилось успешно прежде, чем это исключение произошло.

Методы java.sql унаследованный от класса. SQLException
getErrorCode, getNextException, getSQLState, iterator, setNextException

Методы java.lang унаследованный от класса. Throwable
addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

Методы java.lang унаследованный от класса. Объект
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- Деталь конструктора
  - BatchUpdateException
```
public BatchUpdateException(String reason,
                    String SQLState,
                    int vendorCode,
                    int[] updateCounts)
```
    Конструкции a BatchUpdateException объект инициализируется с данным reason, SQLState, vendorCode и updateCounts. cause не инициализируется, и может впоследствии быть инициализирован звонком Throwable.initCause(java.lang.Throwable) метод.
    
    Параметры:
    reason - описание ошибки
    SQLState - XOPEN или код SQL:2003, идентифицирующий исключение
    vendorCode - код исключения используется определенным поставщиком базы данных
    updateCounts - массив int, с каждым элементом, указывающим на количество обновления, Statement.SUCCESS_NO_INFO или Statement.EXECUTE_FAILED для каждой команды SQL в пакете для драйверов JDBC, которые продолжают обрабатывать после отказа команды; количество обновления или Statement.SUCCESS_NO_INFO для каждой команды SQL в пакете до отказа для драйверов JDBC, которые прекращают обрабатывать после отказа команды
    С тех пор:
    
    1.2
  - BatchUpdateException
```
public BatchUpdateException(String reason,
                    String SQLState,
                    int[] updateCounts)
```
    Конструкции a BatchUpdateException объект инициализируется с данным reason, SQLState и updateCounts. cause не инициализируется, и может впоследствии быть инициализирован звонком Throwable.initCause(java.lang.Throwable) метод. Код поставщика инициализируется к 0.
    
    Параметры:
    reason - описание исключения
    SQLState - XOPEN или код SQL:2003, идентифицирующий исключение
    updateCounts - массив int, с каждым элементом, указывающим на количество обновления, Statement.SUCCESS_NO_INFO или Statement.EXECUTE_FAILED для каждой команды SQL в пакете для драйверов JDBC, которые продолжают обрабатывать после отказа команды; количество обновления или Statement.SUCCESS_NO_INFO для каждой команды SQL в пакете до отказа для драйверов JDBC, которые прекращают обрабатывать после отказа команды
    С тех пор:
    
    1.2
  - BatchUpdateException
```
public BatchUpdateException(String reason,
                    int[] updateCounts)
```
    Конструкции a BatchUpdateException объект инициализируется с данным reason и updateCounts. cause не инициализируется, и может впоследствии быть инициализирован звонком Throwable.initCause(java.lang.Throwable) метод. SQLState инициализируется к null и код уличного торговца инициализируется к 0.
    
    Параметры:
    reason - описание исключения
    updateCounts - массив int, с каждым элементом, указывающим на количество обновления, Statement.SUCCESS_NO_INFO или Statement.EXECUTE_FAILED для каждой команды SQL в пакете для драйверов JDBC, которые продолжают обрабатывать после отказа команды; количество обновления или Statement.SUCCESS_NO_INFO для каждой команды SQL в пакете до отказа для драйверов JDBC, которые прекращают обрабатывать после отказа команды
    С тех пор:
    
    1.2
  - BatchUpdateException
```
public BatchUpdateException(int[] updateCounts)
```
    Конструкции a BatchUpdateException объект инициализируется с данным updateCounts. инициализированный звонком Throwable.initCause(java.lang.Throwable) метод. reason и SQLState инициализируются к нулю, и код поставщика инициализируется к 0.
    
    Параметры:
    updateCounts - массив int, с каждым элементом, указывающим на количество обновления, Statement.SUCCESS_NO_INFO или Statement.EXECUTE_FAILED для каждой команды SQL в пакете для драйверов JDBC, которые продолжают обрабатывать после отказа команды; количество обновления или Statement.SUCCESS_NO_INFO для каждой команды SQL в пакете до отказа для драйверов JDBC, которые прекращают обрабатывать после отказа команды
    С тех пор:
    
    1.2
  - BatchUpdateException
```
public BatchUpdateException()
```
    Конструкции a BatchUpdateException объект. reason, SQLState и updateCounts инициализируются к null и код поставщика инициализируется к 0. cause не инициализируется, и может впоследствии быть инициализирован звонком Throwable.initCause(java.lang.Throwable) метод.
    
    С тех пор:
    
    1.2
  - BatchUpdateException
```
public BatchUpdateException(Throwable cause)
```
    Конструкции a BatchUpdateException объект инициализируется с данным cause. SQLState и updateCounts инициализируются к null и код поставщика инициализируется к 0. reason инициализируется к null если cause==null или к cause.toString() если cause!=null.
    
    Параметры:
    cause - базовая причина этого SQLException (который сохраняется для более позднего извлечения getCause() метод); может быть нулевое указание, что причина является несуществующей или неизвестной.
    С тех пор:
    
    1.6
  - BatchUpdateException
```
public BatchUpdateException(int[] updateCounts,
                    Throwable cause)
```
    Конструкции a BatchUpdateException объект инициализируется с данным cause и updateCounts. SQLState инициализируется к null и код поставщика инициализируется к 0. reason инициализируется к null если cause==null или к cause.toString() если cause!=null.
    
    Параметры:
    updateCounts - массив int, с каждым элементом, указывающим на количество обновления, Statement.SUCCESS_NO_INFO или Statement.EXECUTE_FAILED для каждой команды SQL в пакете для драйверов JDBC, которые продолжают обрабатывать после отказа команды; количество обновления или Statement.SUCCESS_NO_INFO для каждой команды SQL в пакете до отказа для драйверов JDBC, которые прекращают обрабатывать после отказа команды
    cause - базовая причина этого SQLException (который сохраняется для более позднего извлечения getCause() метод); может быть нулевое указание, что причина является несуществующей или неизвестной.
    С тех пор:
    
    1.6
  - BatchUpdateException
```
public BatchUpdateException(String reason,
                    int[] updateCounts,
                    Throwable cause)
```
    Конструкции a BatchUpdateException объект инициализируется с данным reason, cause и updateCounts. SQLState инициализируется к null и код поставщика инициализируется к 0.
    
    Параметры:
    reason - описание исключения
    updateCounts - массив int, с каждым элементом, указывающим на количество обновления, Statement.SUCCESS_NO_INFO или Statement.EXECUTE_FAILED для каждой команды SQL в пакете для драйверов JDBC, которые продолжают обрабатывать после отказа команды; количество обновления или Statement.SUCCESS_NO_INFO для каждой команды SQL в пакете до отказа для драйверов JDBC, которые прекращают обрабатывать после отказа команды
    cause - базовая причина этого SQLException (который сохраняется для более позднего извлечения getCause() метод); может быть нулевое указание, что причина является несуществующей или неизвестной.
    С тех пор:
    
    1.6
  - BatchUpdateException
```
public BatchUpdateException(String reason,
                    String SQLState,
                    int[] updateCounts,
                    Throwable cause)
```
    Конструкции a BatchUpdateException объект инициализируется с данным reason, SQLState,cause, и updateCounts. Код поставщика инициализируется к 0.
    
    Параметры:
    reason - описание исключения
    SQLState - XOPEN или код SQL:2003, идентифицирующий исключение
    updateCounts - массив int, с каждым элементом, указывающим на количество обновления, Statement.SUCCESS_NO_INFO или Statement.EXECUTE_FAILED для каждой команды SQL в пакете для драйверов JDBC, которые продолжают обрабатывать после отказа команды; количество обновления или Statement.SUCCESS_NO_INFO для каждой команды SQL в пакете до отказа для драйверов JDBC, которые прекращают обрабатывать после отказа команды
    cause - базовая причина этого SQLException (который сохраняется для более позднего извлечения getCause() метод); может быть нулевое указание, что причина является несуществующей или неизвестной.
    С тех пор:
    
    1.6
  - BatchUpdateException
```
public BatchUpdateException(String reason,
                    String SQLState,
                    int vendorCode,
                    int[] updateCounts,
                    Throwable cause)
```
    Конструкции a BatchUpdateException объект инициализируется с данным reason, SQLState, vendorCode cause и updateCounts.
    
    Параметры:
    reason - описание ошибки
    SQLState - XOPEN или код SQL:2003, идентифицирующий исключение
    vendorCode - код исключения используется определенным поставщиком базы данных
    updateCounts - массив int, с каждым элементом, указывающим на количество обновления, Statement.SUCCESS_NO_INFO или Statement.EXECUTE_FAILED для каждой команды SQL в пакете для драйверов JDBC, которые продолжают обрабатывать после отказа команды; количество обновления или Statement.SUCCESS_NO_INFO для каждой команды SQL в пакете до отказа для драйверов JDBC, которые прекращают обрабатывать после отказа команды
    cause - базовая причина этого SQLException (который сохраняется для более позднего извлечения getCause() метод); может быть нулевое указание, что причина является несуществующей или неизвестной.
    С тех пор:
    
    1.6
- Деталь метода
  - getUpdateCounts
```
public int[] getUpdateCounts()
```
    Получает счет обновления для каждого оператора обновления в пакетном обновлении, которое выполнилось успешно прежде, чем это исключение произошло. Драйвер, который реализует пакетные обновления, может или, возможно, не продолжает обрабатывать остающиеся команды в пакете, когда одна из команд не в состоянии выполниться должным образом. Если драйвер будет продолжать обрабатывать команды, то у массива, возвращенного этим методом, будет так много элементов, как есть команды в пакете; иначе, это будет содержать счет обновления для каждой команды, которая выполнилась успешно перед BatchUpdateException был брошен.
    Возможные возвращаемые значения для этого метода были изменены для Java 2 SDK, Standard Edition, версия 1.3. Это было сделано, чтобы разместить новую опцию продолжения обработать команды в пакетном обновлении после a BatchUpdateException объект был брошен.
    Возвраты:
    массив int содержа обновление значит обновления, которые выполнялись успешно прежде, чем эта ошибка произошла. Или, если драйвер продолжает обрабатывать команды после ошибки, одного из следующего для каждой команды в пакете:
    
    количество обновления
    Statement.SUCCESS_NO_INFO указать, что команда, выполняемая успешно, но число строк, на которые влияют, неизвестна
    Statement.EXECUTE_FAILED указать что команда, отказавшая, чтобы выполниться успешно
    С тех пор:
    
    1.3

Представьте ошибку или функцию
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2011, Oracle и/или его филиалы. Все права защищены.

Класс BatchUpdateException

Сводка конструктора

Сводка метода

Методы java.sql унаследованный от класса. SQLException

Методы java.lang унаследованный от класса. Throwable

Методы java.lang унаследованный от класса. Объект

Деталь конструктора

BatchUpdateException

BatchUpdateException

BatchUpdateException

BatchUpdateException

BatchUpdateException

BatchUpdateException

BatchUpdateException

BatchUpdateException

BatchUpdateException

BatchUpdateException

Деталь метода

getUpdateCounts