1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211
/* * @(#)StreamPrintServiceFactory.java 1.10 06/08/04 * * Copyright 2006 Sun Microsystems, Inc. All rights reserved. * SUN PROPRIETARY/CONFIDENTIAL. Use is subject to license terms. */ package javax.print; import java.io.OutputStream; import java.util.ArrayList; import java.util.Iterator; import javax.print.DocFlavor; import sun.awt.AppContext; import sun.misc.Service; /** * A <code>StreamPrintServiceFactory</code> is the factory for * {@link StreamPrintService} instances, * which can print to an output stream in a particular * document format described as a mime type. * A typical output document format may be Postscript(TM). * <p> * This class is implemented by a service and located by the * implementation using the * <a href="../../../technotes/guides/jar/jar.html#Service Provider"> * SPI JAR File specification</a>. * <p> * Applications locate instances of this class by calling the * {@link #lookupStreamPrintServiceFactories(DocFlavor, String)} method. * <p> * Applications can use a <code>StreamPrintService</code> obtained from a * factory in place of a <code>PrintService</code> which represents a * physical printer device. */ public abstract class StreamPrintServiceFactory { static class Services { private ArrayList listOfFactories = null; } private static Services getServices() { Services services = (Services)AppContext.getAppContext().get(Services.class); if (services == null) { services = new Services(); AppContext.getAppContext().put(Services.class, services); } return services; } private static ArrayList getListOfFactories() { return getServices().listOfFactories; } private static ArrayList initListOfFactories() { ArrayList listOfFactories = new ArrayList(); getServices().listOfFactories = listOfFactories; return listOfFactories; } /** * Locates factories for print services that can be used with * a print job to output a stream of data in the * format specified by <code>flavor</code>. * For example, the doc flavor is the document type that you want to * create, not the flavor of the * document before printing. * <p> * Although null is an acceptable value to use in the lookup of stream * printing services, it's typical to search for a particular * desired format, such as Postscript(TM). * <p> * @param flavor of the input document type - null means match all * types. * @param outputMimeType representing the required output format, used to * identify suitable stream printer factories. A value of null means * match all formats. * @return - matching factories for stream print service instance, * empty if no suitable factories could be located. */ public static StreamPrintServiceFactory[] lookupStreamPrintServiceFactories(DocFlavor flavor, String outputMimeType) { ArrayList list = getFactories(flavor, outputMimeType); return (StreamPrintServiceFactory[]) (list.toArray(new StreamPrintServiceFactory[list.size()])); } /** Queries the factory for the document format that is emitted * by printers obtained from this factory. * * @return the output format described as a mime type. */ public abstract String getOutputFormat(); /** * Queries the factory for the document flavors that can be accepted * by printers obtained from this factory. * @return array of supported doc flavors. */ public abstract DocFlavor[] getSupportedDocFlavors(); /** * Returns a <code>StreamPrintService</code> that can print to * the specified output stream. * The output stream is created and managed by the application. * It is the application's responsibility to close the stream and * to ensure that this Printer is not reused. * The application should not close this stream until any print job * created from the printer is complete. Doing so earlier may generate * a <code>PrinterException</code> and an event indicating that the * job failed. * <p> * Whereas a <code>PrintService</code> connected to a physical printer * can be reused, * a <code>StreamPrintService</code> connected to a stream cannot. * The underlying <code>StreamPrintService</code> may be disposed by * the print system with * the {@link StreamPrintService#dispose() dispose} method * before returning from the * {@link DocPrintJob#print(Doc, javax.print.attribute.PrintRequestAttributeSet) print} * method of <code>DocPrintJob</code> so that the print system knows * this printer is no longer usable. * This is equivalent to a physical printer going offline - permanently. * Applications may supply a null print stream to create a queryable * service. It is not valid to create a PrintJob for such a stream. * Implementations which allocate resources on construction should examine * the stream and may wish to only allocate resources if the stream is * non-null. * <p> * @param out destination stream for generated output. * @return a PrintService which will generate the format specified by the * DocFlavor supported by this Factory. */ public abstract StreamPrintService getPrintService(OutputStream out); private static ArrayList getAllFactories() { synchronized (StreamPrintServiceFactory.class) { ArrayList listOfFactories = getListOfFactories(); if (listOfFactories != null) { return listOfFactories; } else { listOfFactories = initListOfFactories(); } try { java.security.AccessController.doPrivileged( new java.security.PrivilegedExceptionAction() { public Object run() { Iterator iterator = Service.providers( StreamPrintServiceFactory.class); ArrayList lof = getListOfFactories(); while (iterator.hasNext()) { try { StreamPrintServiceFactory factory = (StreamPrintServiceFactory) iterator.next(); lof.add(factory); } catch (Exception e) { } } return null; } }); } catch (java.security.PrivilegedActionException e) { } return listOfFactories; } } private static boolean isMember(DocFlavor flavor, DocFlavor[] flavors) { for (int f=0; f<flavors.length; f++ ) { if (flavor.equals(flavors[f])) { return true; } } return false; } private static ArrayList getFactories(DocFlavor flavor, String outType) { if (flavor == null && outType == null) { return getAllFactories(); } ArrayList list = new ArrayList(); Iterator iterator = getAllFactories().iterator(); while (iterator.hasNext()) { StreamPrintServiceFactory factory = (StreamPrintServiceFactory)iterator.next(); if ((outType == null || outType.equalsIgnoreCase(factory.getOutputFormat())) && (flavor == null || isMember(flavor, factory.getSupportedDocFlavors()))) { list.add(factory); } } return list; } }