compact2, compact3

java.sql

Класс BatchUpdateException

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.

Реализация драйвера JDBC должна использовать конструктора BatchUpdateException(String reason, String SQLState, int vendorCode, long []updateCounts,Throwable cause) вместо конструкторов, которые берут int[] поскольку обновление рассчитывает, чтобы избежать возможности переполнения.

Если Statement.executeLargeBatch метод вызывается, ему рекомендуют это getLargeUpdateCounts вместо вызовите getUpdateCounts чтобы избежать возможного переполнения целочисленного количества обновления.

С тех пор:

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(String reason, String SQLState, int vendorCode, long[] updateCounts, Throwable cause) Конструкции a BatchUpdateException объект инициализируется с данным reason, SQLState, vendorCode cause и updateCounts.
BatchUpdateException(Throwable cause) Конструкции a BatchUpdateException объект инициализируется с данным cause.

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

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

Методы, наследованные от class java.sql. SQLException

getErrorCode, getNextException, getSQLState, iterator, setNextException

Методы, наследованные от class java.lang. Throwable

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

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

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

Методы, наследованные от интерфейса java.lang. Повторяемый

forEach

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

BatchUpdateException

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

Конструкции a BatchUpdateException объект инициализируется с данным reason, SQLState, vendorCode и updateCounts. cause не инициализируется, и может впоследствии быть инициализирован звонком Throwable.initCause(java.lang.Throwable) метод.

Отметьте: нет никакой проверки допустимости updateCounts для переполнения и из-за этого рекомендуется, чтобы Вы использовали конструктора BatchUpdateException(String reason, String SQLState, int vendorCode, long []updateCounts,Throwable cause) .

Параметры:

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(java.lang.String, java.lang.String, int, long[], java.lang.Throwable)

BatchUpdateException

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

Конструкции a BatchUpdateException объект инициализируется с данным reason, SQLState и updateCounts. cause не инициализируется, и может впоследствии быть инициализирован звонком Throwable.initCause(java.lang.Throwable) метод. Код поставщика инициализируется к 0.

Отметьте: нет никакой проверки допустимости updateCounts для переполнения и из-за этого рекомендуется, чтобы Вы использовали конструктора BatchUpdateException(String reason, String SQLState, int vendorCode, long []updateCounts,Throwable cause) .

Параметры:

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(java.lang.String, java.lang.String, int, long[], java.lang.Throwable)

BatchUpdateException

public BatchUpdateException(String reason,
                            int[] updateCounts)

Конструкции a BatchUpdateException объект инициализируется с данным reason и updateCounts. cause не инициализируется, и может впоследствии быть инициализирован звонком Throwable.initCause(java.lang.Throwable) метод. SQLState инициализируется к null и код уличного торговца инициализируется к 0.

Отметьте: нет никакой проверки допустимости updateCounts для переполнения и из-за этого рекомендуется, чтобы Вы использовали конструктора BatchUpdateException(String reason, String SQLState, int vendorCode, long []updateCounts,Throwable cause) .

Параметры:

reason - описание исключения

updateCounts - массив int, с каждым элементом, указывающим на количество обновления, Statement.SUCCESS_NO_INFO или Statement.EXECUTE_FAILED для каждой команды SQL в пакете для драйверов JDBC, которые продолжают обрабатывать после отказа команды; количество обновления или Statement.SUCCESS_NO_INFO для каждой команды SQL в пакете до отказа для драйверов JDBC, которые прекращают обрабатывать после отказа команды

С тех пор:

1.2

См. Также:

BatchUpdateException(java.lang.String, java.lang.String, int, long[], java.lang.Throwable)

BatchUpdateException

public BatchUpdateException(int[] updateCounts)

Конструкции a BatchUpdateException объект инициализируется с данным updateCounts. инициализированный звонком Throwable.initCause(java.lang.Throwable) метод. reason и SQLState инициализируются к нулю, и код поставщика инициализируется к 0.

Отметьте: нет никакой проверки допустимости updateCounts для переполнения и из-за этого рекомендуется, чтобы Вы использовали конструктора BatchUpdateException(String reason, String SQLState, int vendorCode, long []updateCounts,Throwable cause) .

Параметры:

updateCounts - массив int, с каждым элементом, указывающим на количество обновления, Statement.SUCCESS_NO_INFO или Statement.EXECUTE_FAILED для каждой команды SQL в пакете для драйверов JDBC, которые продолжают обрабатывать после отказа команды; количество обновления или Statement.SUCCESS_NO_INFO для каждой команды SQL в пакете до отказа для драйверов JDBC, которые прекращают обрабатывать после отказа команды

С тех пор:

1.2

См. Также:

BatchUpdateException(java.lang.String, java.lang.String, int, long[], java.lang.Throwable)

BatchUpdateException

public BatchUpdateException()

Конструкции a BatchUpdateException объект. reason, SQLState и updateCounts инициализируются к null и код поставщика инициализируется к 0. cause не инициализируется, и может впоследствии быть инициализирован звонком Throwable.initCause(java.lang.Throwable) метод.

С тех пор:

1.2

См. Также:

BatchUpdateException(java.lang.String, java.lang.String, int, long[], java.lang.Throwable)

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(java.lang.String, java.lang.String, int, long[], java.lang.Throwable)

BatchUpdateException

public BatchUpdateException(int[] updateCounts,
                            Throwable cause)

Конструкции a BatchUpdateException объект инициализируется с данным cause и updateCounts. SQLState инициализируется к null и код поставщика инициализируется к 0. reason инициализируется к null если cause==null или к cause.toString() если cause!=null.

Отметьте: нет никакой проверки допустимости updateCounts для переполнения и из-за этого рекомендуется, чтобы Вы использовали конструктора BatchUpdateException(String reason, String SQLState, int vendorCode, long []updateCounts,Throwable cause) .

Параметры:

updateCounts - массив int, с каждым элементом, указывающим на количество обновления, Statement.SUCCESS_NO_INFO или Statement.EXECUTE_FAILED для каждой команды SQL в пакете для драйверов JDBC, которые продолжают обрабатывать после отказа команды; количество обновления или Statement.SUCCESS_NO_INFO для каждой команды SQL в пакете до отказа для драйверов JDBC, которые прекращают обрабатывать после отказа команды

cause - базовая причина этого SQLException (который сохраняется для более позднего извлечения getCause() метод); может быть нулевое указание, что причина является несуществующей или неизвестной.

С тех пор:

1.6

См. Также:

BatchUpdateException(java.lang.String, java.lang.String, int, long[], java.lang.Throwable)

BatchUpdateException

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

Конструкции a BatchUpdateException объект инициализируется с данным reason, cause и updateCounts. SQLState инициализируется к null и код поставщика инициализируется к 0.

Отметьте: нет никакой проверки допустимости updateCounts для переполнения и из-за этого рекомендуется, чтобы Вы использовали конструктора BatchUpdateException(String reason, String SQLState, int vendorCode, long []updateCounts,Throwable cause) .

Параметры:

reason - описание исключения

updateCounts - массив int, с каждым элементом, указывающим на количество обновления, Statement.SUCCESS_NO_INFO или Statement.EXECUTE_FAILED для каждой команды SQL в пакете для драйверов JDBC, которые продолжают обрабатывать после отказа команды; количество обновления или Statement.SUCCESS_NO_INFO для каждой команды SQL в пакете до отказа для драйверов JDBC, которые прекращают обрабатывать после отказа команды

cause - базовая причина этого SQLException (который сохраняется для более позднего извлечения getCause() метод); может быть нулевое указание, что причина является несуществующей или неизвестной.

С тех пор:

1.6

См. Также:

BatchUpdateException(java.lang.String, java.lang.String, int, long[], java.lang.Throwable)

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, которые прекращают обрабатывать после отказа команды

Отметьте: нет никакой проверки допустимости updateCounts для переполнения и из-за этого рекомендуется, чтобы Вы использовали конструктора BatchUpdateException(String reason, String SQLState, int vendorCode, long []updateCounts,Throwable cause) .

cause - базовая причина этого SQLException (который сохраняется для более позднего извлечения getCause() метод); может быть нулевое указание, что причина является несуществующей или неизвестной.

С тех пор:

1.6

См. Также:

BatchUpdateException(java.lang.String, java.lang.String, int, long[], java.lang.Throwable)

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, которые прекращают обрабатывать после отказа команды

Отметьте: нет никакой проверки допустимости updateCounts для переполнения и из-за этого рекомендуется, чтобы Вы использовали конструктора BatchUpdateException(String reason, String SQLState, int vendorCode, long []updateCounts,Throwable cause) .

cause - базовая причина этого SQLException (который сохраняется для более позднего извлечения getCause() метод); может быть нулевое указание, что причина является несуществующей или неизвестной.

С тех пор:

1.6

См. Также:

BatchUpdateException(java.lang.String, java.lang.String, int, long[], java.lang.Throwable)

BatchUpdateException

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

Конструкции a BatchUpdateException объект инициализируется с данным reason, SQLState, vendorCode cause и updateCounts.

Этот конструктор должен использоваться, когда возвращенное количество обновления может превысить Integer.MAX_VALUE.

Параметры:

reason - описание ошибки

SQLState - XOPEN или код SQL:2003, идентифицирующий исключение

vendorCode - код исключения используется определенным поставщиком базы данных

updateCounts - массив long, с каждым элементом, указывающим на количество обновления, Statement.SUCCESS_NO_INFO или Statement.EXECUTE_FAILED для каждой команды SQL в пакете для драйверов JDBC, которые продолжают обрабатывать после отказа команды; количество обновления или Statement.SUCCESS_NO_INFO для каждой команды SQL в пакете до отказа для драйверов JDBC, которые прекращают обрабатывать после отказа команды

cause - базовая причина этого SQLException (который сохраняется для более позднего извлечения getCause() метод); может быть нулевое указание, что причина является несуществующей или неизвестной.

С тех пор:

1.8

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

getUpdateCounts

public int[] getUpdateCounts()

Получает счет обновления для каждого оператора обновления в пакетном обновлении, которое выполнилось успешно прежде, чем это исключение произошло. Драйвер, который реализует пакетные обновления, может или, возможно, не продолжает обрабатывать остающиеся команды в пакете, когда одна из команд не в состоянии выполниться должным образом. Если драйвер будет продолжать обрабатывать команды, то у массива, возвращенного этим методом, будет так много элементов, как есть команды в пакете; иначе, это будет содержать счет обновления для каждой команды, которая выполнилась успешно перед BatchUpdateException был брошен.

Возможные возвращаемые значения для этого метода были изменены для Java 2 SDK, Standard Edition, версия 1.3. Это было сделано, чтобы разместить новую опцию продолжения обработать команды в пакетном обновлении после a BatchUpdateException объект был брошен.

Возвраты:

массив int содержа обновление значит обновления, которые выполнялись успешно прежде, чем эта ошибка произошла. Или, если драйвер продолжает обрабатывать команды после ошибки, одного из следующего для каждой команды в пакете:

1. количество обновления
2. Statement.SUCCESS_NO_INFO указать, что команда, выполняемая успешно, но число строк, на которые влияют, неизвестна
3. Statement.EXECUTE_FAILED указать что команда, отказавшая, чтобы выполниться успешно

С тех пор:

1.3

См. Также:

getLargeUpdateCounts()

getLargeUpdateCounts

public long[] getLargeUpdateCounts()

Получает счет обновления для каждого оператора обновления в пакетном обновлении, которое выполнилось успешно прежде, чем это исключение произошло. Драйвер, который реализует пакетные обновления, может или, возможно, не продолжает обрабатывать остающиеся команды в пакете, когда одна из команд не в состоянии выполниться должным образом. Если драйвер будет продолжать обрабатывать команды, то у массива, возвращенного этим методом, будет так много элементов, как есть команды в пакете; иначе, это будет содержать счет обновления для каждой команды, которая выполнилась успешно перед BatchUpdateException был брошен.

Этот метод должен использоваться когда Statement.executeLargeBatch вызывается и возвращенное количество обновления может превысить Integer.MAX_VALUE.

Возвраты:

массив long содержа обновление значит обновления, которые выполнялись успешно прежде, чем эта ошибка произошла. Или, если драйвер продолжает обрабатывать команды после ошибки, одного из следующего для каждой команды в пакете:

1. количество обновления
2. Statement.SUCCESS_NO_INFO указать, что команда, выполняемая успешно, но число строк, на которые влияют, неизвестна
3. Statement.EXECUTE_FAILED указать что команда, отказавшая, чтобы выполниться успешно

С тех пор:

1.8