Class CharsetDecoderICU


  • public abstract class CharsetDecoderICU
    extends java.nio.charset.CharsetDecoder
    An abstract class that provides framework methods of decoding operations for concrete subclasses. In the future this class will contain API that will implement converter sematics of ICU4C.
    • Field Summary

      Fields 
      Modifier and Type Field Description
      protected static int EXT_MAX_BYTES
      Deprecated.
      This API is ICU internal only.
    • Method Summary

      All Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      protected java.nio.charset.CoderResult decodeLoop​(java.nio.ByteBuffer in, java.nio.CharBuffer out)
      Decodes one or more bytes.
      protected java.nio.charset.CoderResult implFlush​(java.nio.CharBuffer out)
      Flushes any characters saved in the converter's internal buffer and resets the converter.
      protected void implOnMalformedInput​(java.nio.charset.CodingErrorAction newAction)
      Sets the action to be taken if an illegal sequence is encountered
      protected void implOnUnmappableCharacter​(java.nio.charset.CodingErrorAction newAction)
      Sets the action to be taken if an illegal sequence is encountered
      protected void implReset()
      Resets the to Unicode mode of converter
      float maxBytesPerChar()
      Returns the maxBytesPerChar value for the Charset that created this decoder.
      void setToUCallback​(java.nio.charset.CoderResult err, CharsetCallback.Decoder newCallback, java.lang.Object newContext)
      Sets the callback encoder method and context to be used if an illegal sequence is encounterd.
      • Methods inherited from class java.nio.charset.CharsetDecoder

        averageCharsPerByte, charset, decode, decode, detectedCharset, flush, implReplaceWith, isAutoDetecting, isCharsetDetected, malformedInputAction, maxCharsPerByte, onMalformedInput, onUnmappableCharacter, replacement, replaceWith, reset, unmappableCharacterAction
      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    • Field Detail

      • EXT_MAX_BYTES

        @Deprecated
        protected static final int EXT_MAX_BYTES
        Deprecated.
        This API is ICU internal only.
        Maximum number of indexed bytes
        See Also:
        Constant Field Values
    • Method Detail

      • implOnMalformedInput

        protected final void implOnMalformedInput​(java.nio.charset.CodingErrorAction newAction)
        Sets the action to be taken if an illegal sequence is encountered
        Overrides:
        implOnMalformedInput in class java.nio.charset.CharsetDecoder
        Parameters:
        newAction - action to be taken
        Throws:
        java.lang.IllegalArgumentException
      • implOnUnmappableCharacter

        protected final void implOnUnmappableCharacter​(java.nio.charset.CodingErrorAction newAction)
        Sets the action to be taken if an illegal sequence is encountered
        Overrides:
        implOnUnmappableCharacter in class java.nio.charset.CharsetDecoder
        Parameters:
        newAction - action to be taken
        Throws:
        java.lang.IllegalArgumentException
      • setToUCallback

        public final void setToUCallback​(java.nio.charset.CoderResult err,
                                         CharsetCallback.Decoder newCallback,
                                         java.lang.Object newContext)
        Sets the callback encoder method and context to be used if an illegal sequence is encounterd. You would normally call this twice to set both the malform and unmappable error. In this case, newContext should remain the same since using a different newContext each time will negate the last one used.
        Parameters:
        err - CoderResult
        newCallback - CharsetCallback.Encoder
        newContext - Object
      • implFlush

        protected final java.nio.charset.CoderResult implFlush​(java.nio.CharBuffer out)
        Flushes any characters saved in the converter's internal buffer and resets the converter.
        Overrides:
        implFlush in class java.nio.charset.CharsetDecoder
        Parameters:
        out - action to be taken
        Returns:
        result of flushing action and completes the decoding all input. Returns CoderResult.UNDERFLOW if the action succeeds.
      • implReset

        protected void implReset()
        Resets the to Unicode mode of converter
        Overrides:
        implReset in class java.nio.charset.CharsetDecoder
      • decodeLoop

        protected java.nio.charset.CoderResult decodeLoop​(java.nio.ByteBuffer in,
                                                          java.nio.CharBuffer out)
        Decodes one or more bytes. The default behaviour of the converter is stop and report if an error in input stream is encountered. To set different behaviour use @see CharsetDecoder.onMalformedInput() This method allows a buffer by buffer conversion of a data stream. The state of the conversion is saved between calls to convert. Among other things, this means multibyte input sequences can be split between calls. If a call to convert results in an Error, the conversion may be continued by calling convert again with suitably modified parameters.All conversions should be finished with a call to the flush method.
        Specified by:
        decodeLoop in class java.nio.charset.CharsetDecoder
        Parameters:
        in - buffer to decode
        out - buffer to populate with decoded result
        Returns:
        Result of decoding action. Returns CoderResult.UNDERFLOW if the decoding action succeeds or more input is needed for completing the decoding action.
      • maxBytesPerChar

        public final float maxBytesPerChar()
        Returns the maxBytesPerChar value for the Charset that created this decoder.
        Returns:
        maxBytesPerChar