1 /* |
1 /* |
2 * Copyright (c) 2000, 2001, Oracle and/or its affiliates. All rights reserved. |
2 * Copyright (c) 2000, 2013, Oracle and/or its affiliates. All rights reserved. |
3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. |
3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. |
4 * |
4 * |
5 * This code is free software; you can redistribute it and/or modify it |
5 * This code is free software; you can redistribute it and/or modify it |
6 * under the terms of the GNU General Public License version 2 only, as |
6 * under the terms of the GNU General Public License version 2 only, as |
7 * published by the Free Software Foundation. Oracle designates this |
7 * published by the Free Software Foundation. Oracle designates this |
42 * <LI> |
42 * <LI> |
43 * Determine the format, or "doc flavor" (class {@link DocFlavor DocFlavor}), |
43 * Determine the format, or "doc flavor" (class {@link DocFlavor DocFlavor}), |
44 * in which the print data is available. A doc flavor designates the print |
44 * in which the print data is available. A doc flavor designates the print |
45 * data format (a MIME type) and the representation class of the object |
45 * data format (a MIME type) and the representation class of the object |
46 * from which the print data comes. |
46 * from which the print data comes. |
47 * <P> |
47 * |
48 * <LI> |
48 * <LI> |
49 * Obtain the print data representation object, which is an instance of the |
49 * Obtain the print data representation object, which is an instance of the |
50 * doc flavor's representation class. The Print Job can then obtain the actual |
50 * doc flavor's representation class. The Print Job can then obtain the actual |
51 * print data from the representation object. |
51 * print data from the representation object. |
52 * <P> |
52 * |
53 * <LI> |
53 * <LI> |
54 * Obtain the printing attributes that specify additional characteristics of |
54 * Obtain the printing attributes that specify additional characteristics of |
55 * the doc or that specify processing instructions to be applied to the doc. |
55 * the doc or that specify processing instructions to be applied to the doc. |
56 * Printing attributes are defined in package {@link javax.print.attribute |
56 * Printing attributes are defined in package {@link javax.print.attribute |
57 * javax.print.attribute}. The doc returns its printing attributes stored in |
57 * javax.print.attribute}. The doc returns its printing attributes stored in |
102 * the service will only close the stream if it has obtained the stream before |
102 * the service will only close the stream if it has obtained the stream before |
103 * terminating. That is, just because a print service might request data as |
103 * terminating. That is, just because a print service might request data as |
104 * a stream does not mean that it will, with the implications that Doc |
104 * a stream does not mean that it will, with the implications that Doc |
105 * implementors which rely on the service to close them should create such |
105 * implementors which rely on the service to close them should create such |
106 * streams only in response to a request from the service. |
106 * streams only in response to a request from the service. |
107 * <P> |
|
108 * <HR> |
107 * <HR> |
109 */ |
108 */ |
110 public interface Doc { |
109 public interface Doc { |
111 |
110 |
112 /** |
111 /** |