javax.print

Class SimpleDoc

Inhoudsopgave
  • All Implemented Interfaces:
    Doc

    public final class SimpleDoc
extends Object
implements Doc
    This class is an implementation of interface Doc that can be used in many common printing requests. It can handle all of the presently defined "pre-defined" doc flavors defined as static variables in the DocFlavor class.

    In particular this class implements certain required semantics of the Doc specification as follows:

    • constructs a stream for the service if requested and appropriate.
    • ensures the same object is returned for each call on a method.
    • ensures multiple threads can access the Doc
    • performs some validation of that the data matches the doc flavor.
    Clients who want to re-use the doc object in other jobs, or need a MultiDoc will not want to use this class.

    If the print data is a stream, or a print job requests data as a stream, then SimpleDoc does not monitor if the service properly closes the stream after data transfer completion or job termination. Clients may prefer to use provide their own implementation of doc that adds a listener to monitor job completion and to validate that resources such as streams are freed (ie closed).

    • Constructor Detail

      • SimpleDoc

        public SimpleDoc(Object printData,
         DocFlavor flavor,
         DocAttributeSet attributes)
        Constructs a SimpleDoc with the specified print data, doc flavor and doc attribute set.
        Parameters:
        printData - the print data object
        flavor - the DocFlavor object
        attributes - a DocAttributeSet, which can be null
        Throws:
        IllegalArgumentException - if flavor or printData is null, or the printData does not correspond to the specified doc flavor--for example, the data is not of the type specified as the representation in the DocFlavor.

    • Method Detail

      • getDocFlavor

        public DocFlavor getDocFlavor()
        Determines the doc flavor in which this doc object will supply its piece of print data.
        Specified by:
        getDocFlavor in interface Doc
        Returns:
        Doc flavor.

      • getAttributes

        public DocAttributeSet getAttributes()
        Obtains the set of printing attributes for this doc object. If the returned attribute set includes an instance of a particular attribute X, the printer must use that attribute value for this doc, overriding any value of attribute X in the job's attribute set. If the returned attribute set does not include an instance of a particular attribute X or if null is returned, the printer must consult the job's attribute set to obtain the value for attribute X, and if not found there, the printer must use an implementation-dependent default value. The returned attribute set is unmodifiable.
        Specified by:
        getAttributes in interface Doc
        Returns:
        Unmodifiable set of printing attributes for this doc, or null to obtain all attribute values from the job's attribute set.

      • getPrintData

        public Object getPrintData()
                    throws IOException
        Description copied from interface: Doc
        Obtains the print data representation object that contains this doc object's piece of print data in the format corresponding to the supported doc flavor. The getPrintData() method returns an instance of the representation class whose name is given by getDocFlavor().getRepresentationClassName(), and the return value can be cast from class Object to that representation class.
        Specified by:
        getPrintData in interface Doc
        Returns:
        Print data representation object.
        Throws:
        IOException - Thrown if the representation class is a stream and there was an I/O error while constructing the stream.

      • getReaderForText

        public Reader getReaderForText()
                        throws IOException
        Obtains a reader for extracting character print data from this doc. The Doc implementation is required to support this method if the DocFlavor has one of the following print data representation classes, and return null otherwise:
        • char[]
        • java.lang.String
        • java.io.Reader
        The doc's print data representation object is used to construct and return a Reader for reading the print data as a stream of characters from the print data representation object. However, if the print data representation object is itself a Reader then the print data representation object is simply returned.

        Specified by:
        getReaderForText in interface Doc
        Returns:
        a Reader for reading the print data characters from this doc. If a reader cannot be provided because this doc does not meet the criteria stated above, null is returned.
        Throws:
        IOException - if there was an I/O error while creating the reader.

      • getStreamForBytes

        public InputStream getStreamForBytes()
                              throws IOException
        Obtains an input stream for extracting byte print data from this doc. The Doc implementation is required to support this method if the DocFlavor has one of the following print data representation classes; otherwise this method returns null:
        • byte[]
        • java.io.InputStream
        The doc's print data representation object is obtained. Then, an input stream for reading the print data from the print data representation object as a stream of bytes is created and returned. However, if the print data representation object is itself an input stream then the print data representation object is simply returned.

        Specified by:
        getStreamForBytes in interface Doc
        Returns:
        an InputStream for reading the print data bytes from this doc. If an input stream cannot be provided because this doc does not meet the criteria stated above, null is returned.
        Throws:
        IOException - if there was an I/O error while creating the input stream.

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/SimpleDoc.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

  1. Bekijk - html-document Taal van het document:fr Manuel PHP : https://docs.oracle.com

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.

Inhoudsopgave Haut