Package javax.print
See: Description
-
Interface Summary Interface Description AttributeException Interface AttributeException is a mixin interface which a subclass ofPrintException
can implement to report an error condition involving one or more printing attributes that a particular Print Service instance does not support.CancelablePrintJob This interface is used by a printing application to cancel a print job.Doc Interface Doc specifies the interface for an object that supplies one piece of print data for a Print Job.DocPrintJob This interface represents a print job that can print a specified document with a set of job attributes.FlavorException Interface FlavorException is a mixin interface which a subclass ofPrintException
can implement to report an error condition involving a doc flavor or flavors (classDocFlavor
).MultiDoc Interface MultiDoc specifies the interface for an object that supplies more than one piece of print data for a Print Job.MultiDocPrintJob Obtained from a MultiDocPrintService, a MultiDocPrintJob can print a specified collection of documents as a single print job with a set of job attributes.MultiDocPrintService Interface MultiPrintService is the factory for a MultiDocPrintJob.PrintService Interface PrintService is the factory for a DocPrintJob.URIException Interface URIException is a mixin interface which a subclass ofPrintException
can implement to report an error condition involving a URI address. -
Class Summary Class Description DocFlavor ClassDocFlavor
encapsulates an object that specifies the format in which print data is supplied to aDocPrintJob
.DocFlavor.BYTE_ARRAY Class DocFlavor.BYTE_ARRAY provides predefined static constant DocFlavor objects for example doc flavors using a byte array (byte[]
) as the print data representation class.DocFlavor.CHAR_ARRAY Class DocFlavor.CHAR_ARRAY provides predefined static constant DocFlavor objects for example doc flavors using a character array (char[]
) as the print data representation class.DocFlavor.INPUT_STREAM Class DocFlavor.INPUT_STREAM provides predefined static constant DocFlavor objects for example doc flavors using a byte stream (
) as the print data representation class.java.io.InputStream
DocFlavor.READER Class DocFlavor.READER provides predefined static constant DocFlavor objects for example doc flavors using a character stream (
) as the print data representation class.java.io.Reader
DocFlavor.SERVICE_FORMATTED Class DocFlavor.SERVICE_FORMATTED provides predefined static constant DocFlavor objects for example doc flavors for service formatted print data.DocFlavor.STRING Class DocFlavor.STRING provides predefined static constant DocFlavor objects for example doc flavors using a string (
) as the print data representation class.java.lang.String
DocFlavor.URL Class DocFlavor.URL provides predefined static constant DocFlavor objects.PrintServiceLookup Implementations of this class provide lookup services for print services (typically equivalent to printers) of a particular type.ServiceUI This class is a collection of UI convenience methods which provide a graphical user dialog for browsing print services looked up through the Java Print Service API.ServiceUIFactory Services may optionally provide UIs which allow different styles of interaction in different roles.SimpleDoc This class is an implementation of interfaceDoc
that can be used in many common printing requests.StreamPrintService This class extendsPrintService
and represents a print service that prints data in different formats to a client-provided output stream.StreamPrintServiceFactory AStreamPrintServiceFactory
is the factory forStreamPrintService
instances, which can print to an output stream in a particular document format described as a mime type. -
Exception Summary Exception Description PrintException Class PrintException encapsulates a printing-related error condition that occurred while using a Print Service instance.
Package javax.print Description
- Discover and select print services based on their capabilities
- Specify the format of print data
- Submit print jobs to services that support the document type to be printed.
Print Service Discovery
An application invokes the static methods of the abstract class
PrintServiceLookup
to locate print
services that have the capabilities to satisfy the application's print
request. For example, to print a double-sided document, the application
first needs to find printers that have the double-sided printing capability.
The JDK includes PrintServiceLookup
implementations that
can locate the standard platform printers. To locate other types of printers,
such as IPP printers or JINI printers, a print-service provider can write
implementations of PrintServiceLookup
. The print-service provider
can dynamically install these PrintServiceLookup
implementations
using the
SPI JAR file specification.
Attribute Definitions
Thejavax.print.attribute
and 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.
The javax.print.attribute
package describes the types of attributes and
how they can be collected into sets. The 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,
RFC 2911 Internet Printing Protocol, 1.1: Model and Semantics, dated
September 2000. The attributes specified in javax.print.attribute.standard
include common capabilites, such as: resolution, copies, media sizes,
job priority, and page ranges.
Document Type Specification
TheDocFlavor
class represents the print data
format, such as JPEG or PostScript. A DocFlavor
object
consists of a MIME type, which describes the format, and a document
representation class name that indicates how the document is delivered
to the printer or output stream. An application uses the
DocFlavor
and an attribute set to find printers that can
print the document type specified by the DocFlavor
and have
the capabilities specified by the attribute set.
Using the API
A typical application using the Java Print Service API performs these steps to process a print request:- Chooses a
DocFlavor
. - Creates a set of attributes.
- Locates a print service that can handle the print request as specified
by the
DocFlavor
and the attribute set. - Creates a
Doc
object encapsulating theDocFlavor
and the actual print data, which can take many forms including: a Postscript file, a JPEG image, a URL, or plain text. - Gets a print job, represented by
DocPrintJob
, from the print service. - Calls the print method of the print job.
FileInputStream psStream; try { psStream = new FileInputStream("file.ps"); } catch (FileNotFoundException ffne) { } if (psStream == null) { return; } DocFlavor psInFormat = DocFlavor.INPUT_STREAM.POSTSCRIPT; Doc myDoc = new SimpleDoc(psStream, psInFormat, null); PrintRequestAttributeSet aset = new HashPrintRequestAttributeSet(); aset.add(new Copies(5)); aset.add(MediaSize.A4); aset.add(Sides.DUPLEX); PrintService[] services = PrintServiceLookup.lookupPrintServices(psInFormat, aset); if (services.length > 0) { DocPrintJob job = services[0].createPrintJob(); try { job.print(myDoc, aset); } catch (PrintException pe) {} }
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
Nederlandse vertaling
U hebt gevraagd om deze site in het Nederlands te bezoeken. Voor nu wordt alleen de interface vertaald, maar nog niet alle inhoud.Als je me wilt helpen met vertalingen, is je bijdrage welkom. Het enige dat u hoeft te doen, is u op de site registreren en mij een bericht sturen waarin u wordt gevraagd om u toe te voegen aan de groep vertalers, zodat u de gewenste pagina's kunt vertalen. Een link onderaan elke vertaalde pagina geeft aan dat u de vertaler bent en heeft een link naar uw profiel.
Bij voorbaat dank.
Document heeft de 11/06/2005 gemaakt, de laatste keer de 04/03/2020 gewijzigd
Bron van het afgedrukte document:https://www.gaudry.be/nl/java-api-rf-javax/print/package-summary.html
De infobrol is een persoonlijke site waarvan de inhoud uitsluitend mijn verantwoordelijkheid is. De tekst is beschikbaar onder CreativeCommons-licentie (BY-NC-SA). Meer info op de gebruiksvoorwaarden en de auteur.
Referenties
Deze verwijzingen en links verwijzen naar documenten die geraadpleegd zijn tijdens het schrijven van deze pagina, of die aanvullende informatie kunnen geven, maar de auteurs van deze bronnen kunnen niet verantwoordelijk worden gehouden voor de inhoud van deze pagina.
De auteur Deze site is als enige verantwoordelijk voor de manier waarop de verschillende concepten, en de vrijheden die met de referentiewerken worden genomen, hier worden gepresenteerd. Vergeet niet dat u meerdere broninformatie moet doorgeven om het risico op fouten te verkleinen.