Struts 2. Versão 1.0. Apostila destinada ao curso com carga horária de 20 (vinte) horas

Transcrição

1 Struts 2 O framework Apache Struts 2 é uma estrutura elegante e extensível para a criação de aplicações Web em Java. A estrutura foi projetada visando otimizar o ciclo completo de desenvolvimento, desde construção a implantação e manutenção das aplicações. Foi originalmente conhecido como WebWork 2. Depois de trabalhar de forma independente durante vários anos, as comunidades Struts e WebWork juntaram forças para criar Struts 2. Esta nova versão é mais simples de usar e se aproxima da ideia da qual o Struts foi concebido para ser. Versão 1.0 Apostila destinada ao curso com carga horária de 20 (vinte) horas

2 Sumário 1. Struts Características do Struts Projeto Simplificado...3 Classes de Ações Simplificadas...3 Não existem mais os ActionForms...3 Padrões inteligentes...3 Melhores características das Tag...4 Novos Detalhes...4 Criando um Hello World em Struts Criação de estrutura de diretórios para o projeto Configurações...5 Arquivo web.xml...5 Arquivo struts.xml...6 Arquivo struts-config.xml:...7 Arquivo struts.properties Actions...9 Camada Action...9 Camada Visão Templates Ajax com Struts...14 Implementação de Janela de Login com o Ajax (DOJO) Validação e Conversão...17 Validação...17 Conversão Struts e Spring Formulário Master/Detail de 31

3 1. Struts 2 Um framework é responsável por automatizar as tarefas mais comuns e fornecer uma plataforma na qual os usuários criam rapidamente seus aplicativos. Struts 2 foi baseado no framework OpenSymphony WebWork. Implementa o padrão de projeto Modelo Visão Controle (MVC Model-View-Control). Em Struts 2 o modelo de exibição, e o controlador são implementadas pelo resultado da ação de um FilterDispatcher (que realiza o trabalho do controlador). O trabalho do Controlador é mapear a solicitação do usuário e tomar as medidas cabíveis. A camada de Modelo contém os dados e a lógica de negócios que é implementado pelo componente de ação. A camada de visão é o componente de apresentação que é comumente implementado usando os padrões JSP, Velocity Template, Freemaker ou qualquer outra tecnologia de apresentação. Características do Struts 2 Projeto Simplificado Programação das classes abstratas em vez de interfaces era um problema do projeto do Struts 1 que foi resolvido no Struts 2. A maioria das classes agora são baseadas em interfaces e na maioria, essas interfaces são o núcleo independente de HTTP. As classes Actions do Struts 2 são uma estrutura independente e simplificada para o uso com POJOs simples. Classes de Ações Simplificadas As classes Actions agora são simples POJOs. Qualquer classe Java que possua o método execute() pode ser usada como uma classe no modelo Action. Não necessita implementar qualquer interface. A Inversão de Controle (IoC) agora é automaticamente introduzida durante o desenvolvimento das classes Actions. Não existem mais os ActionForms A característica dos ActionForms não é mais reconhecida para o Struts 2. Sendo substituídas por simples JavaBean que são utilizados para colocar as propriedades diretamente. Não é preciso usar todas as propriedades. Padrões inteligentes Os elementos de configuração possuem um valor padrão que pode ser definido de acordo com a necessidade. Ainda existem arquivos baseados em padrão XML de configuração que pode ser substituído de acordo com a necessidade. Ao contrário dos ActionForwards, os Results fornecem uma maior flexibilidade para criar múltiplos tipos de saídas. 3 de 31

4 Melhores características das Tag Agora as tags permitem adicionar capacidades de estilo sheet-driven, para que possamos criar páginas mais consistentes e com menos código. As tags são mais capazes e orientada para resultados. Podem ser ser alteradas para uma folha de estilo subjacente. A marcação individual da tag pode ser alterada editando um modelo FreeMarker. Novos Detalhes Utilização de anotações Java 5 como uma alternativa para XML e configuração de propriedades Java. O componente Checkbox não necessita mais de um tratamento especial para os valores falsos. Muitas mudanças podem ser feitas na hora, sem a necessidade de reiniciar o contêiner web. Criando um Hello World em Struts 2 Vamos desenvolver a aplicação tipo Olá Mundo usando o framework Struts 2. Nossa aplicação será o primeiro passo para que possamos compreender as modificações que ocorreram com este framework. Criação de estrutura de diretórios para o projeto Realizar o download do Struts 2 e cópiar o arquivo struts2-blank war para o diretório webapps do Tomcat. Renomear o arquivo struts2-blank war para struts2tutorial.rar e descompactá-lo. Agora inicie o Tomcat e acesse o endereço: No seu navegador mostrará: 4 de 31

5 2. Configurações A Configuração básica necessária para o framework Struts 2 depende da configuração dos seguintes arquivos: struts.xml, web.xml, struts-config.xml e struts.properties. Arquivo web.xml O arquivo de configuração web.xml é um arquivo de configuração Java EE que determina como os elementos da solicitação HTTP são processados pelo servlet container. Não é estritamente um arquivo de configuração do Struts 2, mas é um arquivo que precisa ser configurado para que o Struts 2 possa trabalhar corretamente. Este arquivo fornece um ponto de entrada para qualquer aplicação Web. O ponto de entrada de uma aplicação Struts 2 será um filtro definido no descritor de deployment. Desta forma, vamos definir uma entrada de classe FilterDispatcher no arquivo web.xml. O arquivo web.xml deve ser criada sob a pasta WebContent/WEB-INF. Vejamos um exemplo do arquivo web.xml: <?xml version="1.0" encoding="utf-8"?> <web-app xmlns:xsi=" xmlns=" xmlns:web=" xsi:schemalocation=" id="webapp_id" version="3.0"> <display-name>struts 2</display-name> <welcome-file-list> <welcome-file>index.jsp</welcome-file> </welcome-file-list> <filter> <filter-name>struts2</filter-name> <filter-class> org.apache.struts2.dispatcher.filterdispatcher </filter-class> </filter> <filter-mapping> <filter-name>struts2</filter-name> <url-pattern>/*</url-pattern> </filter-mapping> </web-app> Para mapear o filtro do Struts 2, usamos /*, e não /*.action o que significa que todas as urls serão analisadas pelo filtro do Struts. 5 de 31

6 Arquivo struts.xml O arquivo struts.xml contém as informações de configuração que devemos modificar como as ações que são desenvolvidas. Este arquivo pode ser usado para substituir as configurações padrões de um aplicativo, por exemplo struts.devmode = false E outras configurações que são definidas no arquivo de propriedades. Este arquivo pode ser criado na pasta WEB-INF/classes. Vejamos um exemplo do arquivo struts.xml: <?xml version="1.0" encoding="utf-8"?> <!DOCTYPE struts PUBLIC "-//Apache Software Foundation//DTD Struts Configuration 2.0//EN" " <struts> <constant name="struts.devmode" value="true" /> <package name="helloworld" extends="struts-default"> <action name="hello" class="com.tutorialspoint.struts2.helloworldaction" method="execute"> <result name="success">/helloworld.jsp</result> </action> <-- more actions can be listed here --> </package> <-- more packages can be listed here --> </struts> A primeira coisa a notar é o elemento DOCTYPE. Todo o arquivo XML necessita ter um elemento doctype correto, conforme mostrado no código. <struts> é a tag raiz, no qual podemos declarar diferentes pacotes usando a tag <package>, isso permite a separação e a modularização da configuração. O que vem a ser muito útil quando temos um grande projeto dividido em diferentes partes. Digamos que, seu projeto possua três domínios: Negocio, Cliente e Pessoal, então podemos criar três pacotes e armazenar as ações associadas no pacote apropriado. A tag <package> possui os seguintes atributos: Atributo name (obrigatório) extends abstract namespace Descrição O identificador exclusivo para o pacote Nome do pacote herdado. Por padrão, usamos struts-default, como o pacote base Se marcado como true, o pacote não está disponível para o usuário final Nome único para as ações A tag <constant> juntamente com os atributos nome e valor são usados para substituir qualquer uma das seguintes propriedades definidas no default.properties, como acabamos de definir na propriedade struts.devmode. Definir esta propriedade permite ver as 6 de 31

7 mensagens de depuração no arquivo de log. Definimos as tags <action> correspondete a cada URL que desejamos acessar e definimos uma classe com método execute() que é acessado ao acessarmos a URL correspondente. A tag <result> determina o que é retornado para o navegador após uma ação for executada. A ação retorna um objeto do tipo String que contém o nome de um resultado. Essas tags são configuradas por ação ou como um resultado "global", disponível para cada ação em um pacote. Os resultados têm nome opcional e atributos de tipo. Usamos a String "sucess" como o nome de valor padrão. O arquivo struts.xml pode ficar muito grande ao longo do tempo, então é possível quebrá-lo por pacotes, o que é uma forma de modularizar, mas a Struts 2 oferece uma nova maneira de modularizar o arquivo struts.xml. É possível dividi-lo em vários arquivos XML e importálos da seguinte forma: <?xml version="1.0" encoding="utf-8"?> <!DOCTYPE struts PUBLIC "-//Apache Software Foundation//DTD Struts Configuration 2.0//EN" " <struts> <include file="my-struts1.xml"/> <include file="my-struts2.xml"/> </struts> Arquivo struts-config.xml: O arquivo de configuração struts-config.xml é a ligação entre a Visão e os componentes do modelo no Cliente Web. Contém os seguinte elementos principais: Interceptor struts-config form-bean global forwards action-mappings controller plug-in Descrição Nó raiz do arquivo de configuração. Local para mapear sua subclasse ActionForm. Pode-se usar este nome como um alias para a ActionForm todo o resto do arquivo strutsconfig.xml, e até mesmo nas páginas JSP. Esta seção mapeia uma página em seu webapp para um nome. Pode-se usar este nome para se referir à página real. Isso evita codificar URLs em suas páginas Web. Declaração do manipuladores de formulários e onde também são conhecidos como mapeamentos de ação. Esta seção configura as internas do Struts e raramente é usada em situações práticas. Esta seção informa ao Struts onde encontrar seus arquivos de propriedades, que contêm instruções e mensagens de erro Vejamos um exemplo do arquivo struts-config.xml: 7 de 31

8 <?xml version="1.0" encoding="iso "?> <!DOCTYPE struts-config PUBLIC "-//Apache Software Foundation//DTD Struts Configuration 1.0//EN" " <struts-config> <!-- ========== Form Bean Definitions ============ --> <form-beans> <form-bean name="login" type="test.struts.loginform" /> </form-beans> <!-- ========== Global Forward Definitions ========= --> <global-forwards> </global-forwards> <!-- ========== Action Mapping Definitions ======== --> <action-mappings> <action path="/login" type="test.struts.loginaction" > <forward name="valid" path="/jsp/mainmenu.jsp" /> <forward name="invalid" path="/jsp/loginview.jsp" /> </action> </action-mappings> <!-- ========== Controller Definitions ======== --> <controller contenttype="text/html;charset=utf-8" debug="3" maxfilesize="1.618m" locale="true" nocache="true"/> </struts-config> Arquivo struts.properties Este arquivo de configuração fornece um mecanismo para alterar o comportamento padrão do framework. Todas propriedades contidas neste arquivo também podem ser configuradas no web.xml usando o param-init, bem como usando a tag <constant> no arquivo struts.xml. Para manter os detalhes separados e um suporte mais específico, podemos criar este arquivo na pasta WEB-INF/classes. Os valores configurados neste arquivo substituem os valores padrões configurados em default.properties que estão contidos na distribuição struts2-core-x.y.z.jar. Existem propriedades que podem ser modificadas usando o arquivo struts.properties: ### Ao ser definido como verdadeiro, mostra as mensagens padrões struts.devmode = true ### Permite a releitura dos arquivos de internacionalização struts.i18n.reload = true ### Permite a releitura dos arquivos de configuração XML struts.configuration.xml.reload = true ### Define a porta que o servidor é executado struts.url.http.port = 8080 A linha iniciada com com o caracter #, será assumida como um comentário e ignorada pelo Struts 2. 8 de 31

9 3. Actions Actions são o ponto central do framework Struts 2, bem como para qualquer framework modelo MVC (Model View Controller). Cada URL é mapeada para uma action específica, que fornece a lógica de processamento necessária para atender à solicitação do usuário. Actions possuem duas outras capacidades importantes. Primeiro, uma action desempenha um papel importante na transferência de dados a partir do pedido através do ponto de vista, se o seu tipo um JSP ou outro resultado. Em segundo lugar, o recurso deve ajudar o quadro para determinar qual resultado deve tornar a visão de que será devolvido na resposta ao pedido. Camada Action O único requisito para as actions em Struts 2 é que deve haver um método sem argumento que retorna um objeto String ou um elemento Result e deve ser um POJO. Se o método não-argumento não for especificado, o comportamento padrão é usar o método execute(). Opcionalmente, pode-se estender a classe ActionSupport que implementa seis interfaces, incluindo a interface Action. Esta interface é mostrada como se segue: public interface Action { public static final String SUCCESS = "success"; public static final String NONE = "none"; public static final String ERROR = "error"; public static final String INPUT = "input"; public static final String LOGIN = "login"; public String execute() throws Exception; Vamos dar uma olhada no método de ação para um exemplo "Hello World": package x25.com.tutorial; public class HelloWorldAction{ private String name; public String execute() throws Exception { return "success"; public String getname() { return name; public void setname(string name) { this.name = name; Para ilustrar o ponto que o método da action controla a visão, faremos a seguinte alteração no método execute() e estender a classe ActionSupport como segue: 9 de 31

10 package x25.com.tutorial; import com.opensymphony.xwork2.actionsupport; public class HelloAction extends ActionSupport{ private String nome; public String execute() throws Exception { if ("SECRET".equals(nome)) { return SUCCESS; else { return ERROR; public String getnome() { return nome; public void setnome(string nome) { this.nome = nome; Neste exemplo, temos a seguinte lógica para o método execute() de modo a visualizar o atributo nome. Se este atributo for igual a "SECRET", retornamos SUCESS como o resultado, caso contrário retornamos um ERROR como o resultado. Porque estendemos ActionSupport, para isso usamos as constantes SUCESS e ERROR. Agora, vamos modificar nosso arquivo struts.xml como segue: <?xml version="1.0" encoding="utf-8"?> <!DOCTYPE struts PUBLIC "-//Apache Software Foundation//DTD Struts Configuration 2.0//EN" " <struts> <constant name="struts.devmode" value="true" /> <package name="helloworld" extends="struts-default"> <action name="hello" class="x25.com.tutorial.helloaction" method="execute"> <result name="success">/helloworld.jsp</result> <result name="error">/accessdenied.jsp</result> </action> </package> </struts> Camada Visão Criamos o arquivo chamado HelloWorld.jsp na pasta raiz do seu projeto. Este arquivo será chamado em caso do retorno ter como resultado "SUCESS", tal como definido na interface Action: <%@ page contenttype="text/html; charset=utf-8" %> <%@ taglib prefix="s" uri="/struts-tags" %> <html> <head> 10 de 31

11 <title>hello World</title> </head> <body> Olá Mundo, <s:property value="name"/> </body> </html> Este outro arquivo será chamado pelo framework no caso que o resultado da Action seja ERROR. A seguir é o conteúdo de AccessDenied.jsp: <%@ page contenttype="text/html; charset=utf-8" %> <%@ taglib prefix="s" uri="/struts-tags" %> <html> <head> <title>acesso Bloqueado</title> </head> <body> Você não está autorizado a ver esta página. </body> </html> Também precisamos criar o arquivo index.jsp na pasta raiz. Este arquivo será utilizado como ação inicial onde o usuário informa o nome e submete o formulário chamando o método da classe HelloAction e tornar a visão HelloWorld.jsp. <%@page language="java" contenttype="text/html; charset=iso " pageencoding="iso "%> <%@taglib prefix="s" uri="/struts-tags"%> <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" " <html> <head> <title>hello World</title> </head> <body> <h1>hello World com Struts 2</h1> <form action="hello"> <label for="nome">por favor entre com seu nome</label><br/> <input type="text" name="nome"/> <input type="submit" value="diga Hello"/> </form> </body> </html> Não existe qualquer mudança necessária no arquivo web.xml. Execute o aplicativo através do endereço 11 de 31

12 4. Templates Templates são carregadas prioritariamente, pesquisando a aplicação e depois por procurar o classpath. Se uma Template precisa de ser substituída, uma cópia é editada e pode ser colocada na aplicação, de modo que seja encontrada. Em muitas áreas o Struts 2 permaneceu praticamente inalterado depois de sua junção com o Webwork. É possível ter uma Template para o controle da aparência de suas tags em um nível de granulação fina ou em nível de aplicativo. Supondo o suporte a boas práticas e cada tag <input> possua uma tag <label>, conforme a seguinte codificação: <label for="nome">nome</label> <input type="text" name="nome" id="nome"/> Embora possamos escrever uma tag <label> para cada tag <input> manualmente para conseguir essa boa prática, podemos especificar uma Template para renderizar as tags <s:textfield> de modo a reduzir a codificação escrita na JSP. Criar uma Template chamada text.ftl no pasta template/mysimpletheme e certifique-se que está na classpath. Codificação text.ftl: <label <#if parameters.id?exists> for="${parameters.id?html" <#t/> </#if> >${parameters.label?html</label> <#include "/${parameters.templatedir/simple/text.ftl" /> O arquivo de inclusão está apontando para um modelo bare-bones disponibilizado com o Struts que torna um simples <input type="text"/> com todos seus atributos. Tudo o que estamos fazendo no código adicional é uma verificação da existência de um id sendo passado através da tag <textfield> e mostrá-lo em uma tag <label> juntamente com seu valor que está sendo passado. Agora temos tem uma Template para trabalhar, tudo o que resta a fazer é utilizá-la. Esta é uma maneira que pode aplicá-la a um único campo de texto: <s:textfield id="nome" name="nome" theme="mysimpletheme" label="nome"/> A declaração do tema "mysimpletheme" está informando ao Struts procurar uma Template no diretório mysimpletheme sob o diretório padrão de Templates. Para este modelo processar todos as tags <TextField> em vez de especificar theme="mysimpletheme" todas as vezes, devemos modificar as propriedades struts.ui.theme e struts.ui.templatedir no arquivo struts.properties que possuem como valores padrões de xhtml e template, respectivamente. O tema padrão do Struts é xhtml que renderiza as tags <td> e <tr> e tudo o mais que é indesejável na marcação. Para desativar essa renderização e os atributos de tag, podemos utilizar o tema "simple" como a seguinte codificação: <s:textfield id="nome" name="nome" theme="simple" label="nome"/> Alternativamente, podemos definir o atributo struts.ui.theme para simple no arquivo struts.properties. Também podemos definir o atributo template de cada controle para 12 de 31

13 apontar para um outro diretório. Resumidamente, o Struts fornece templates padrões no arquivo struts-core.jar deve atender às necessidades de muitas aplicações. No entanto, se uma template precisa ser modificada, é fácil conectar uma nova versão. Para extrair uma template é necessária mudar a partir do struts-core.jar, faça as modificações e salve uma cópia atualizada na pasta template/$theme/$template.ftl. Se estiver utilizando o tema XHMTL e precisa mudar a forma como as tags selecionem e renderizam, editar esse modelo e salve-o em /template/xhtml/select.ftl. O mecanismo global para controlar a aparência é completamente diferente do Struts 1.x sendo um pouco mais complexa do que pode ser necessário para muitos projetos. Porém permite uma maior liberdade para ajustar as templates de modo a atender qualquer caso. Este é um método de baixo nível para controlar a aparência de um controle CSS. Struts usa arquivos CSS na renderização de sua construção. Temas como xhtml são modificados para xhtml_css, embora essa renomeação possa não ser um bom padrão. Por exemplo, ao usar o seu tema xhtml_css e <s:textfield>, é necessário escrever classes CSS chamadas wwgrp e wwlbl para controlar a exibição das tags <label> e <input>. 13 de 31

14 5. Ajax com Struts Desenvolvedores do Ajax sabem que as tabelas podem fazer muito mais do que a exibição estática informações em um formato organizado, legível. Ao sincronizar-se as linhas da tabela com um banco de dados do lado do servidor, é possível criar tabelas dinâmicas desse tipo, filtrar dados e realizar paginação. Diversas soluções Ajax possuem a vantagem de simplificar a programação, convertendo o código do servidor Java em JavaScript, normalmente à custa da flexibilidade. A maioria dos desenvolvedores não querem ter o modelo de programação restringido pelo número limitado de componentes que essas estruturas fornecem. Neste quisito, criar conteúdo personalizado com Struts 2 e Ajax realmente é a melhor escolha, pois Struts 2 integra poderosos aliados para fazer o desenvolvimento Ajax tornar-se prazer. Implementação de Janela de Login com o Ajax (DOJO) Vejamos como desenvolver uma aplicação de Login usando o Ajax. Nesta aplicação é mostrado um formulário para autenticar um usuário, solitando o nome e a senha (O nome de login e senha é "admin"). Exibe uma página de boas vindas, quando ambos os campos forem corretamente preenchidos pelo usuário. Caso contrário, mostra uma mensagem de erro e debug (nome de usuário e senha inválidos Por favor, tente novamente e DEBUG: widget ID collision on ID: ajaxlogin_0). Inicialmente, criamos um mapeamento de ação no arquivo struts.xml. Aqui está o código para ser adicionado neste arquivo: <action name="showajaxloginform"> <result>/pages/ajaxlogin.jsp</result> </action> <action name="ajaxlogin" class="net.roseindia.login"> <result name="input">/pages/ajaxlogin.jsp</result> <result name="error">/pages/ajaxlogin.jsp</result> <result>/pages/ajaxloginsuccess.jsp</result> </action> A interface gráfica do aplicativo consiste em um formulário de login (ajaxlogin.jsp), que exibe a página de login para o usuário. Esta página usa a tag <s:div> que cria uma área de conteúdo para carregar o conteúdo utilizando tags do Ajax. Aqui também usamos a tag <s:submit> para atualizar o(s) elemento(s) ou que apresente uma mensagem de ajuda. Sempre que ocorre um erro as tags <s:actionerror> e <s:fielderror> exibem uma mensagem no formulário de login. Página: ajaxlogin.jsp <%@ taglib prefix="s" uri="/struts-tags"%> <html> <head> <s:head theme="ajax" debug="true"/> </script> 14 de 31

15 </head> <body> <s:div id="logindiv" theme="ajax"> <div style="width: 300px;border-style: solid"> <s:form action="ajaxlogin" validate="true"> <tr> <td colspan="2">entrada no Sistema</td> </tr> <tr> <td colspan="2"><s:actionerror /><s:fielderror /></td> </tr> <s:textfield name="username" label="nome"/> <s:password name="password" label="senha"/> <s:submit theme="ajax" targets="logindiv" notifytopics="/ajaxlogin"/> </s:form> </div> </s:div> </body> </html> Devemos agora, desenvolver uma classe de ação que trata a solicitação de login e verifica a autenticação do usuário. Se o nome do usuário e senha for "Admin", então retorna SUCESS caso contrário o objeto ERROR. Bean de Ação: Login.java package x25.com.tutorial; import com.opensymphony.xwork2.actionsupport; import java.util.date; public class Login extends ActionSupport { private String username = null; private String password = null; public String execute() throws Exception { System.out.println("Validando o Login..."); if ("Admin".equals(getUsername()) && "Admin".equals(getPassword()) { return SUCCESS; addactionerror("usuário ou senha inválida! Tente novamente!"); return ERROR; public String getusername() { return username; public void setusername(string value) { username = value; public String getpassword() { return password; 15 de 31

16 public void setpassword(string value) { password = value; A página ajaxloginsuccess.jsp exibe a mensagem de sucesso do Login (Bem Vindo Admin) quando o usuário é autenticado com êxito. Página: ajaxloginsuccess.jsp <html> <head> <title>login com Sucesso</title> </head> <body> <p align="center"> <font color="#000080" size="5">login realizado com sucesso!</font> </p> <h1> Bem Vindo <%=request.getparameter("username")%> </h1> </body> </html> 16 de 31

17 6. Validação e Conversão Um Validador (validator) verifica automaticamente se um erro de conversão ocorreu para um determinado campo. Uma conversão de tipo no framework é transparente. Geralmente, tudo o que é necessário fazer é garantir as entradas HTML possuem nomes que podem ser usados em expressões OGNL. Validação Neste exemplo, veremos como podemos validar uma página de login usando as validações do Struts 2. Para criarmos a página de login, as tags da interface do Struts. A tag <s:head> deve ser colocada na seção head da página HTML, esta tag gera automaticamente links para as bibliotecas de CSS e Javascript que são necessários para processar os elementos do formulário. A tag <s:form> contém os elementos do formulário. O atributo action contém o nome da ação que deve ser executada quando o formulário for submetido. Este nome da ação deve ser igual ao especificado no arquivo de configuração struts.xml. O tag <s:textfield> é usada para criar uma caixa de texto. O atributo label dessa tag contém o nome a ser exibido na página e o atributo name contém o nome da propriedade na classe da ação a ser mapeado. A tag <s:password> é idêntica a tag <s:textfield> excepto que o valor de entrada é mascarado. A tag <s:submit> é usada para criar um botão de submissão (envio do formulário). Página: login.jsp <%@taglib uri="/struts-tags" prefix="s" %> <head> <title>página Login</title> <s:head /> </head> <body> <s:form action="login"> <s:textfield name="username" label="usuário" /> <s:password name="password" label="senha" /> <s:submit value="entrar" /> </s:form> </body> Quando o usuário clicar no botão Entrar o pedido será encaminhado para a ação Login. Devemos realizar o mapeamento desta ação no arquivo struts.xml. <package name="default" extends="struts-default"> <action name="login" class="x25.com.tutorial.login"> <result name="input">/login.jsp</result> <result name="success">/success.jsp</result> </action> </package> Aqui o nosso pacote "padrão" estende o pacote "struts-default". Ao estender o "struts- 17 de 31

18 default" o pacote herda o conjunto de interceptores definido no defaultstack. O pacote "struts-default" é definido no arquivo struts-default.xml. Todas as tarefas comuns são realizadas pelas ações e separadas e colocadas em interceptores diferentes. Pode-se definir um interceptador para cada ação. Os interceptores mais comuns são utilizados agrupados em uma pilha defaultstack do pacote struts-default. O defaultstack será suficiente na maioria dos casos. Os interceptores serão disparados na ordem em que são declarados na pilha, tanto antes como após a acção é executada. Aqui, a ação "Login" é mapeado para a classe "Login" do pacote x25.com.tutorial. Os resultados são definidos usando o elemento "<result>". Se algum erro de validação ocorrer o usuário será encaminhado para a página login.jsp. Se o login for bem sucedido, então o usuário será encaminhado para a página sucesso.jsp. O defaultstack contém os seguintes interceptores: <interceptor-stack name="defaultstack"> <interceptor-ref name="exception"/> <interceptor-ref name="alias"/> <interceptor-ref name="servletconfig"/> <interceptor-ref name="prepare"/> <interceptor-ref name="i18n"/> <interceptor-ref name="chain"/> <interceptor-ref name="debugging"/> <interceptor-ref name="profiling"/> <interceptor-ref name="scopedmodeldriven"/> <interceptor-ref name="modeldriven"/> <interceptor-ref name="fileupload"/> <interceptor-ref name="checkbox"/> <interceptor-ref name="staticparams"/> <interceptor-ref name="actionmappingparams"/> <interceptor-ref name="params"> <param name="excludeparams">dojo\..*,^struts\..*</param> </interceptor-ref> <interceptor-ref name="conversionerror"/> <interceptor-ref name="validation"> <param name="excludemethods">input,back,cancel,browse</param> </interceptor-ref> <interceptor-ref name="workflow"> <param name="excludemethods">input,back,cancel,browse</param> </interceptor-ref> </interceptor-stack> A classe de ação Login estende ActionSupport. Estender a classe ActionSupport fornece a implementação padrão para a maioria das tarefas comuns. public class Login extends ActionSupport { private String username; private String password; public Login() { public String execute() { 18 de 31

19 return SUCCESS; public void validate() { if (getusername().length() == 0) { addfielderror("username", "Nome é obrigatório"); else if (!getusername().equals("admin")) { addfielderror("username", "Usuário Inválido"); if (getpassword().length() == 0) { addfielderror("password", gettext("password.required")); public String getusername() { return username; public void setusername(string username) { this.username = username; public String getpassword() { return password; public void setpassword(string password) { this.password = password; A classe implementa a interface ActionSupport que expõe o método execute(). As seguintes constantes são declarados na interface de ação que podem ser usadas como valores de retorno do método execute(). public static final String ERROR = "error" public static final String INPUT = "input" public static final String LOGIN = "login" public static final String NONE = "none" public static final String SUCCESS = "success" São os seguintes valores: ERROR devolvido quando a execução da ação falha INPUT devolvido quando a ação exige a entrada do usuário. LOGIN devolvido quando o usuário não estiver logado no sistema. NONE devolvido quando a execução da ação for bem sucedida e não existem visões para mostrar. SUCCESS devolvido quando a ação for executada com êxito e o resultado correspondente é exibido para o usuário. Agora vamos ver os papéis desempenhados pelos diferentes interceptores. O interceptor params ajuda em transferir os dados da solicitação para o objeto da 19 de 31

20 ação. O interceptor workflow controla o fluxo de controle. Verifica se a ação implementa a interface Validateable, se isso acontecer, esse interceptor chamar o método validate() da classe Action. No método validate() valida o usuário e a senha. Se a validação falhar um erro é adicionado usando o método addfilederror(). O método validate() não retorna nenhum erro, em vez disso, armazena todos os erros com a ajuda da interface ValidationAware. Agora, o interceptor workflow verifica os erros de validação ocorridos. Se algum erro ocorreu no interceptor o processamento do pedido será interrompido e o controle é transferido para a página de entrada com as mensagens de erro apropriadas. Para cada campo, as mensagens de erro podem ser adicionadas usando o método addfielderror(). As mensagens de erro pode ser adicionadas diretamente ou pode ser especificado em um arquivo de propriedades separado. Os arquivos de propriedades deve possuir o mesmo nome da classe Action. Neste caso o nome do arquivo de propriedades é "Login.properties" já que o nome da ação é "Login.java". Este arquivo deve conter a seguinte entrada: password.required = Senha é obrigatória. O método gettext() é fornecido pela interface TextProvider e pode ser usado para retornar as mensagens de erro. Conversão Conversão de tipo é ideal para as situações na qual precisamos transformar uma String em um objeto mais complexo. Porque para a Web tudo é uma sequência em HTTP, Uma das principais características do WebWork era uma conversão de tipo muito úteis. Por exemplo, se o usuário estivesse acessando as coordenadas na forma de uma String (como "3, 22"), podemos necessitar da conversão tanto de String para ponto como de ponto a String. Usando este exemplo, se sua ação (ou outro objeto composto no qual está definindo em propriedades) possui um arquivo ClassName-conversion.properties, Os conversores de tipo configurados para conversão de e para strings. Transformar "3, 22" para o ponto (3, 22) direcionamos a seguinte entrada para o arquivo de propriedades: ponto = x25.com.converter.pontoconverter Um exemplo de conversão de tipo é mostrado abaixo, usamos a conversão de data e moeda, ao clicar no botão Enviar esses valores serão convertidos. Página: Submit.jsp <%@ taglib prefix="s" uri="/struts-tags" %> <head> <title>formulário de Submissão</title> <style type="text/css">@import url(css/main.css);</style> <style>.errormessage { color:green; 20 de 31