Класс ServiceUIFactory

java.lang.Object

javax.print.ServiceUIFactory

public abstract class ServiceUIFactory extends Object

Услуги могут по желанию предоставлять пользовательские интерфейсы (UI), которые позволяют использовать различные стили взаимодействия в разных ролях. Одна роль может быть просмотром конечным пользователем и настройкой параметров печати. Другая роль может быть администрированием службы печати.

Хотя API службы печати в настоящее время не предоставляет стандартизированной поддержки администрирования службы печати, мониторинг службы печати возможен, и пользовательский интерфейс может предоставить механизмы для частных обновлений.

Основная цель дизайна — позволить приложениям лениво определять и инициализировать службы только при необходимости без каких-либо зависимостей от API, кроме как в среде, в которой они используются.

Предпочтение отдается пользовательским интерфейсам Swing, поскольку они обеспечивают более согласованный L&F и могут поддерживать API доступности.

Пример использования:

  ServiceUIFactory factory = printService.getServiceUIFactory();
  if (factory != null) {
      JComponent swingui = (JComponent)factory.getUI(
                                         ServiceUIFactory.MAIN_UIROLE,
                                         ServiceUIFactory.JCOMPONENT_UI);
      if (swingui != null) {
          tabbedpane.add("Custom UI", swingui);
      }
  }

Краткое описание полей

Модификатор и тип	Поле	Описание
`static final int`	`ABOUT_UIROLE`	Обозначает пользовательский интерфейс (UI), выполняющий информационную роль "О программе".
`static final int`	`ADMIN_UIROLE`	Обозначает пользовательский интерфейс (UI), выполняющий роль администратора.
`static final String`	`DIALOG_UI`	Обозначает пользовательский интерфейс (UI), реализованный в виде диалогового окна AWT.
`static final String`	`JCOMPONENT_UI`	Обозначает пользовательский интерфейс (UI), реализованный как компонент Swing.
`static final String`	`JDIALOG_UI`	Обозначает пользовательский интерфейс (UI), реализованный в виде диалогового окна Swing.
`static final int`	`MAIN_UIROLE`	Обозначает пользовательский интерфейс (UI), выполняющий обычную роль конечного пользователя.
`static final String`	`PANEL_UI`	Обозначает пользовательский интерфейс (UI), реализованный в виде панели AWT.
`static final int`	`RESERVED_UIROLE`	Не является допустимой ролью, но идентификаторы ролей, большие, чем этот, могут использоваться для частных ролей, поддерживаемых службой.

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

ServiceUIFactory()

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

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

Модификатор и тип	Метод	Описание
`abstract Object`	`getUI(int role, String ui)`	Получить объект пользовательского интерфейса (UI), который приложение может привести к типу запрошенного UI и использовать в своём пользовательском интерфейсе.
`abstract String[]`	`getUIClassNamesForRole(int role)`	Взяв роль UI, полученную от этого фабричного объекта, получите типы UI, доступные от этого фабричного объекта, которые реализуют эту роль.

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

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

Подробное описание полей

JCOMPONENT_UI

public static final String JCOMPONENT_UI

Обозначает пользовательский интерфейс (UI), реализованный как компонент Swing. Значение строки — полностью квалифицированное имя класса: "javax.swing.JComponent".

См. также:

PANEL_UI

public static final String PANEL_UI

Обозначает пользовательский интерфейс (UI), реализованный в виде панели AWT. Значение строки — полностью квалифицированное имя класса: "java.awt.Panel"

См. также:

DIALOG_UI

public static final String DIALOG_UI

Обозначает пользовательский интерфейс (UI), реализованный в виде диалогового окна AWT. Значение строки — полностью квалифицированное имя класса: "java.awt.Dialog"

См. также:

JDIALOG_UI

public static final String JDIALOG_UI

Обозначает пользовательский интерфейс (UI), реализованный в виде диалогового окна Swing. Значение строки — полностью квалифицированное имя класса: "javax.swing.JDialog"

См. также:

ABOUT_UIROLE

public static final int ABOUT_UIROLE

Обозначает пользовательский интерфейс (UI), выполняющий информационную роль "О программе".

См. также:

ADMIN_UIROLE

public static final int ADMIN_UIROLE

Обозначает пользовательский интерфейс (UI), выполняющий роль администратора.

См. также:

MAIN_UIROLE

public static final int MAIN_UIROLE

Обозначает пользовательский интерфейс (UI), выполняющий обычную роль конечного пользователя.

См. также:

RESERVED_UIROLE

public static final int RESERVED_UIROLE

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

См. также:

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

ServiceUIFactory

protected ServiceUIFactory()

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

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

getUI

public abstract Object getUI(int role, String ui)

Получить объект пользовательского интерфейса (UI), который приложение может привести к типу запрошенного UI и использовать в своём пользовательском интерфейсе.

Параметры:: role - запрашиваемая. Должна быть одной из стандартных ролей или частной ролью, поддерживаемой этой фабрикой.; ui - тип, в котором запрашивается роль
Возвращает:: роль UI или null, если запрашиваемая роль UI недоступна от этой фабрики
Исключение:: IllegalArgumentException - если роль или ui не являются ни одной из стандартных, ни частной, поддерживаемой фабрикой

getUIClassNamesForRole

public abstract String[] getUIClassNamesForRole(int role)

Взяв роль UI, полученную от этого фабричного объекта, получите типы UI, доступные от этого фабричного объекта, которые реализуют эту роль. Возвращаемые Strings должны ссылаться на статические переменные, определённые в этом классе, чтобы приложения могли использовать равенство ссылок ("==").

Параметры:: role - для поиска
Возвращает:: типы UI, поддерживаемые этим классом для указанной роли, или null, если для роли нет доступных UI
Исключение:: IllegalArgumentException - если роль является нестандартной ролью, не поддерживаемой этой фабрикой

© 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/ServiceUIFactory.html