- java.lang.Object
-
- javax.print.SimpleDoc
-
- All Implemented Interfaces:
- Doc
public final class SimpleDoc extends Object implements Doc
This class is an implementation of interfaceDoc
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.
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 Summary
Constructors Constructor and Description SimpleDoc(Object printData, DocFlavor flavor, DocAttributeSet attributes)
Constructs aSimpleDoc
with the specified print data, doc flavor and doc attribute set.
-
Method Summary
Methods Modifier and Type Method and Description DocAttributeSet
getAttributes()
Obtains the set of printing attributes for this doc object.DocFlavor
getDocFlavor()
Determines the doc flavor in which this doc object will supply its piece of print data.Object
getPrintData()
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.Reader
getReaderForText()
Obtains a reader for extracting character print data from this doc.InputStream
getStreamForBytes()
Obtains an input stream for extracting byte print data from this doc.
-
-
-
Constructor Detail
-
SimpleDoc
public SimpleDoc(Object printData, DocFlavor flavor, DocAttributeSet attributes)
Constructs aSimpleDoc
with the specified print data, doc flavor and doc attribute set.- Parameters:
printData
- the print data objectflavor
- theDocFlavor
objectattributes
- aDocAttributeSet
, which can benull
- Throws:
IllegalArgumentException
- ifflavor
orprintData
isnull
, or theprintData
does not correspond to the specified doc flavor--for example, the data is not of the type specified as the representation in theDocFlavor
.
-
-
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 interfaceDoc
- 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 interfaceDoc
- 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. ThegetPrintData()
method returns an instance of the representation class whose name is given by
, and the return value can be cast from class Object to that representation class.getDocFlavor()
.getRepresentationClassName()
- Specified by:
getPrintData
in interfaceDoc
- 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. TheDoc
implementation is required to support this method if theDocFlavor
has one of the following print data representation classes, and returnnull
otherwise:-
char[]
-
java.lang.String
-
java.io.Reader
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 aReader
then the print data representation object is simply returned.- Specified by:
getReaderForText
in interfaceDoc
- 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. TheDoc
implementation is required to support this method if theDocFlavor
has one of the following print data representation classes; otherwise this method returnsnull
:-
byte[]
-
java.io.InputStream
- Specified by:
getStreamForBytes
in interfaceDoc
- 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.
-
-
-
Traduction non disponible
Les API Java ne sont pas encore traduites en français sur l'infobrol. Seule la version anglaise est disponible pour l'instant.
Version en cache
21/11/2024 18:42:36 Cette version de la page est en cache (à la date du 21/11/2024 18:42:36) afin d'accélérer le traitement. Vous pouvez activer le mode utilisateur dans le menu en haut pour afficher la dernère version de la page.Document créé le 29/08/2006, dernière modification le 04/03/2020
Source du document imprimé : https://www.gaudry.be/java-api-rf-javax/print/simpledoc.html
L'infobrol est un site personnel dont le contenu n'engage que moi. Le texte est mis à disposition sous licence CreativeCommons(BY-NC-SA). Plus d'info sur les conditions d'utilisation et sur l'auteur.
Références
Ces références et liens indiquent des documents consultés lors de la rédaction de cette page, ou qui peuvent apporter un complément d'information, mais les auteurs de ces sources ne peuvent être tenus responsables du contenu de cette page.
L'auteur de ce site est seul responsable de la manière dont sont présentés ici les différents concepts, et des libertés qui sont prises avec les ouvrages de référence. N'oubliez pas que vous devez croiser les informations de sources multiples afin de diminuer les risques d'erreurs.