< prev index next >

src/java.desktop/share/classes/javax/print/package-info.java

Print this page

        

*** 26,39 **** /** * Provides the principal classes and interfaces for the Java&trade; Print * Service API. The Java Print Service API enables client and server * applications to: * <ul> ! * <li>Discover and select print services based on their capabilities</li> ! * <li>Specify the format of print data</li> * <li>Submit print jobs to services that support the document type to be ! * printed.</li> * </ul> * * <h3>Print Service Discovery</h3> * An application invokes the static methods of the abstract class * {@link javax.print.PrintServiceLookup PrintServiceLookup} to locate print --- 26,39 ---- /** * Provides the principal classes and interfaces for the Java&trade; Print * Service API. The Java Print Service API enables client and server * applications to: * <ul> ! * <li>Discover and select print services based on their capabilities ! * <li>Specify the format of print data * <li>Submit print jobs to services that support the document type to be ! * printed. * </ul> * * <h3>Print Service Discovery</h3> * An application invokes the static methods of the abstract class * {@link javax.print.PrintServiceLookup PrintServiceLookup} to locate print
*** 49,67 **** * the {@link java.util.ServiceLoader} facility. * * <h3>Attribute Definitions</h3> * The {@link javax.print.attribute} and {@link javax.print.attribute.standard} * packages define print attributes, which describe the capabilities of a print ! * service, specify the requirements of a print job, and track the progress of ! * a print job. * <p> * The {@code javax.print.attribute} package describes the types of attributes * and how they can be collected into sets. The * {@code javax.print.attribute.standard} package enumerates all of the standard * attributes supported by the API, most of which are implementations of * attributes specified in the IETF Specification, ! * <a href="http://www.ietf.org/rfc/rfc2911.txt"> RFC 2911 Internet Printing * Protocol, 1.1: Model and Semantics</a>, dated September 2000. The attributes * specified in {@code javax.print.attribute.standard} include common * capabilities, such as: resolution, copies, media sizes, job priority, and * page ranges. * --- 49,67 ---- * the {@link java.util.ServiceLoader} facility. * * <h3>Attribute Definitions</h3> * The {@link javax.print.attribute} and {@link javax.print.attribute.standard} * packages define print attributes, which describe the capabilities of a print ! * service, specify the requirements of a print job, and track the progress of a ! * print job. * <p> * The {@code javax.print.attribute} package describes the types of attributes * and how they can be collected into sets. The * {@code javax.print.attribute.standard} package enumerates all of the standard * attributes supported by the API, most of which are implementations of * attributes specified in the IETF Specification, ! * <a href="http://www.ietf.org/rfc/rfc2911.txt">RFC 2911 Internet Printing * Protocol, 1.1: Model and Semantics</a>, dated September 2000. The attributes * specified in {@code javax.print.attribute.standard} include common * capabilities, such as: resolution, copies, media sizes, job priority, and * page ranges. *
*** 76,95 **** * * <h3>Using the API</h3> * A typical application using the Java Print Service API performs these steps * to process a print request: * <ol> ! * <li>Chooses a {@code DocFlavor}.</li> ! * <li>Creates a set of attributes.</li> ! * <li>Locates a print service that can handle the print request as ! * specified by the {@code DocFlavor} and the attribute set.</li> * <li>Creates a {@link javax.print.Doc Doc} object encapsulating the * {@code DocFlavor} and the actual print data, which can take many forms ! * including: a Postscript file, a JPEG image, a URL, or plain text.</li> * <li>Gets a print job, represented by ! * {@link javax.print.DocPrintJob DocPrintJob}, from the print service.</li> ! * <li>Calls the print method of the print job.</li> * </ol> * The following code sample demonstrates a typical use of the Java Print * Service API: locating printers that can print five double-sided copies of a * Postscript document on size A4 paper, creating a print job from one of the * returned print services, and calling print. --- 76,95 ---- * * <h3>Using the API</h3> * A typical application using the Java Print Service API performs these steps * to process a print request: * <ol> ! * <li>Chooses a {@code DocFlavor}. ! * <li>Creates a set of attributes. ! * <li>Locates a print service that can handle the print request as specified ! * by the {@code DocFlavor} and the attribute set. * <li>Creates a {@link javax.print.Doc Doc} object encapsulating the * {@code DocFlavor} and the actual print data, which can take many forms ! * including: a Postscript file, a JPEG image, a {@code URL}, or plain text. * <li>Gets a print job, represented by ! * {@link javax.print.DocPrintJob DocPrintJob}, from the print service. ! * <li>Calls the print method of the print job. * </ol> * The following code sample demonstrates a typical use of the Java Print * Service API: locating printers that can print five double-sided copies of a * Postscript document on size A4 paper, creating a print job from one of the * returned print services, and calling print.
*** 117,132 **** * job.print(myDoc, aset); * } catch (PrintException pe) {} * } * }</pre> * </blockquote> ! * <P> ! * Please note: In the javax.print APIs, a null reference parameter to methods ! * is incorrect unless explicitly documented on the method as having a ! * meaningful interpretation. Usage to the contrary is incorrect coding and may ! * result in a run time exception either immediately or at some later time. ! * IllegalArgumentException and NullPointerException are examples of typical and ! * acceptable run time exceptions for such cases. * * @since 1.4 */ package javax.print; --- 117,132 ---- * job.print(myDoc, aset); * } catch (PrintException pe) {} * } * }</pre> * </blockquote> ! * <p> ! * Please note: In the {@code javax.print} APIs, a {@code null} reference ! * parameter to methods is incorrect unless explicitly documented on the method ! * as having a meaningful interpretation. Usage to the contrary is incorrect ! * coding and may result in a run time exception either immediately or at some ! * later time. {@code IllegalArgumentException} and {@code NullPointerException} ! * are examples of typical and acceptable run time exceptions for such cases. * * @since 1.4 */ package javax.print;
< prev index next >