Класс ServiceUIFactory

java.lang.Object
- javax.print.ServiceUIFactory

public abstract class ServiceUIFactory
extends Object

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

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

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

Предпочтение отдается пользовательским интерфейсам Swing, так как они обеспечивают более согласованный внешний вид и могут поддерживать 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 int`	`ABOUT_UIROLE` Обозначает UI, выполняющий информационную роль «О программе».
`static int`	`ADMIN_UIROLE` Обозначает UI, выполняющий роль администратора.
`static String`	`DIALOG_UI` Обозначает UI, реализованный как диалоговое окно AWT.
`static String`	`JCOMPONENT_UI` Обозначает UI, реализованный как компонент Swing.
`static String`	`JDIALOG_UI` Обозначает UI, реализованный как диалоговое окно Swing.
`static int`	`MAIN_UIROLE` Обозначает UI, выполняющий обычную роль конечного пользователя.
`static String`	`PANEL_UI` Обозначает UI, реализованный как панель AWT.
`static int`	`RESERVED_UIROLE` Не является допустимой ролью, но идентификаторы ролей, большие чем это значение, могут использоваться для частных ролей, поддерживаемых сервисом.

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

Конструктор и описание
`ServiceUIFactory()`

Методы

Модификатор и тип	Метод и описание
`abstract Object`	`getUI(int role, String 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

public ServiceUIFactory()

Методы

getUI

public abstract Object getUI(int role,
                             String ui)

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

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

getUIClassNamesForRole

public abstract String[] getUIClassNamesForRole(int role)

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

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

© 1993, 2020, 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.