Класс PrintServiceLookup

java.lang.Object

javax.print.PrintServiceLookup

public abstract class PrintServiceLookup extends Object

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

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

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

Краткое описание конструкторов

PrintServiceLookup()

Модификатор	Конструктор	Описание
`protected`	Конструктор для вызова подклассами.

Краткое описание методов

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

Методы, унаследованные от класса java.lang.Object

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

Подробное описание конструкторов

PrintServiceLookup

protected PrintServiceLookup()

Конструктор для вызова подклассами.

Подробное описание методов

lookupPrintServices

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

Находит службы печати, способные печатать указанный DocFlavor.

Параметры:: flavor - формат печати. Если null, это ограничение не используется.; attributes - атрибуты, которые должна поддерживать служба печати. Если null, это ограничение не используется.
Возвращает:: массив соответствующих PrintService объектов, представляющих службы печати, которые поддерживают указанные атрибуты формата. Если соответствий нет, массив имеет нулевую длину.

lookupMultiDocPrintServices

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

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

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

Параметры:: flavors - типы документов для печати. Если null или пустой, это ограничение не используется. В противном случае возвращаются только службы многодокументной печати, которые могут печатать все указанные типы документов.; attributes - атрибуты, которые должна поддерживать служба печати. Если null, это ограничение не используется.
Возвращает:: массив соответствующих MultiDocPrintService объектов. Если соответствий нет, массив имеет нулевую длину.

lookupDefaultPrintService

public static final PrintService lookupDefaultPrintService()

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

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

Возвращает:: стандартную PrintService

registerServiceProvider

public static boolean registerServiceProvider(PrintServiceLookup sp)

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

Параметры:: sp - реализация службы поиска
Возвращает:: true, если новая служба поиска успешно зарегистрирована; false в противном случае

registerService

public static boolean registerService(PrintService service)

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

Параметры:: service - реализация службы печати
Возвращает:: true, если служба зарегистрирована; false в противном случае

getPrintServices

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

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

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

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

Параметры:: flavor - требуемого типа документа. Если null, оно игнорируется.; attributes - требуемых атрибутов. Если null, это ограничение не используется.
Возвращает:: массив соответствующих PrintServices. Если соответствий нет, массив имеет нулевую длину.

getPrintServices

public abstract PrintService[] getPrintServices()

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

Возвращает:: массив всех PrintServices, известных этой службе поиска.

getMultiDocPrintServices

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

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

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

Находит службы MultiDoc печати, которые могут быть подтверждены как поддерживающие сочетание атрибутов и DocFlavors, указанных.

Параметры:: flavors - требуемых типов документов. Если null или пустой, оно игнорируется.; attributes - требуемых атрибутов. Если null, это ограничение не используется.
Возвращает:: массив соответствующих PrintServices. Если соответствий нет, массив имеет нулевую длину.

getDefaultPrintService

public abstract PrintService getDefaultPrintService()

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

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

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://download.java.net/java/early_access/jdk24/docs/api/java.desktop/javax/print/PrintServiceLookup.html