Класс CharsetDecoder

Этот метод вызывает метод implReplaceWith, передавая новую замену после проверки того, что новая замена приемлема.

По умолчанию этот метод ничего не делает. Этот метод должен быть переопределён декодерами, которые требуют уведомления об изменениях значения замены.

Этот метод вызывает метод implOnMalformedInput, передавая новое действие.

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

Этот метод вызывает метод implOnUnmappableCharacter, передавая новое действие.

По умолчанию этот метод ничего не делает. Этот метод должен быть переопределён декодерами, которые требуют уведомления об изменениях действия для ошибок неузнаваемых символов.

Буферы читаются и записываются, начиная с их текущих позиций. Максимально будет считано in.remaining() байтов, и максимально будет записано out.remaining() символов. Позиции буферов будут изменены для отражения прочитанных байтов и записанных символов, но метки и пределы не будут изменены.

Помимо чтения байтов из входного буфера и записи символов в выходной буфер, этот метод возвращает объект CoderResult, описывающий причину завершения:

• CoderResult.UNDERFLOW указывает, что как можно больше входного буфера было декодировано. Если больше входных данных нет, то вызывающий метод может перейти к следующему шагу операции декодирования. В противном случае этот метод должен быть вызван снова с дополнительными входными данными.

• CoderResult.OVERFLOW указывает, что в выходном буфере недостаточно места для декодирования дополнительных байтов. Этот метод должен быть вызван снова с выходным буфером, имеющим больше оставшихся символов. Это обычно делается путём извлечения декодированных символов из выходного буфера.

• Результат ошибки неверного формата указывает на обнаружение ошибки неверного формата входных данных. Неверные байты начинаются с позиции входного буфера (возможно, инкрементированной); количество неверных байтов можно определить, вызвав метод length объекта результата. Этот случай применим только если действие при ошибке неверного формата этого декодера равно CodingErrorAction.REPORT; в противном случае неверный вход будет проигнорирован или заменён в соответствии с запросом.

• Результат ошибки неприсвоенного символа указывает на обнаружение ошибки неприсвоенного символа. Байты, которые декодируют неприсвоенный символ, начинаются с позиции входного буфера (возможно, инкрементированной); количество таких байтов можно определить, вызвав метод length объекта результата. Этот случай применим только если действие при ошибке неприсвоенного символа этого декодера равно CodingErrorAction.REPORT; в противном случае неприсвоенный символ будет проигнорирован или заменён в соответствии с запросом.

Параметр endOfInput информирует этот метод о возможности предоставления дополнительного ввода сверх содержащегося в данном входном буфере. Если есть возможность предоставить дополнительные входные данные, то вызывающий метод должен передать false; если нет возможности предоставить дополнительные входные данные, то вызывающий метод должен передать true. Не является ошибкой, и на самом деле довольно обычно, передавать false в одном вызове, а затем обнаруживать, что фактически дополнительных входных данных не было. Однако крайне важно, чтобы последний вызов этого метода в последовательности вызовов всегда передавал true, чтобы все оставшиеся нераскодированные входные данные обрабатывались как неверные.

Этот метод работает, вызывая метод decodeLoop, интерпретируя его результаты, обрабатывая условия ошибок и вызывая его повторно при необходимости.

Некоторые декодеры сохраняют внутреннее состояние и могут потребовать записи некоторых конечных символов в выходной буфер после чтения всей последовательности входных данных.

Любой дополнительный вывод записывается в выходной буфер, начиная с его текущей позиции. Максимально будет записано out.remaining() символов. Позиция буфера будет соответствующим образом изменена, но метка и предел не изменятся.

Если этот метод выполняется успешно, то он возвращает CoderResult.UNDERFLOW. Если в выходном буфере недостаточно места, то он возвращает CoderResult.OVERFLOW. Если это происходит, то этот метод должен быть вызван снова с выходным буфером, имеющим больше места, для завершения текущей операции декодирования.

Если этот декодер уже очищен, то вызов этого метода не оказывает никакого эффекта.

Этот метод вызывает метод implFlush для выполнения фактической операции очистки.

Стандартная реализация этого метода ничего не делает и всегда возвращает CoderResult.UNDERFLOW. Этот метод должен быть переопределён декодерами, которым может потребоваться запись конечных символов в выходной буфер после чтения всей последовательности входных данных.

Этот метод сбрасывает состояние, не зависящее от набора символов, а также вызывает метод implReset для выполнения любых действий по сбросу, специфичных для набора символов.

Стандартная реализация этого метода ничего не делает. Этот метод должен быть переопределён декодерами, которые сохраняют внутреннее состояние.

Этот метод содержит основной цикл декодирования, декодируя как можно больше байтов, пока не исчерпает входные данные, не исчерпает место в выходном буфере или не столкнётся с ошибкой декодирования. Этот метод вызывается методом decode, который обрабатывает интерпретацию результатов и восстановление от ошибок.

Буферы читаются и записываются, начиная с их текущих позиций. Максимально будет считано in.remaining() байтов, и максимально будет записано out.remaining() символов. Позиции буферов будут изменены для отражения прочитанных байтов и записанных символов, но метки и пределы не будут изменены.

Этот метод возвращает объект CoderResult, чтобы описать причину завершения, так же как и метод decode. Большинство реализаций этого метода будут обрабатывать ошибки декодирования, возвращая соответствующий объект результата для интерпретации методом decode. Оптимизированная реализация может вместо этого проверить соответствующее действие при ошибке и выполнить это действие сама.

Реализация этого метода может выполнять произвольный просмотр вперёд, возвращая CoderResult.UNDERFLOW до получения достаточного количества входных данных.

Этот метод реализует всю операцию декодирования; то есть, он сбрасывает этот декодер, затем декодирует байты в данном буфере байтов и, наконец, сбрасывает этот декодер. Следовательно, этот метод не следует вызывать, если операция декодирования уже выполняется.

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

Если этот декодер реализует автообнаружение кодировки символов, то в какой-то момент во время операции декодирования этот метод может начать возвращать true для указания того, что определенная кодировка символов была обнаружена в последовательности входных байтов. После этого можно вызвать метод detectedCharset для извлечения обнаруженной кодировки символов.

То, что этот метод возвращает false, не означает, что еще не было декодировано никаких байтов. Некоторые декодеры с автообнаружением способны декодировать некоторые или даже все входные байты без фиксации на конкретной кодировке символов.

По умолчанию этот метод всегда вызывает исключение UnsupportedOperationException; он должен переопределяться декодерами с автообнаружением для возврата true после определения входной кодировки символов.

Если этот декодер реализует автообнаружение кодировки символов, то этот метод возвращает фактическую кодировку символов после ее обнаружения. После этого момента этот метод возвращает одно и то же значение в течение текущей операции декодирования. Если еще не было прочитано достаточно входных байтов для определения фактической кодировки символов, то этот метод вызывает исключение IllegalStateException.

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