Package org.apache.tools.ant.filters

Class EscapeUnicode

java.lang.Object

java.io.Reader

java.io.FilterReader

org.apache.tools.ant.filters.BaseFilterReader

org.apache.tools.ant.filters.BaseParamFilterReader

org.apache.tools.ant.filters.EscapeUnicode

All Implemented Interfaces:

Closeable, AutoCloseable, Readable, ChainableReader, Parameterizable

public class EscapeUnicode
extends BaseParamFilterReader
implements ChainableReader

This method converts non-latin characters to unicode escapes. Useful to load properties containing non latin Example:

<escapeunicode>

Or:

<filterreader
        classname="org.apache.tools.ant.filters.EscapeUnicode"/>
  

Since:

Ant 1.6

Field Summary

Fields inherited from class java.io.FilterReader

in

Fields inherited from class java.io.Reader

lock

Constructor Summary

Constructors

Constructor	Description
EscapeUnicode()	Constructor for "dummy" instances.
EscapeUnicode(Reader in)	Creates a new filtered reader.

Method Summary

Modifier and Type	Method	Description
final Reader	chain(Reader rdr)	Creates a new EscapeUnicode using the passed in Reader for instantiation.
final int	read()	Returns the next character in the filtered stream, converting non latin characters to unicode escapes.

Methods inherited from class org.apache.tools.ant.filters.BaseParamFilterReader

getParameters, setParameters

Methods inherited from class org.apache.tools.ant.filters.BaseFilterReader

getInitialized, getProject, read, readFully, readLine, setInitialized, setProject, skip

Methods inherited from class java.io.FilterReader

close, mark, markSupported, ready, reset

Methods inherited from class java.io.Reader

nullReader, read, read, transferTo

Methods inherited from class java.lang.Object

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

Constructor Details

EscapeUnicode

public EscapeUnicode()

Constructor for "dummy" instances.

See Also:

• BaseFilterReader()

EscapeUnicode

public EscapeUnicode(Reader in)

Creates a new filtered reader.

Parameters:

in - A Reader object providing the underlying stream. Must not be null.

Method Details

read

public final int read()
               throws IOException

Returns the next character in the filtered stream, converting non latin characters to unicode escapes.

Overrides:

read in class FilterReader

Returns:

the next character in the resulting stream, or -1 if the end of the resulting stream has been reached

Throws:

IOException - if the underlying stream throws an IOException during reading

chain

public final Reader chain(Reader rdr)

Creates a new EscapeUnicode using the passed in Reader for instantiation.

Specified by:

chain in interface ChainableReader

Parameters:

rdr - A Reader object providing the underlying stream. Must not be null.

Returns:

a new filter based on this configuration, but filtering the specified reader