< 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 >