Los componentes de JBoss Seam 2.3

— JUAN MIGUEL BERNAL GONZALEZ 2014/02/07 12:27

JBoss Seam 2.3, proporciona clases de utilidad o clases instanciables que permiten realizar acciones más fácilmente.

Dentro del paquete org.jboss.seam.contexts, las clases más interesantes son:

• Contexts.html|Contexts: Clase de utilidad que proporciona acceso a los contextos actuales asociados con el hilo. Los contextos son: application, business process, method, session, conversation, page y event.

Dentro del paquete org.jboss.seam.core, las clases más interesantes son:

• Contexts: Componente Seam que proporciona acceso a los contextos actuales asociados con el hilo. Los contextos son: application, business process, method, session, conversation, page y event.
• Conversation: Componente Seam que permite trabajar directamente con la conversación actual en la que se ejecuta la solicitud.
• Events: Componente Seam que permite dar soporte a los eventos de los componentes, es decir, poder lanzar y capturar eventos (síncronos o asíncronos).
• Expressions: Componente Seam que permite crear expresiones EL de valor y método.
• Init: Componente Seam que contiene la configuración de JBoss Seam para la aplicación.
• Interpolator: Componente Seam que permite interpolar expresiones EL por su valor en un String, es decir, sustituye los parámetros #{0} .. #{n} por su valor real y las expresiones EL reales por su valor real que estan dentro de un String.
• Locale: Componente Seam que permite de la localización (Locale) actual de la aplicación. Esta implementación base simplemente devuelve la configuración regional predeterminada del servidor.
• Manager: Componente Seam que permite gestionar la conversación.
• ResourceBundle: Componente Seam que permite gestionar el paquete de recursos (ResourceBundle) de Seam.
• ResourceLoader: Componente Seam que permite el acceso a los recursos de la aplicación y paquetes de recursos.
• SeamResourceBundle: Clase de utilidad que permite buscar recursos especificados para páginas en pages.xml, y en la lista configurable de recursos especificada en el components.xml.

Dentro del paquete org.jboss.seam.document, las clases más interesantes son:

• DocumentStore: Componente Seam que permite almacenar documentos como una cache con un ámbito de conversación. Los documentos tienen un ID asociado que permite comprobar si están disponibles, almacenarlos o recuperarlos de la cache de documentos.

Dentro del paquete org.jboss.seam.exception, las clases más interesantes son:

• Exceptions: Componente Seam que permite gestionar la cadena de manejadores de excepciones.

Dentro del paquete org.jboss.seam.faces, las clases más interesantes son:

• FacesContext: Componente Seam que permite dar soporte para inyectar el objeto JSF FacesContext.
• FacesExpressions: Componente Seam que permite crear enlaces (bindings) de método y valor en un entorno JSF. Extiende la clase org.jboss.seam.core.Expressions.
• FacesManager: Componente Seam que permite gestionar la conversación en un entorno JSF. Extiende la clase org.jboss.seam.core.Manager.
• FacesMessages: Componente Seam que permite propagar los mensajes JSF (FacesMessage) a través de redirecciones e interpolar las expresiones EL que hay en el String del mensaje. Extiende la clase StatusMessages.
• FacesPage: Componente Seam que permite contabilizar la información persistente de la conversación asociada con la página actual.
• HttpError: Componente Seam que permite devolver un error HTTP como respuesta a la solicitud actual.
• IsUserInRole: Componente Seam que permite administrador el mapa de los roles asignados al usuario actual, y exponerlos a través del ExternalContext de JSF. Extiende la clase org.jboss.seam.web.IsUserInRole.
• Parameters: Componente Seam que permite acceder a los parámetros de la solicitud en un entorno JSF. Extiende la clase org.jboss.seam.web.Parameters.
• Redirect: Componente Seam que permite realizar las redirecciones en los navegadores con parámetros.
• Renderer: Componente Seam que permite la renderización directa de plantillas. Especialmente útil para Seam Mail.
• ResourceLoader: Componente Seam que permite acceder a los recursos de la aplicación en un entorno JSF.
• UiComponent: Componente Seam que permite acceder a los UIComponent JSF de la página actual mediante id.
• UserPrincipal: Componente Seam que permite exponer el actual Principal del usuario a traves del ExternalContext de JSF. Extiende la clase Extiende la clase org.jboss.seam.web.UserPrincipal.
• Validation: Componente Seam que permite determinar a la aplicación, si la fase de validación de JSF se ha realizado con éxito o se ha producido algún error.

Dentro del paquete org.jboss.seam.international, las clases más interesantes son:

• Locale: Componente Seam que permite gestionar el Locale actual, teniendo en encuenta el Locale seleccionado mediante el LocaleSelector. Extiende la clase Locale.
• LocaleConfig: Componente Seam que permite configurar el soporte de Locale para JSF desde el contenedor de Seam. Este componente pasa la configuración al runtime de JSF.
• LocaleSelector: Componente Seam que permite seleccionar la configuración local (Locale) para el usuario actual.
• Messages: Componente Seam que permite crear el mapa de mensajes interpolados definidos en el ResourceBundle de Seam.
• StatusMessage: Clase para instanciar mensajes de estado que se pueden crear en la capa de negocio y se muestra en la capa de vista.
• TimeZone: Componente Seam que permite gestionar el TimeZone del usuario actual seleccionado mediante el TimeZoneSelector.
• TimeZones: Componente Seam que proporciona las lista de TimeZone, limitada a TimeZone con ids que cimplen el formato Continent/Place, excluyendo los desfasados ids de tres letras. Los TimeZone devueltos tienen solucionado la compensación de UTC, que tiene en cuenta al cambio al horario de verano. Por ejemplo, Europe/Madrid es UTC+1; en invierno es GMT+1 y en verano es GMT+2.
• TimeZoneSelector: Componente Seam que permite seleccionar el TimeZone del usuario actual. El valor por defecto es el del servidor.

Dentro del paquete org.jboss.seam.log, las clases más interesantes son:

• Logging: Clase de utilidad que permite obtener instancias de Log y LogProvider. Si log4j existe en el classpath, el LogProvider sera de log4j, sino de JDK logging.

Dentro del paquete org.jboss.seam.mail, las clases más interesantes son:

• MailSession: Componente Seam que permite gestionar la javax.mail.Session.

Dentro del paquete org.jboss.seam.navigation, las clases más interesantes son:

• Pages: Componente Seam que contiene los metadatos de las páginas definidas en pages.xml, incluyendo acciones de página y las descripciones de página.

Dentro del paquete org.jboss.seam.security, las clases más interesantes son:

• Credentials: Componente Seam que permite gestionar la credencial de autenticación.
• FacesSecurityEvents: Componente Seam que permite crear StatusMessage para JSF en respuesta a ciertos eventos de seguridad, y permite desacolpar elcomponente Identity de JSF.
• Identity: Componente Seam que permite gestionar la autenticación del usuario y la gestión de la identidad del mismo.
• SecurityFunctions: Clase de utilidad que permite acceder de forma directa a las funciones de seguridad que están definidas en el Identity como: hasRole y hasPermission.

Dentro del paquete org.jboss.seam.theme, las clases más interesantes son:

• Theme: Componente Seam que permite gestionar los recursos que pueden ser utilizados para el tema de la interface de usuario.
• ThemeSelector: Componente Seam que permite seleccionar el tema de la interface de usuario.

Dentro del paquete org.jboss.seam.transaction, las clases más interesantes son:

• Transaction: Componente Seam que permite obtener la UserTransaction.
• FacesTransactionEvents: Componente Seam que permite producir StatusMessage para JSF en respuesta a ciertos eventos producidos por la transacción.

Dentro del paquete org.jboss.seam.util, las clases más interesantes son:

• Base64: Clase de utilidad que permite codificar y decodificar, hacia y desde la notación Base64.
  • Base64.InputStream: A Base64.InputStream leerá los datos de otro java.io.InputStream, dados en el constructor, y permite codifica y decodificar, hacia y desde la notación Base64 sobre la marcha.
  • Base64.OutputStream: A Base64.OutputStream escribira los datos a otro java.io.OutputStream, dados en el constructor, y permite codifica y decodificar, hacia y desde la notación Base64 sobre la marcha.
• EnumerationIterator: Permite crear un iterador sobre una enumeracíon pasado en el constructor.
• Exceptions: contiene un método para obtener la causa de una excepción, es útil cuando tenemos una excepción encapsulada en una EJBException o ServletException.
• FacesResources: Clase de utilidad que permite obtener un InputStream o URL de un recurso Faces.
• FacesUrlTransformer: Clase auxiliar para preparar URLs JSF que incluyan el identificador de conversación.
• Hex: Codificador y decodificador Hexadecimal, obtenido de Apache Commons Codec. DecoderException y EncoderException han sido sustituidos por RuntimeException.
• IteratorEnumeration: Permite crear una enumeracíon sobre un iterador pasado en el constructor.
• JSF: Permite ciertas operaciones sobre los dataModel de componentes JSF.
• Naming: Permite obtener InitialContext del al API Naming.
• ProxyFactory: Fábrica de clases de proxy dinámicas. Esta factoría genera una clase extiende una superclase e implementa las interfaces dadas. Las llamadas de los métodos heredados de la superclase se reenvían y luego invoke() se llama en el controlador de métodos (MethodHandler) asociados a la clase generada. Las llamadas de los métodos de las interfaces también se envían al controlador de métodos. Esta clase se implementa como API de bajo nivel de Javassist y esta diseñada para maximizar el rendimiento.
• RandomStringUtils: Clase de utilidad que permite crear cadenas de caracteres aleatorios.
• Reflections: Clase de utilidad que permite trabajar con la API de Reflexión de manera sencilla.
• Resources: Clase de utilidad que permite obtener un InputStream o URL de un recurso de la aplicación, cerrar streams, obtener el File real de un recurso.
• Sorter y SortItem: La clase Sorter permite ordenar objetos de la clase SortItem. La clase SortItem contiene dos listas, una llamada around que tienen mayor precedencia y la otra llamada within que contiene objetos que tienen menor precedencia.
• Strings: Clase de utilidad que permite trabajar con Strings.
• TypedBeanProperty: Clase que permite trabajar con campos (Field de una clase) mediante la API de Reflexión. Esta clase permite establecer u obtener el valor del campo.
• Work: Clase abstracta que permite ejecutar una acción dentro de una transacción JTA. Al crear una instancia, solo hay que definir el método protected abstract T work() throws Exception;, esta acción se ejecutará dentro de una transacción si esta no existe, o en la actual si esta existe.
• XML: Clase de utilidad que permite obtener el Element raíz mediante la API DOM4J.

Dentro del paquete org.jboss.seam.web, las clases más interesantes son:

• Session: Componente Seam que permite controlar la invalidación de la HttpSession tanto en entorno JSF como Servlet. Como Seam mantiene el estado interno de la HttpSession, es ilegal llamar a HttpSession.invalidate() mientras el contexto de Seam este activo. Las aplicaciones que utilizan la API de seguridad de Seam, deben llamar al método Identity.logout() en lugar de llamar directamente a este componente.
• UserPrincipal: Componente Seam que permite obtener el actual Principal expuesto mediante el ExternalContext de JSF.

Dentro del paquete org.jboss.seam.webservice, las clases más interesantes son:

• SOAPRequestHandler: Manejador de solicitud SOAP para controlar el ciclo de vida de Seam y gestionar la propagación de la conversación en una invocación a un servicio web, permitiendo tener servicios web con estado.