javax.print

Класс PrintServiceLookup

java.lang. Объект

javax.print. PrintServiceLookup

public abstract class PrintServiceLookup
extends Object

Реализации этого class предоставляют услуги поиска для служб печати (обычно эквивалентный принтерам) определенного типа.

Многократные реализации могут быть установлены одновременно. Все реализации должны быть в состоянии описать расположенные принтеры как экземпляры PrintService. Обычно реализации этой службы, class располагается автоматически в файлах JAR (см. спецификацию файла JAR SPI). Эти классы должны быть instantiable использование конструктора по умолчанию. Альтернативно приложения могут явно зарегистрировать экземпляры во времени выполнения.

Приложения используют только статические методы этого абстрактного class. Методы экземпляра реализуются поставщиком услуг в подклассе, и объединение следствий всех установленных классов поиска сообщаются статическими методами этого class когда вызвано приложением.

Конструктору PrintServiceLookup рекомендуют проверить на SecurityManager.checkPrintJobAccess (), чтобы лишить доступа к недоверяемому коду. После этих рекомендуемых средств политики, что недоверяемый код, возможно, не в состоянии определить местоположение любых служб печати. Загруженные апплеты являются наиболее распространенным примером недоверяемого кода.

Эта проверка осуществляется на основание службы поиска, чтобы позволить гибкость в политике отразить потребности различных служб поиска.

Службы, которые регистрируются registerService (PrintService), не будут включены в результаты поиска, если менеджер безопасности будет установлен и его checkPrintJobAccess (), метод лишает доступа.

Сводка конструктора

Конструкторы

Конструктор и Описание
PrintServiceLookup()

Сводка метода

Модификатор и Тип	Метод и Описание
abstract PrintService	getDefaultPrintService() Не вызванный непосредственно приложениями.
abstract MultiDocPrintService[]	getMultiDocPrintServices(DocFlavor[] flavors, AttributeSet attributes) Не вызванный непосредственно приложениями.
abstract PrintService[]	getPrintServices() Не вызванный непосредственно приложениями.
abstract PrintService[]	getPrintServices(DocFlavor flavor, AttributeSet attributes) Определяет местоположение служб, которые могут быть положительно подтверждены, чтобы поддерживать комбинацию атрибутов и определенного DocFlavors.
static PrintService	lookupDefaultPrintService() Определяет местоположение службы печати значения по умолчанию для этой среды.
static MultiDocPrintService[]	lookupMultiDocPrintServices(DocFlavor[] flavors, AttributeSet attributes) Определяет местоположение служб печати MultiDoc, способных к печати MultiDocs, содержащего все указанные разновидности документа.
static PrintService[]	lookupPrintServices(DocFlavor flavor, AttributeSet attributes) Определяет местоположение служб печати, способных к печати указанного DocFlavor.
static boolean	registerService(PrintService service) Позволяет приложению непосредственно регистрировать экземпляр class, который реализует службу печати.
static boolean	registerServiceProvider(PrintServiceLookup sp) Позволяет приложению явно регистрировать class, который реализует службы поиска.

Методы, наследованные от class java.lang. Объект

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Деталь конструктора

PrintServiceLookup

public PrintServiceLookup()

Деталь метода

lookupPrintServices

public static final PrintService[] lookupPrintServices(DocFlavor flavor,
                                                       AttributeSet attributes)

Определяет местоположение служб печати, способных к печати указанного DocFlavor.

Параметры:

flavor - разновидность, чтобы напечатать. Если ноль, это ограничение не используется.

attributes - атрибуты, которые должна поддерживать служба печати. Если нуль это ограничение не используется.

Возвраты:

массив соответствия PrintService объекты, представляющие службы печати, которые поддерживают указанные атрибуты разновидности. Если никакие службы не соответствуют, массив является нулевым длиной.

lookupMultiDocPrintServices

public static final MultiDocPrintService[] lookupMultiDocPrintServices(DocFlavor[] flavors,
                                                                       AttributeSet attributes)

Определяет местоположение служб печати MultiDoc, способных к печати MultiDocs, содержащего все указанные разновидности документа.

Этот метод полезен, чтобы помочь определить местоположение службы, которая может напечатать a MultiDoc в котором элементы могут быть различными разновидностями. Приложение могло выполнить это непосредственно многократными поисками на каждом DocFlavor поочередно и сопоставление результатов, но службы поиска может быть в состоянии сделать это более эффективно.

Параметры:

flavors - разновидности, чтобы напечатать. Если нуль или пустеет, это ограничение не используется. Иначе возвратите только службы печати мультидокумента, которые могут напечатать все указанные разновидности документа.

attributes - атрибуты, которые должна поддерживать служба печати. Если нуль это ограничение не используется.

Возвраты:

массив соответствия MultiDocPrintService объекты. Если никакие службы не соответствуют, массив является нулевым длиной.

lookupDefaultPrintService

public static final PrintService lookupDefaultPrintService()

Определяет местоположение службы печати значения по умолчанию для этой среды. Это может возвратить нуль. Если многократные службы поиска, каждый определяет значение по умолчанию, выбранная служба, точно не определяются, но платформа, собственная служба, а не установленная служба, обычно возвращается как значение по умолчанию. Если нет никакой ясно идентифицируемой платформы собственной службы печати значения по умолчанию, значение по умолчанию является первым, чтобы быть расположенным зависящим от реализации способом.

Это может включать использование любого привилегированного API, который доступен как часть Java или собственной платформы. Этот алгоритм может быть переопределен пользователем, устанавливающим свойство javax.print.defaultPrinter. Определенная служба, как должны обнаруживать, допустима и в настоящий момент доступна, чтобы быть возвращенной как значение по умолчанию.

Возвраты:

значение по умолчанию PrintService.

registerServiceProvider

public static boolean registerServiceProvider(PrintServiceLookup sp)

Позволяет приложению явно регистрировать class, который реализует службы поиска. Регистрация не будет сохраняться через вызовы VM. Это полезно, если приложение должно сделать новую службу доступной, который не является частью установки. Если служба поиска уже регистрируется, или не может быть зарегистрирована, метод возвращает false.

Параметры:

sp - реализация службы поиска.

Возвраты:

true если новая служба поиска недавно регистрируется; false иначе.

registerService

public static boolean registerService(PrintService service)

Позволяет приложению непосредственно регистрировать экземпляр class, который реализует службу печати. Операции поиска для этой службы будут выполняться PrintServiceLookup class, используя значения атрибута и классы, о которых сообщает служба. Это может быть менее эффективным чем служба поиска, настроенная для той службы. Поэтому регистрация a PrintServiceLookup экземпляр вместо этого рекомендуется. Метод возвращает true, если эта служба ранее не регистрируется и теперь успешно регистрируется. Этот метод нельзя вызвать с экземплярами StreamPrintService. Они всегда будут не в состоянии зарегистрироваться, и метод возвратит false.

Параметры:

service - реализация службы печати.

Возвраты:

true если служба недавно регистрируется; false иначе.

getPrintServices

public abstract PrintService[] getPrintServices(DocFlavor flavor,
                                                AttributeSet attributes)

Определяет местоположение служб, которые могут быть положительно подтверждены, чтобы поддерживать комбинацию атрибутов и определенного DocFlavors. Этот метод не вызывают непосредственно приложения.

Реализованный поставщиком услуг, используемым статическими методами этого class.

Результатами должно быть то же самое как получающий весь PrintServices и запрашивающий каждого индивидуально на его поддержке указанных атрибутов и разновидностей, но процесс может быть более эффективным, используя в своих интересах возможности служб поиска для служб печати.

Параметры:

flavor - из требуемого документа. Если нуль это игнорируется.

attributes - требуемый поддерживаться. Если нуль это ограничение не используется.

Возвраты:

массив соответствия PrintServices. Если никакие службы не соответствуют, массив является нулевым длиной.

getPrintServices

public abstract PrintService[] getPrintServices()

Не вызванный непосредственно приложениями. Реализованный поставщиком услуг, используемым статическими методами этого class.

Возвраты:

массив всего PrintServices, известного этой службе поиска class. Если ни один не находится, массив нулевой длиной.

getMultiDocPrintServices

public abstract MultiDocPrintService[] getMultiDocPrintServices(DocFlavor[] flavors,
                                                                AttributeSet attributes)

Не вызванный непосредственно приложениями.

Реализованный поставщиком услуг, используемым статическими методами этого class.

Определяет местоположение служб печати MultiDoc, которые могут быть положительно подтверждены, чтобы поддерживать комбинацию атрибутов и определенного DocFlavors.

Параметры:

flavors - из требуемых документов. Если нуль или пустой это игнорируется.

attributes - требуемый поддерживаться. Если нуль это ограничение не используется.

Возвраты:

массив соответствия PrintServices. Если никакие службы не соответствуют, массив является нулевым длиной.

getDefaultPrintService

public abstract PrintService getDefaultPrintService()

Не вызванный непосредственно приложениями. Реализованный поставщиком услуг, и вызванный службой поиска печати

Возвраты:

значение по умолчанию PrintService для этой службы поиска. Если нет никакого значения по умолчанию, нуля возвратов.