JSF - Eventos de Aplicativo

O JSF fornece ouvintes de eventos do sistema para realizar tarefas específicas do aplicativo durante o Ciclo de Vida do aplicativo JSF.

S.Não	Evento e descrição do sistema
1	PostConstructApplicationEvent Dispara quando o aplicativo é iniciado. Pode ser usado para executar tarefas de inicialização após o início do aplicativo.
2	PreDestroyApplicationEvent Dispara quando o aplicativo está prestes a ser encerrado. Pode ser usado para realizar tarefas de limpeza antes que o aplicativo esteja prestes a ser encerrado.
3	PreRenderViewEvent Dispara antes que uma página JSF seja exibida. Pode ser usado para autenticar o usuário e fornecer acesso restrito à Visualização JSF.

Os eventos do sistema podem ser tratados da seguinte maneira.

S.Não	Técnica e Descrição
1	SystemEventListener Implemente a interface SystemEventListener e registre a classe system-event-listener em faces-config.xml
2	Method Binding Passe o nome do método de bean gerenciado no atributo listener de f: event.

SystemEventListener

Implemente a interface SystemEventListener.

public class CustomSystemEventListener implements SystemEventListener {
   
   @Override
   public void processEvent(SystemEvent event) throws 
      AbortProcessingException {
      
      if(event instanceof PostConstructApplicationEvent) {
         System.out.println("Application Started. 
            PostConstructApplicationEvent occurred!");
      }      
   }
}

Registre ouvinte de evento de sistema customizado para evento de sistema em faces-config.xml.

<system-event-listener>
   <system-event-listener-class>
      com.tutorialspoint.test.CustomSystemEventListener
   </system-event-listener-class>
   
   <system-event-class>
      javax.faces.event.PostConstructApplicationEvent
   </system-event-class>    					
</system-event-listener>

Método de ligação

Defina um método

public void handleEvent(ComponentSystemEvent event) {
   data = "Hello World";
}

Use o método acima.

<f:event listener = "#{user.handleEvent}" type = "preRenderView" />

Aplicação de exemplo

Vamos criar um aplicativo JSF de teste para testar os eventos do sistema em JSF.

Degrau	Descrição
1	Crie um projeto com o nome helloworld sob um pacote com.tutorialspoint.test conforme explicado no capítulo JSF - Primeira Aplicação .
2	Modifique o arquivo UserData.java conforme explicado abaixo.
3	Crie o arquivo CustomSystemEventListener.java em um pacote com.tutorialspoint.test . Modifique-o conforme explicado abaixo
4	Modifique home.xhtml conforme explicado abaixo.
5	Crie faces-config.xml na pasta WEB-INF. Modifique-o conforme explicado abaixo. Mantenha o resto dos arquivos inalterados.
6	Compile e execute o aplicativo para garantir que a lógica de negócios esteja funcionando de acordo com os requisitos.
7	Por fim, construa o aplicativo na forma de um arquivo war e implante-o no Apache Tomcat Webserver.
8	Inicie seu aplicativo da web usando o URL apropriado, conforme explicado a seguir na última etapa.

UserData.java

package com.tutorialspoint.test;

import java.io.Serializable;

import javax.faces.bean.ManagedBean;
import javax.faces.bean.SessionScoped;
import javax.faces.event.ComponentSystemEvent;

@ManagedBean(name = "userData", eager = true)
@SessionScoped
public class UserData implements Serializable {
   private static final long serialVersionUID = 1L;
   private String data = "sample data";
	
   public void handleEvent(ComponentSystemEvent event) {
      data = "Hello World";
   }

   public String getData() {
      return data;
   }

   public void setData(String data) {
      this.data = data;
   }
}

CustomSystemEventListener.java

package com.tutorialspoint.test;

import javax.faces.application.Application;
import javax.faces.event.AbortProcessingException;
import javax.faces.event.PostConstructApplicationEvent;
import javax.faces.event.PreDestroyApplicationEvent;
import javax.faces.event.SystemEvent;
import javax.faces.event.SystemEventListener;

public class CustomSystemEventListener implements SystemEventListener {

   @Override
   public boolean isListenerForSource(Object value) {
      
      //only for Application
      return (value instanceof Application);
   }

   @Override
   public void processEvent(SystemEvent event) 
      throws AbortProcessingException {
      
      if(event instanceof PostConstructApplicationEvent) {
         System.out.println("Application Started. 
            PostConstructApplicationEvent occurred!");
      }
      
      if(event instanceof PreDestroyApplicationEvent) {
         System.out.println("PreDestroyApplicationEvent occurred.
            Application is stopping.");
      }
   }
}

home.xhtml

<?xml version = "1.0" encoding = "UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns = "http://www.w3.org/1999/xhtml"   
   xmlns:h = "http://java.sun.com/jsf/html"
   xmlns:f = "http://java.sun.com/jsf/core">
   
   <h:head>
      <title>JSF tutorial</title>		   
   </h:head>
   
   <h:body> 
      <h2>Application Events Examples</h2>
      <f:event listener = "#{userData.handleEvent}" type = "preRenderView" />
      #{userData.data}
   </h:body>
</html>

faces-config.xhtml

<?xml version = "1.0" encoding = "UTF-8"?>
<faces-config
   xmlns = "http://java.sun.com/xml/ns/javaee"
   xmlns:xsi = "http://www.w3.org/2001/XMLSchema-instance"
   xsi:schemaLocation = "http://java.sun.com/xml/ns/javaee 
   http://java.sun.com/xml/ns/javaee/web-facesconfig_2_0.xsd"
   version = "2.0">
   
   <application>
      <!-- Application Startup -->
      <system-event-listener>
         <system-event-listener-class>
            com.tutorialspoint.test.CustomSystemEventListener
         </system-event-listener-class>
         <system-event-class>
            javax.faces.event.PostConstructApplicationEvent
         </system-event-class>    					
      </system-event-listener> 
      
      <!-- Before Application is to shut down -->
      <system-event-listener>
         <system-event-listener-class>
            com.tutorialspoint.test.CustomSystemEventListener
         </system-event-listener-class>
         <system-event-class>
            javax.faces.event.PreDestroyApplicationEvent
         </system-event-class>    					
      </system-event-listener>
   </application>
</faces-config>

Assim que você estiver pronto com todas as mudanças feitas, vamos compilar e rodar a aplicação como fizemos no capítulo JSF - Primeira Aplicação. Se tudo estiver bem com sua aplicação, isso produzirá o seguinte resultado.

Olhe para a saída do console do seu servidor web. Você verá o seguinte resultado.

INFO: Deploying web application archive helloworld.war 
Dec 6, 2012 8:21:44 AM com.sun.faces.config.ConfigureListener contextInitialized 

INFO: Initializing Mojarra 2.1.7 (SNAPSHOT 20120206) for context '/helloworld' 
Application Started. PostConstructApplicationEvent occurred! 
Dec 6, 2012 8:21:46 AM com.sun.faces.config.ConfigureListener 
$WebConfigResourceMonitor$Monitor <init> 

INFO: Monitoring jndi:/localhost/helloworld/WEB-INF/faces-config.xml 
for modifications 
Dec 6, 2012 8:21:46 AM org.apache.coyote.http11.Http11Protocol start 

INFO: Starting Coyote HTTP/1.1 on http-8080 
Dec 6, 2012 8:21:46 AM org.apache.jk.common.ChannelSocket init 
INFO: JK: ajp13 listening on /0.0.0.0:8009  

Dec 6, 2012 8:21:46 AM org.apache.jk.server.JkMain start 
INFO: Jk running ID = 0 time = 0/24  config = null 
Dec 6, 2012 8:21:46 AM org.apache.catalina.startup.Catalina start 
INFO: Server startup in 44272 ms

↰ Previous page