< prev index next >
src/java.desktop/share/classes/javax/swing/text/rtf/AbstractFilter.java
Print this page
*** 32,49 ****
* consisting of runs of characters interspersed with occasional
* ``specials'' (formatting characters).
*
* <p> Most of the functionality
* of this class would be redundant except that the
! * <code>ByteToChar</code> converters
* are suddenly private API. Presumably this class will disappear
* when the API is made public again. (sigh) That will also let us handle
* multibyte character sets...
*
! * <P> A subclass should override at least <code>write(char)</code>
! * and <code>writeSpecial(int)</code>. For efficiency's sake it's a
! * good idea to override <code>write(String)</code> as well. The subclass'
* initializer may also install appropriate translation and specials tables.
*
* @see OutputStream
*/
abstract class AbstractFilter extends OutputStream
--- 32,49 ----
* consisting of runs of characters interspersed with occasional
* ``specials'' (formatting characters).
*
* <p> Most of the functionality
* of this class would be redundant except that the
! * {@code ByteToChar} converters
* are suddenly private API. Presumably this class will disappear
* when the API is made public again. (sigh) That will also let us handle
* multibyte character sets...
*
! * <P> A subclass should override at least {@code write(char)}
! * and {@code writeSpecial(int)}. For efficiency's sake it's a
! * good idea to override {@code write(String)} as well. The subclass'
* initializer may also install appropriate translation and specials tables.
*
* @see OutputStream
*/
abstract class AbstractFilter extends OutputStream
*** 83,93 ****
* The format in which the file
* is read is determined by the concrete subclass of
* AbstractFilter to which this method is sent.
* <p>This method does not close the receiver after reaching EOF on
* the input stream.
! * The user must call <code>close()</code> to ensure that all
* data are processed.
*
* @param in An InputStream providing text.
*/
public void readFromStream(InputStream in)
--- 83,93 ----
* The format in which the file
* is read is determined by the concrete subclass of
* AbstractFilter to which this method is sent.
* <p>This method does not close the receiver after reaching EOF on
* the input stream.
! * The user must call {@code close()} to ensure that all
* data are processed.
*
* @param in An InputStream providing text.
*/
public void readFromStream(InputStream in)
*** 151,162 ****
/**
* Implements the buffer-at-a-time write method for greater
* efficiency.
*
! * <p> <strong>PENDING:</strong> Does <code>write(byte[])</code>
! * call <code>write(byte[], int, int)</code> or is it the other way
* around?
*/
public void write(byte[] buf, int off, int len)
throws IOException
{
--- 151,162 ----
/**
* Implements the buffer-at-a-time write method for greater
* efficiency.
*
! * <p> <strong>PENDING:</strong> Does {@code write(byte[])}
! * call {@code write(byte[], int, int)} or is it the other way
* around?
*/
public void write(byte[] buf, int off, int len)
throws IOException
{
*** 192,202 ****
}
/**
* Hopefully, all subclasses will override this method to accept strings
* of text, but if they don't, AbstractFilter's implementation
! * will spoon-feed them via <code>write(char)</code>.
*
* @param s The string of non-special characters written to the
* OutputStream.
*/
public void write(String s)
--- 192,202 ----
}
/**
* Hopefully, all subclasses will override this method to accept strings
* of text, but if they don't, AbstractFilter's implementation
! * will spoon-feed them via {@code write(char)}.
*
* @param s The string of non-special characters written to the
* OutputStream.
*/
public void write(String s)
< prev index next >