Класс 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 для выполнения любых действий сброса, специфичных для кодировки.

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

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

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

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

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

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

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

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

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

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

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

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