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