Класс DataTruncation

java.sql.DataTruncation

Все реализуемые интерфейсы:: Serializable, Iterable<Throwable>

public class DataTruncation extends SQLWarning

Исключение, выбрасываемое как исключение DataTruncation (при записи) или сообщаемое как предупреждение DataTruncation (при чтении), если значение данных неожиданно усекается по причинам, отличным от превышения MaxFieldSize.

SQLState для DataTruncation при чтении — 01004.

SQLState для DataTruncation при записи — 22001.

С версии:

1.1

См. также:

Краткое описание конструкторов

Конструктор Описание

Конструктор	Описание
`DataTruncation(int index, boolean parameter, boolean read, int dataSize, int transferSize)`	Создает объект `DataTruncation` с SQLState, инициализированным значением 01004, если `read` имеет значение `true`, и значением 22001, если `read` имеет значение `false`; причина устанавливается в значение "Data truncation", код поставщика — в 0, а остальные поля — в переданные значения.
`DataTruncation(int index, boolean parameter, boolean read, int dataSize, int transferSize, Throwable cause)`	Создает объект `DataTruncation` с SQLState, инициализированным значением 01004, если `read` имеет значение `true`, и значением 22001, если `read` имеет значение `false`; причина устанавливается в значение "Data truncation", код поставщика — в 0, а остальные поля — в переданные значения.

DataTruncation(int index,
 boolean parameter,
 boolean read,
 int dataSize,
 int transferSize)

Создает объект DataTruncation с SQLState, инициализированным значением 01004, если read имеет значение true, и значением 22001, если read имеет значение false; причина устанавливается в значение "Data truncation", код поставщика — в 0, а остальные поля — в переданные значения.

DataTruncation(int index,
 boolean parameter,
 boolean read,
 int dataSize,
 int transferSize,
 Throwable cause)

Краткое описание методов

Модификатор и тип	Метод	Описание
`int`	`getDataSize()`	Возвращает количество байтов данных, которые должны были быть переданы.
`int`	`getIndex()`	Возвращает индекс усеченного столбца или параметра.
`boolean`	`getParameter()`	Указывает, было ли усеченное значение значением параметра или столбца.
`boolean`	`getRead()`	Указывает, было ли значение усечено при чтении.
`int`	`getTransferSize()`	Возвращает количество байтов фактически переданных данных.

Методы, объявленные в классе SQLWarning

getNextWarning, setNextWarning

Модификатор и тип	Метод	Описание
`SQLWarning`	`getNextWarning()`	Возвращает предупреждение, добавленное в цепочку этого объекта `SQLWarning` с помощью `setNextWarning`.
`void`	`setNextWarning(SQLWarning w)`	Добавляет объект `SQLWarning` в конец цепочки.

Методы, объявленные в классе SQLException

getErrorCode, getNextException, getSQLState, iterator, setNextException

Модификатор и тип	Метод	Описание
`int`	`getErrorCode()`	Возвращает код исключения, специфичный для поставщика, для этого объекта `SQLException`.
`SQLException`	`getNextException()`	Возвращает исключение, добавленное в цепочку этого объекта `SQLException` методом setNextException(SQLException ex).
`String`	`getSQLState()`	Возвращает SQLState этого объекта `SQLException`.
`Iterator<Throwable>`	`iterator()`	Возвращает итератор для цепочки объектов SQLException.
`void`	`setNextException(SQLException ex)`	Добавляет объект `SQLException` в конец цепочки.

Методы, объявленные в классе Throwable

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

Модификатор и тип	Метод	Описание
`final void`	`addSuppressed(Throwable exception)`	Добавляет указанное исключение к исключениям, которые были подавлены для передачи этого исключения.
`Throwable`	`fillInStackTrace()`	Заполняет трассировку стека вызовов.
`Throwable`	`getCause()`	Возвращает причину возникновения этого исключения или `null`, если причина отсутствует или неизвестна.
`String`	`getLocalizedMessage()`	Создает локализованное описание этого исключения.
`String`	`getMessage()`	Возвращает строку с подробным сообщением этого исключения.
`StackTraceElement[]`	`getStackTrace()`	Предоставляет программный доступ к сведениям о трассировке стека, выводимым методом `Throwable.printStackTrace()`.
`final Throwable[]`	`getSuppressed()`	Возвращает массив, содержащий все исключения, которые были подавлены, обычно оператором `try`-with-resources, для передачи этого исключения.
`Throwable`	`initCause(Throwable cause)`	Инициализирует причину возникновения этого исключения указанным значением.
`void`	`printStackTrace()`	Выводит это исключение и трассировку его стека в стандартный поток ошибок.
`void`	`printStackTrace(PrintStream s)`	Выводит это исключение и трассировку его стека в указанный поток печати.
`void`	`printStackTrace(PrintWriter s)`	Выводит это исключение и трассировку его стека в указанный объект PrintWriter.
`void`	`setStackTrace(StackTraceElement[] stackTrace)`	Устанавливает элементы трассировки стека, которые будут возвращены методом `Throwable.getStackTrace()` и выведены методом `Throwable.printStackTrace()` и связанными методами.
`String`	`toString()`	Возвращает краткое описание этого исключения.

Методы, объявленные в классе Object

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

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создает и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Показывает, равен ли этот объект некоторому другому объекту.
`protected void`	`finalize()`	Устарело, будет удалено: этот элемент API планируется удалить в будущей версии. Финализация объявлена устаревшей и планируется к удалению в одном из будущих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`int`	`hashCode()`	Возвращает хеш-код этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`final void`	`wait()`	Заставляет текущий поток ожидать до пробуждения, обычно в результате вызова notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать до пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать до пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного промежутка реального времени.

Методы, объявленные в интерфейсе Iterable

forEach, spliterator

Модификатор и тип	Метод	Описание
`default void`	`forEach(Consumer<? super Throwable> action)`	Выполняет указанное действие для каждого элемента `Iterable`, пока не будут обработаны все элементы или действие не вызовет исключение.
`default Spliterator<Throwable>`	`spliterator()`	Создает `Spliterator` для элементов, описанных этим `Iterable`.

Подробное описание конструкторов

DataTruncation

public DataTruncation(int index, boolean parameter, boolean read, int dataSize, int transferSize)

Параметры:: index — индекс значения параметра или столбца; parameter — true, если было усечено значение параметра; read — true, если при чтении произошло усечение; dataSize — исходный размер данных; transferSize — размер после усечения

DataTruncation

public DataTruncation(int index, boolean parameter, boolean read, int dataSize, int transferSize, Throwable cause)

Параметры:: index — индекс значения параметра или столбца; parameter — true, если было усечено значение параметра; read — true, если при чтении произошло усечение; dataSize — исходный размер данных; transferSize — размер после усечения; cause — исходная причина этого DataTruncation (сохраняется для последующего получения методом getCause()); может быть null, что указывает на отсутствие или неизвестность причины.
С версии:: 1.6

Подробное описание методов

getIndex

public int getIndex()

Возвращает индекс усеченного столбца или параметра.

Значение может быть равно -1, если индекс столбца или параметра неизвестен; в этом случае поля parameter и read следует игнорировать.

Возвращает:: индекс усеченного значения параметра или столбца

getParameter

public boolean getParameter()

Указывает, было ли усеченное значение значением параметра или столбца.

Возвращает:: true, если усеченное значение было параметром; false, если это было значение столбца

getRead

public boolean getRead()

Указывает, было ли значение усечено при чтении.

Возвращает:: true, если значение было усечено при чтении из базы данных; false, если данные были усечены при записи

getDataSize

public int getDataSize()

Возвращает количество байтов данных, которые должны были быть переданы. Это число может быть приблизительным, если выполнялось преобразование данных. Значение может быть равно -1, если размер неизвестен.

Возвращает:: количество байтов данных, которые должны были быть переданы

getTransferSize

public int getTransferSize()

Возвращает количество байтов фактически переданных данных. Значение может быть равно -1, если размер неизвестен.

Возвращает:: количество байтов фактически переданных данных

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.