org.aoju.bus.core.text.escape

Class NumericUnescaper

java.lang.Object

org.aoju.bus.core.text.translate.CharSequenceTranslator

org.aoju.bus.core.text.escape.NumericUnescaper

public class NumericUnescaper
extends CharSequenceTranslator

Translate XML numeric entities of the form &#[xX]?\d+;? to the specific codepoint.

Note that the semi-colon is optional.

Since:

JDK 1.8

Version:

3.0.0

Author:

Kimi Liu

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	NumericUnescaper.OPTION NumericUnescaper option enum.

Constructor Summary

Constructors

Constructor and Description
NumericUnescaper(NumericUnescaper.OPTION... options) Create a UnicodeUnescaper.

Method Summary

Modifier and Type	Method and Description
boolean	isSet(NumericUnescaper.OPTION option) Whether the passed in option is currently set.
int	translate(CharSequence input, int index, Writer out) Translate a set of codepoints, represented by an int index into a CharSequence, into another set of codepoints.

Methods inherited from class org.aoju.bus.core.text.translate.CharSequenceTranslator

hex, translate, translate, with

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

NumericUnescaper

public NumericUnescaper(NumericUnescaper.OPTION... options)

Create a UnicodeUnescaper.

The constructor takes a list of options, only one type of which is currently available (whether to allow, error or ignore the semi-colon on the end of a numeric entity to being missing).

For example, to support numeric entities without a ';': new NumericUnescaper(NumericUnescaper.OPTION.semiColonOptional) and to throw an IllegalArgumentException when they're missing: new NumericUnescaper(NumericUnescaper.OPTION.errorIfNoSemiColon)

Note that the default behaviour is to ignore them.

Parameters:

options - to apply to this unescaper

Method Detail

isSet

public boolean isSet(NumericUnescaper.OPTION option)

Whether the passed in option is currently set.

Parameters:

option - to check state of

Returns:

whether the option is set

translate

public int translate(CharSequence input,
                     int index,
                     Writer out)
              throws IOException

Description copied from class: CharSequenceTranslator

Translate a set of codepoints, represented by an int index into a CharSequence, into another set of codepoints. The number of codepoints consumed must be returned, and the only IOExceptions thrown must be from interacting with the Writer so that the top level API may reliably ignore StringWriter IOExceptions.

Specified by:

translate in class CharSequenceTranslator

Parameters:

input - CharSequence that is being translated

index - int representing the current point of translation

out - Writer to translate the text to

Returns:

int count of codepoints consumed

Throws:

IOException - if and only if the Writer produces an IOException