< prev index next >

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

Print this page

        

*** 35,45 **** import sun.awt.AppContext; import java.util.ServiceLoader; import java.util.ServiceConfigurationError; /** ! * A <code>StreamPrintServiceFactory</code> is the factory for * {@link StreamPrintService} instances, * which can print to an output stream in a particular * document format described as a mime type. * A typical output document format may be Postscript(TM). * <p> --- 35,45 ---- import sun.awt.AppContext; import java.util.ServiceLoader; import java.util.ServiceConfigurationError; /** ! * A {@code StreamPrintServiceFactory} is the factory for * {@link StreamPrintService} instances, * which can print to an output stream in a particular * document format described as a mime type. * A typical output document format may be Postscript(TM). * <p>
*** 49,60 **** * SPI JAR File specification</a>. * <p> * Applications locate instances of this class by calling the * {@link #lookupStreamPrintServiceFactories(DocFlavor, String)} method. * <p> ! * Applications can use a <code>StreamPrintService</code> obtained from a ! * factory in place of a <code>PrintService</code> which represents a * physical printer device. */ public abstract class StreamPrintServiceFactory { --- 49,60 ---- * SPI JAR File specification</a>. * <p> * Applications locate instances of this class by calling the * {@link #lookupStreamPrintServiceFactories(DocFlavor, String)} method. * <p> ! * Applications can use a {@code StreamPrintService} obtained from a ! * factory in place of a {@code PrintService} which represents a * physical printer device. */ public abstract class StreamPrintServiceFactory {
*** 125,153 **** * @return array of supported doc flavors. */ public abstract DocFlavor[] getSupportedDocFlavors(); /** ! * Returns a <code>StreamPrintService</code> that can print to * the specified output stream. * The output stream is created and managed by the application. * It is the application's responsibility to close the stream and * to ensure that this Printer is not reused. * The application should not close this stream until any print job * created from the printer is complete. Doing so earlier may generate ! * a <code>PrinterException</code> and an event indicating that the * job failed. * <p> ! * Whereas a <code>PrintService</code> connected to a physical printer * can be reused, ! * a <code>StreamPrintService</code> connected to a stream cannot. ! * The underlying <code>StreamPrintService</code> may be disposed by * the print system with * the {@link StreamPrintService#dispose() dispose} method * before returning from the * {@link DocPrintJob#print(Doc, javax.print.attribute.PrintRequestAttributeSet) print} ! * method of <code>DocPrintJob</code> so that the print system knows * this printer is no longer usable. * This is equivalent to a physical printer going offline - permanently. * Applications may supply a null print stream to create a queryable * service. It is not valid to create a PrintJob for such a stream. * Implementations which allocate resources on construction should examine --- 125,153 ---- * @return array of supported doc flavors. */ public abstract DocFlavor[] getSupportedDocFlavors(); /** ! * Returns a {@code StreamPrintService} that can print to * the specified output stream. * The output stream is created and managed by the application. * It is the application's responsibility to close the stream and * to ensure that this Printer is not reused. * The application should not close this stream until any print job * created from the printer is complete. Doing so earlier may generate ! * a {@code PrinterException} and an event indicating that the * job failed. * <p> ! * Whereas a {@code PrintService} connected to a physical printer * can be reused, ! * a {@code StreamPrintService} connected to a stream cannot. ! * The underlying {@code StreamPrintService} may be disposed by * the print system with * the {@link StreamPrintService#dispose() dispose} method * before returning from the * {@link DocPrintJob#print(Doc, javax.print.attribute.PrintRequestAttributeSet) print} ! * method of {@code DocPrintJob} so that the print system knows * this printer is no longer usable. * This is equivalent to a physical printer going offline - permanently. * Applications may supply a null print stream to create a queryable * service. It is not valid to create a PrintJob for such a stream. * Implementations which allocate resources on construction should examine
< prev index next >