Un bean de respaldo es una clase Java que se comunica con uno o varios formularios (xhtml) de la capa de la vista. Esta clase Java recoge la información introducida en dichos formularios y la procesa, lanzándolos trasladándola a la capa de la lógica de aplicación para que sean procesadossea procesada. A su vez comparte estos datos con la capa de la vista para que se muestren al usuario y . También es la encargada de realizar las tareas de validación y control de los datos introducidos. De , de igual forma que implementa comportamientos de la vista para determinar condiciones para mostrar campos, calcular el contenido de otros, habilitar/deshabilitar etc…

Creación del Bean

Para crear un Bean de respaldo debemos hacer uso de la anotación @Name proporcionada por Seam, la cual habilita nuestra clase Java para ser inyectada en otros contextos. Esto permitirá que, mediante expresiones EL en ,expresiones del tipo #{...}, en la capa de la vista se acceda a nuestro Bean de respaldo a través del nombre dado en la anotación @Name.

@Name("manejadorMapas" ManejadorMapas.ID)
@Scope(ScopeType.CONVERSATION)
public class ManejadorMapas implements Serializable{

	public static final String ID ="manejadorMapas"; 
	private MapModel modeloMapa; 
 
	private List<Marker> marcadores;
 
     ... 
     ...
 
     public MapModel getModeloMapa() {
		return modeloMapa;
	}
 
	public void setModeloMapa(MapModel modeloMapa) {
		this.modeloMapa = modeloMapa;
	}
 
	public List<Marker> getMarcadores() {
		return marcadores;
	}
 
	public void setMarcadores(List<Marker> marcadores) {
		this.marcadores = marcadores;
	}

...

• @Name: Esta anotación hace que Seam sea capaz de buscar e inyectar esta clase Java convertida a Bean done sea necesario, para ello esta anotación debe ir completada con un nombre para localizarlo. Normalmente es el mismo nombre de la clase con la primera letra en minúscula.

• Todas las propiedades que queremos que sean accesibles en la parte de la vista, han de tener un método get/set para que Seam sea capaz de insertar y recuperar los valores de las propiedades (salvo en las propiedades booleanas que los métodos serán set e is).

• Los métodos del Bean de respaldo que se quieran poder ejecutar desde la vista han de ser públicos.

• En la parte de la vista para acceder a cualquier propiedad o método, se debe crear una expresión EL #{ … }, dentro de la expresión EL debemos invocar a la propiedad o la clase poniendo el nombre de nuestro Bean (anotado en la etiqueta @Name), y el nombre del método o propiedad . que queremos referenciar Ej: model=“#{manejadorMapas.modeloMapa}”

• Si un método tiene parámetros de entrada se le pueden añadir dentro de la expresión EL. Ej: model=“#{manejadorMapas.hazAlgo('Texto')}”.

• Los Beans deben tener un constructor vacío para que Seam sea capaz de crearlo si no existe.

  • Si queremos que nuestro Bean se inicialice cuando se cree, debemos crear un método público y void con la anotación @Create 

  • Bloque de código
    language java
    @Create public void inicializa Manejador(){ ... ... }

En este punto, nuestra clase Java, ya es un Bean de respaldo y puede ser accedido desde cualquier vista e inyectado en otros Beans, si hiciera falta. Ahora es turno de especificar la vida de este Bean. Para ello utilizaremos la anotación @Scope donde especificaremos el ámbito de este Bean. La información necesaria sobre los ámbitos podemos consultarla en la entrada de la wiki (Url de la Wiki) Tipos de ámbitos en FundeWeb junto con la guía (Url de la Wiki) Elegir el ámbito correcto.

Anotaciones en nuestro Java Bean

Una vez conocemos cómo crear un Bean de respaldo vamos a comentar las anotaciones más importantes que se pueden utilizar con ellos.

Anotaciones en el encabezado del bean

Son anotaciones que se especifican encima de la definición de la clase (Documentación):

...

• @AutoCreate: Fuerza la creación del componente si no existe.

  • En caso contrario sólo se creará cuando se le invoque por primera vez.

• @Startup: Sólo aplicable a componentes con scope SESSION o APPLICATION. Fuerza que este componente se cree cuando la aplicación o la sesión arrancan. Sus propiedades son:

  • depends: Un listado de los componentes de los que depende este para inicializarlos antes que él.

• @Install: Define cuando un componente se crea o no. Esta anotación está concebida para cuando tenemos componentes con el mismo nombre y que en tiempo de despliegue se elija cual se tendrá en cuenta en la aplicación. Sus propiedades son:

  • classDependencies: Indica que el componente será instalado sólo cuando las clases en esta lista estén cargadas.

  • debug: Indica si este componente es de debug.

  • dependencies: Indica que este componente será instalado después de que los componentes en esta lista estén cargados.

  • genericDependencies: Similar a dependencies, solo que recibe una lista de clases en vez de identificadores.

  • precedence: En caso de conflicto de nombres indica la precedencia de este componente. El componente con mayor precedencia se instalará.

  • value: Indica si este componente es el que se debe instalar por defecto.

Anotaciones en propiedades del Bean

Anotaciones para la Biyección

Se especifican en la definición de las propiedades y métodos get/set de la clase. Documentación.

...

Por defecto (sino se especifica la propiedad value) la anotación @In busca un componente Seam de nombre igual al de la propiedad en sus contextos en el siguiente orden: MethodContext, EventContext, PageContext, ConversationContext, SessionContext, BusinessProcessContext y ApplicationContext. No obstante mediante la propiedad scope podemos mejorar dicha búsqueda. También se puede utilizar en un método set.

No obstante, la forma recomendada para inyectar un Bean que garantiza que, siempre intentará inyectarlo es usando "value" y "create": @In(create = true, value = "servicioPersistenciaAnuncios")

@Out
private ServicioPersistenciaAnuncios servicioAnuncios;
 
@Out(value = "servicioPersistenciaAnuncios")
private ServicioPersistenciaAnuncios servicioAnuncios;
 
@Out(value = "servicioPersistenciaAnuncios", scope = ScopeType.CONVERSATION)
private ServicioPersistenciaAnuncios servicioAnuncios;

...

Por defecto (sino se especifica la propiedad value) la anotación @Out crea la variable de contexto de nombre igual al de la propiedad. También se puede utilizar en un método get.

Anotaciones en métodos del bean

Se especifican en los métodos de la clase:

@PostConstruct@Create
public void inicializaBuscador() {
	this.nombreAnuncio = "";
	this.descAnuncio = "";
	this.fechaAnuncio = null;
}

Anotaciones del

...

estándar JSF para inicialización y destrucción

Estas anotaciones no tienen en cuenta JBoss Seam, por lo que no debemos usarlas, pero sí las veremos en documentación existente.

• @PostConstruct: Situada en un método publico y void de nuestro Bean, se utiliza para indicar que ese método se ejecute inmediatamente después del constructor del Bean con el fin de inicializarlo, y tener disponible los elementos inyectados por el contenedor.

• @PreDestroy: Esta anotación la situaremos en un método publico y void de nuestro Bean y realizará las tareas que queremos que se ejecuten justo antes de que nuestro Bean sea eliminado de la aplicación y marcado para que el recolector Java lo elimine de memoria.

Anotaciones de JBoss Seam para inicialización y destrucción (equivalentes a las del estándar)

• @Create: Situada en un método publico y void de nuestro Bean, se utiliza para indicar que ese método se ejecute inmediatamente después del constructor (y del método anotado con @PostConstruct) del Bean con el fin de inicializarlo, y tener disponible los elementos inyectados por el contenedor y por JBoss Seam (utilizando @In, @Out, etc.). Es la alternativa de JBoss Seam a la anotación @PostConstruct.

...