|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectjavax.print.PrintServiceLookup
public abstract class PrintServiceLookup
PrintServiceLookup
implementations provide a way to lookup
print services based on different constraints.
Implementations are located and loaded automatically through the SPI JAR file specification. Therefore implementation classes must provide a default constructor for instantiation. Furthermore, applications are able to register further instances directly at runtime.
If an SecurityManager is installed implementors should call
checkPrintJobAccess()
to disable access for untrusted code.
This check is to be made in every lookup service implementation for
flexibility. Print services registered by applications through
registerService(PrintService)
are suppressed in the
lookup results if a security manager is installed and disallows access.
Constructor Summary | |
---|---|
PrintServiceLookup()
Constructs a PrintServiceLookup object. |
Method Summary | |
---|---|
abstract PrintService |
getDefaultPrintService()
Not to be called directly by applications. |
abstract MultiDocPrintService[] |
getMultiDocPrintServices(DocFlavor[] flavors,
AttributeSet attributes)
Not to be called directly by applications. |
abstract PrintService[] |
getPrintServices()
Not to be called directly by applications. |
abstract PrintService[] |
getPrintServices(DocFlavor flavor,
AttributeSet attributes)
Not to be called directly by applications. |
static PrintService |
lookupDefaultPrintService()
Searches the default print service in the current environment. |
static MultiDocPrintService[] |
lookupMultiDocPrintServices(DocFlavor[] flavors,
AttributeSet attributes)
Searches print services capable of multi document printing in all of the given document flavors and supporting the specified printing attributes. |
static PrintService[] |
lookupPrintServices(DocFlavor flavor,
AttributeSet attributes)
Searches print services capable of printing in the given document flavor which supports the specified printing attributes. |
static boolean |
registerService(PrintService service)
Explicitly registers the provided print service instance. |
static boolean |
registerServiceProvider(PrintServiceLookup sp)
Explicitly registers the provided print service lookup implementation. |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
---|
public PrintServiceLookup()
PrintServiceLookup
object.
Method Detail |
---|
public static boolean registerServiceProvider(PrintServiceLookup sp)
The registration will silently fail (returning false
) if
the lookup service is already registered or the registration somehow
else fails.
sp
- the print service lookup implementation to register.
true
if registered, false
otherwise.public static boolean registerService(PrintService service)
The registration will silently fail (returning false
) if
the print service instance is already registered or the registration
somehow else fails.
service
- the single print service to register.
true
if registered, false
otherwise.public static final PrintService[] lookupPrintServices(DocFlavor flavor, AttributeSet attributes)
flavor
- the document flavor to support. If null
this
constraint is ignored during lookup.attributes
- the printing attributes to support. If
null
this constraint is ignored during lookup.
public static final MultiDocPrintService[] lookupMultiDocPrintServices(DocFlavor[] flavors, AttributeSet attributes)
flavors
- the document flavors to support. If null
this
constraint is ignored during lookup.attributes
- the printing attributes to support. If
null
this constraint is ignored during lookup.
public static final PrintService lookupDefaultPrintService()
If multiple lookup services are registered and each has a default print service the result is not specified. Usually the default print service of the native platform lookup service is returned.
The GNU classpath implementation will return the CUPS default printing service as the default print service, if available.
The default print service may be overriden by users through
the property javax.print.defaultPrinter
. A service
specified must be found to be returned as the default.
null
if none found.public abstract PrintService getDefaultPrintService()
null
if there is no default one.public abstract MultiDocPrintService[] getMultiDocPrintServices(DocFlavor[] flavors, AttributeSet attributes)
flavors
- the document flavors which have to be supported.attributes
- the attributes which have to be supported.
public abstract PrintService[] getPrintServices()
public abstract PrintService[] getPrintServices(DocFlavor flavor, AttributeSet attributes)
flavor
- the document flavor which has to be supported.attributes
- the attributes which have to be supported.
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |