Package org.apache.tools.ant.filters
Class BaseFilterReader
java.lang.Object
java.io.Reader
java.io.FilterReader
org.apache.tools.ant.filters.BaseFilterReader
- All Implemented Interfaces:
Closeable
,AutoCloseable
,Readable
- Direct Known Subclasses:
BaseParamFilterReader
,ClassConstants
,ExpandProperties
,StripJavaComments
,TokenFilter
Base class for core filter readers.
-
Field Summary
Fields inherited from class java.io.FilterReader
in
-
Constructor Summary
ConstructorDescriptionConstructor used by Ant's introspection mechanism.Creates a new filtered reader. -
Method Summary
Modifier and TypeMethodDescriptionprotected final boolean
Returns the initialized status.protected final Project
Returns the project this filter is part of.final int
read
(char[] cbuf, int off, int len) Reads characters into a portion of an array.protected final String
Reads to the end of the stream, returning the contents as a String.protected final String
readLine()
Reads a line of text ending with '\n' (or until the end of the stream).protected final void
setInitialized
(boolean initialized) Sets the initialized status.final void
setProject
(Project project) Sets the project to work with.final long
skip
(long n) Skips characters.Methods inherited from class java.io.FilterReader
close, mark, markSupported, read, ready, reset
Methods inherited from class java.io.Reader
nullReader, read, read, transferTo
-
Constructor Details
-
BaseFilterReader
public BaseFilterReader()Constructor used by Ant's introspection mechanism. The original filter reader is only used for chaining purposes, never for filtering purposes (and indeed it would be useless for filtering purposes, as it has no real data to filter). ChainedReaderHelper uses this placeholder instance to create a chain of real filters. -
BaseFilterReader
Creates a new filtered reader.- Parameters:
in
- A Reader object providing the underlying stream. Must not benull
.
-
-
Method Details
-
read
Reads characters into a portion of an array. This method will block until some input is available, an I/O error occurs, or the end of the stream is reached.- Overrides:
read
in classFilterReader
- Parameters:
cbuf
- Destination buffer to write characters to. Must not benull
.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:
IOException
- If an I/O error occurs
-
skip
Skips characters. This method will block until some characters are available, an I/O error occurs, or the end of the stream is reached.- Overrides:
skip
in classFilterReader
- Parameters:
n
- The number of characters to skip- Returns:
- the number of characters actually skipped
- Throws:
IllegalArgumentException
- Ifn
is negative.IOException
- If an I/O error occurs
-
setInitialized
protected final void setInitialized(boolean initialized) Sets the initialized status.- Parameters:
initialized
- Whether or not the filter is initialized.
-
getInitialized
protected final boolean getInitialized()Returns the initialized status.- Returns:
- whether or not the filter is initialized
-
setProject
Sets the project to work with.- Parameters:
project
- The project this filter is part of. Should not benull
.
-
getProject
Returns the project this filter is part of.- Returns:
- the project this filter is part of
-
readLine
Reads a line of text ending with '\n' (or until the end of the stream). The returned String retains the '\n'.- Returns:
- the line read, or
null
if the end of the stream has already been reached - Throws:
IOException
- if the underlying reader throws one during reading
-
readFully
Reads to the end of the stream, returning the contents as a String.- Returns:
- the remaining contents of the reader, as a String
- Throws:
IOException
- if the underlying reader throws one during reading
-