< prev index next >

src/java.desktop/share/classes/javax/print/StreamPrintService.java

Print this page

        

*** 35,55 **** * the output format is a document type suitable for viewing * or archiving. * The output format must be declared as a mime type. * This is equivalent to an output document flavor where the * representation class is always "java.io.OutputStream" ! * An instance of the <code>StreamPrintService</code> class is * obtained from a {@link StreamPrintServiceFactory} instance. * <p> ! * Note that a <code>StreamPrintService</code> is different from a ! * <code>PrintService</code>, which supports a * {@link javax.print.attribute.standard.Destination Destination} ! * attribute. A <code>StreamPrintService</code> always requires an output ! * stream, whereas a <code>PrintService</code> optionally accepts a ! * <code>Destination</code>. A <code>StreamPrintService</code> * has no default destination for its formatted output. ! * Additionally a <code>StreamPrintService</code> is expected to generate output in * a format useful in other contexts. * StreamPrintService's are not expected to support the Destination attribute. */ --- 35,55 ---- * the output format is a document type suitable for viewing * or archiving. * The output format must be declared as a mime type. * This is equivalent to an output document flavor where the * representation class is always "java.io.OutputStream" ! * An instance of the {@code StreamPrintService} class is * obtained from a {@link StreamPrintServiceFactory} instance. * <p> ! * Note that a {@code StreamPrintService} is different from a ! * {@code PrintService}, which supports a * {@link javax.print.attribute.standard.Destination Destination} ! * attribute. A {@code StreamPrintService} always requires an output ! * stream, whereas a {@code PrintService} optionally accepts a ! * {@code Destination}. A {@code StreamPrintService} * has no default destination for its formatted output. ! * Additionally a {@code StreamPrintService} is expected to generate output in * a format useful in other contexts. * StreamPrintService's are not expected to support the Destination attribute. */
*** 86,96 **** * @return mime type identifying the output format. */ public abstract String getOutputFormat(); /** ! * Disposes this <code>StreamPrintService</code>. * If a stream service cannot be re-used, it must be disposed * to indicate this. Typically the client will call this method. * Services which write data which cannot meaningfully be appended to * may also dispose the stream. This does not close the stream. It * just marks it as not for further use by this service. --- 86,96 ---- * @return mime type identifying the output format. */ public abstract String getOutputFormat(); /** ! * Disposes this {@code StreamPrintService}. * If a stream service cannot be re-used, it must be disposed * to indicate this. Typically the client will call this method. * Services which write data which cannot meaningfully be appended to * may also dispose the stream. This does not close the stream. It * just marks it as not for further use by this service.
*** 98,113 **** public void dispose() { disposed = true; } /** ! * Returns a <code>boolean</code> indicating whether or not ! * this <code>StreamPrintService</code> has been disposed. * If this object has been disposed, will return true. * Used by services and client applications to recognize streams * to which no further data should be written. ! * @return if this <code>StreamPrintService</code> has been disposed */ public boolean isDisposed() { return disposed; } --- 98,113 ---- public void dispose() { disposed = true; } /** ! * Returns a {@code boolean} indicating whether or not ! * this {@code StreamPrintService} has been disposed. * If this object has been disposed, will return true. * Used by services and client applications to recognize streams * to which no further data should be written. ! * @return if this {@code StreamPrintService} has been disposed */ public boolean isDisposed() { return disposed; }
< prev index next >