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