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:
- java.io.Closeable,- java.lang.AutoCloseable,- java.lang.Readable
 - Direct Known Subclasses:
- BaseParamFilterReader,- ClassConstants,- ExpandProperties,- StripJavaComments,- TokenFilter
 
 public abstract class BaseFilterReader extends java.io.FilterReaderBase class for core filter readers.
- 
- 
Constructor SummaryConstructors Constructor Description BaseFilterReader()Constructor used by Ant's introspection mechanism.BaseFilterReader(java.io.Reader in)Creates a new filtered reader.
 - 
Method SummaryModifier and Type Method Description protected booleangetInitialized()Returns the initialized status.protected ProjectgetProject()Returns the project this filter is part of.intread(char[] cbuf, int off, int len)Reads characters into a portion of an array.protected java.lang.StringreadFully()Reads to the end of the stream, returning the contents as a String.protected java.lang.StringreadLine()Reads a line of text ending with '\n' (or until the end of the stream).protected voidsetInitialized(boolean initialized)Sets the initialized status.voidsetProject(Project project)Sets the project to work with.longskip(long n)Skips characters.
 
- 
- 
- 
Constructor Detail- 
BaseFilterReaderpublic 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.
 - 
BaseFilterReaderpublic BaseFilterReader(java.io.Reader in) Creates a new filtered reader.- Parameters:
- in- A Reader object providing the underlying stream. Must not be- null.
 
 
- 
 - 
Method Detail- 
readpublic final int read(char[] cbuf, int off, int len) throws java.io.IOExceptionReads 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:
- readin class- java.io.FilterReader
- Parameters:
- cbuf- Destination buffer to write characters to. Must not be- null.
- 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:
- java.io.IOException- If an I/O error occurs
 
 - 
skippublic final long skip(long n) throws java.io.IOException, java.lang.IllegalArgumentExceptionSkips characters. This method will block until some characters are available, an I/O error occurs, or the end of the stream is reached.- Overrides:
- skipin class- java.io.FilterReader
- Parameters:
- n- The number of characters to skip
- Returns:
- the number of characters actually skipped
- Throws:
- java.lang.IllegalArgumentException- If- nis negative.
- java.io.IOException- If an I/O error occurs
 
 - 
setInitializedprotected final void setInitialized(boolean initialized) Sets the initialized status.- Parameters:
- initialized- Whether or not the filter is initialized.
 
 - 
getInitializedprotected final boolean getInitialized() Returns the initialized status.- Returns:
- whether or not the filter is initialized
 
 - 
setProjectpublic final void setProject(Project project) Sets the project to work with.- Parameters:
- project- The project this filter is part of. Should not be- null.
 
 - 
getProjectprotected final Project getProject() Returns the project this filter is part of.- Returns:
- the project this filter is part of
 
 - 
readLineprotected final java.lang.String readLine() throws java.io.IOExceptionReads 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 nullif the end of the stream has already been reached
- Throws:
- java.io.IOException- if the underlying reader throws one during reading
 
 - 
readFullyprotected final java.lang.String readFully() throws java.io.IOExceptionReads to the end of the stream, returning the contents as a String.- Returns:
- the remaining contents of the reader, as a String
- Throws:
- java.io.IOException- if the underlying reader throws one during reading
 
 
- 
 
-