Class CharacterValidationReader

  • All Implemented Interfaces:
    Closeable, AutoCloseable, Readable

    public class CharacterValidationReader
    extends FilterReader
    The CharacterValidationReader class is the validator class that checks the conversion failure, and optionally checks the HTML.

    Do not use this validator class if the source is allowed to include U+FFFD since this validator cannot distinguish whether the 0xfffd was given because of the conversion failure or intentionally being added.

    Since:
    10.2
    • Constructor Detail

      • CharacterValidationReader

        public CharacterValidationReader​(Reader r)
                                  throws IOException
        Constructs this object with the Reader object.

        By default, HTML character and entity reference is not checked.

        Parameters:
        r - the input Reader object
        Throws:
        IOException - if any I/O exception occurs
    • Method Detail

      • read

        public int read​(char[] cbuf,
                        int off,
                        int len)
                 throws CharConversionException,
                        IOException
        Reads characters into a portion of an array.
        Overrides:
        read in class FilterReader
        Parameters:
        cbuf - destination buffer
        off - offset at which to start storing characters
        len - maximum number of characters to read
        Returns:
        the number of characters read, or -1 if the end of the stream has been reached
        Throws:
        CharConversionException - if any invalid character is found
        IOException - if any other I/O error occurs