* Although the Print Service API does not presently provide standardised - * support for administering a print service, monitoring of the print - * service is possible and a UI may provide for private update mechanisms. + * support for administering a print service, monitoring of the print service is + * possible and a UI may provide for private update mechanisms. *
* The basic design intent is to allow applications to lazily locate and - * initialize services only when needed without any API dependencies - * except in an environment in which they are used. + * initialize services only when needed without any API dependencies except in + * an environment in which they are used. *
- * Swing UIs are preferred as they provide a more consistent {@literal L&F} - * and can support accessibility APIs. + * Swing UIs are preferred as they provide a more consistent {@literal L&F} and + * can support accessibility APIs. *
* Example usage: *
@@ -55,34 +54,29 @@ * } **/ - public abstract class ServiceUIFactory { /** - * Denotes a UI implemented as a Swing component. - * The value of the String is the fully qualified classname : - * "javax.swing.JComponent". + * Denotes a UI implemented as a Swing component. The value of the string is + * the fully qualified classname : "javax.swing.JComponent". */ public static final String JCOMPONENT_UI = "javax.swing.JComponent"; /** - * Denotes a UI implemented as an AWT panel. - * The value of the String is the fully qualified classname : - * "java.awt.Panel" + * Denotes a UI implemented as an AWT panel. The value of the string is the + * fully qualified classname : "java.awt.Panel" */ public static final String PANEL_UI = "java.awt.Panel"; /** - * Denotes a UI implemented as an AWT dialog. - * The value of the String is the fully qualified classname : - * "java.awt.Dialog" + * Denotes a UI implemented as an AWT dialog. The value of the string is the + * fully qualified classname : "java.awt.Dialog" */ public static final String DIALOG_UI = "java.awt.Dialog"; /** - * Denotes a UI implemented as a Swing dialog. - * The value of the String is the fully qualified classname : - * "javax.swing.JDialog" + * Denotes a UI implemented as a Swing dialog. The value of the string is + * the fully qualified classname : "javax.swing.JDialog" */ public static final String JDIALOG_UI = "javax.swing.JDialog"; @@ -102,41 +96,38 @@ public static final int MAIN_UIROLE = 3; /** - * Not a valid role but role id's greater than this may be used - * for private roles supported by a service. Knowledge of the - * function performed by this role is required to make proper use - * of it. + * Not a valid role but role id's greater than this may be used for private + * roles supported by a service. Knowledge of the function performed by this + * role is required to make proper use of it. */ public static final int RESERVED_UIROLE = 99; + /** - * Get a UI object which may be cast to the requested UI type - * by the application and used in its user interface. + * Get a UI object which may be cast to the requested UI type by the + * application and used in its user interface. * - * @param role requested. Must be one of the standard roles or - * a private role supported by this factory. - * @param ui type in which the role is requested. - * @return the UI role or null if the requested UI role is not available - * from this factory - * @throws IllegalArgumentException if the role or ui is neither - * one of the standard ones, nor a private one - * supported by the factory. + * @param role requested. Must be one of the standard roles or a private + * role supported by this factory. + * @param ui type in which the role is requested + * @return the UI role or {@code null} if the requested UI role is not + * available from this factory + * @throws IllegalArgumentException if the role or ui is neither one of the + * standard ones, nor a private one supported by the factory */ public abstract Object getUI(int role, String ui) ; /** - * Given a UI role obtained from this factory obtain the UI - * types available from this factory which implement this role. - * The returned Strings should refer to the static variables defined - * in this class so that applications can use equality of reference - * ("=="). - * @param role to be looked up. + * Given a UI role obtained from this factory obtain the UI types available + * from this factory which implement this role. The returned {@code Strings} + * should refer to the static variables defined in this class so that + * applications can use equality of reference ("=="). + * + * @param role to be looked up * @return the UI types supported by this class for the specified role, - * null if no UIs are available for the role. - * @throws IllegalArgumentException is the role is a non-standard - * role not supported by this factory. + * {@code null} if no UIs are available for the role + * @throws IllegalArgumentException is the role is a non-standard role not + * supported by this factory */ public abstract String[] getUIClassNamesForRole(int role) ; - - }