java Tutorial Mentawai #1 – Criando uma Aplicação

[Arkanun1000 3.055]

O Mentawai foi o primeiro framework web MVC em Java a adotar, implementar, documentar e incentivar todo e qualquer tipo de configuração (actions, filtros, validação, listas, connection pooling, ioc, di, etc.) única e exclusivamente através de configuração programática (100% Java), abolindo por completo o uso de XML e Annotations para as configurações.

 

 

O framework nasceu em junho de 2005 e logo depois foi publicado um artigo no site JavaWorld enfatizando o uso de configuração programática para o controlador MVC (actions/resultados/conseqüências) assim como para validação. Nascia aí o ApplicationManager: configuração em código Java independente do restante da sua aplicação e centralizada numa única classe.

 

 

Para o desenvolvimento de nossos exemplos, você pode utilizar a IDE que desejar, e como servidor de páginas, sugiro a utilização do Apache Tomcat. A versão atual do Mentawai é a 2.5.4 e o jar da do framework pode ser baixado aqui.

 

O primeiro passo é criarmos a aplicação em si. Se estiver usando o Eclipse, é um projeto Dynamic Web Project e se estiver utilizando o Netbeans, é um projeto Java Web -> Aplicação Web. Com o projeto criado, vamos colocar adicionar o jar do Mentawai ao projeto (a própria IDE tem métodos de adicioná-lo, ou então coloque dentro de WEB-INF/lib. Agora, devemos configurar o arquivo web.xml, que fica dentro da pasta WEB-INF. Se ele não existe, crie-o.

 

 

É necessário se cadastrar para acessar o conteúdo.

• Entre
• ou
• Cadastre-se

 

No arquivo, definimos o Controller do Mentawai com o parâmeto servlet, inicializando com o nosso applicationManager. No Mentawai, é ele quem realizará as configurações das Actions – classes que realizam a lógica do aplicativo. No nosso caso, ela estará no pacote net.rafaeltoledo.helloworld. Em seguida, definimos em servlet-mapping qual será a extensão das nossas Actions – .mtw. Assim, uma Action de cadastrar usuário terá um nome como CadastrarUsuario.mtw. Por fim, definimos o arquivo de “boas-vindas”, que será o primeiro a ser chamado ao executar o endereço: username.jsp.

 

Bom, vamos começar criando uma Action que simplesmente pegará o nome do usuário e o devolverá em letras maiúsculas. Crie o arquivo HelloAction no pacote net.rafaeltoledo.helloworld. O arquivo conterá o seguinte:

 

É necessário se cadastrar para acessar o conteúdo.

• Entre
• ou
• Cadastre-se

 

A classe estende a classe BaseAction, definida pelo framework. Essa classe já possui métodos para processamento, filtros, e uma série de funcionalidades que podem ser realizadas, como validação. No nosso exemplo, vamos sobrescrever somente o método execute() que é responsável pelo processamento propriamente dito. A action possui os elementos input e output que correspondem aos dados vindos da JSP e o local onde os dados processados serão colocados, respectivamente. Ao terminar a execução, a Action retorna um valor SUCCESS ou ERROR (ou outro valor definido pelo usuário, se for o caso) que indicará se o resultado do processamento teve êxito. No nosso exemplo, obtemos um valor String do formulário, sob o nome de username, sendo obtido através do método getString(). Se o valor não for nulo ou vazio, a String é retornada com seus caracteres em maiúsculo com o método setValue.

 

O próximo passo, é criarmos o nosso Application Manager. Crie a classe ApplicationManager dentro do pacote net.rafaeltoledo.helloworld. A classe terá esse conteúdo:

 

É necessário se cadastrar para acessar o conteúdo.

• Entre
• ou
• Cadastre-se

 

O nosso ApplicationManager estenderá o ApplicationManager do framework Mentawai. Com isso, sobrescreveremos o método loadActions() que realiza as configurações sobre o comportamento das Actions. Em nosso exemplo, definimos o nome da Action como HelloWorld no construtor da classe ActionConfig (responsável pela configuração propriamente dita) e que essa Action será representada pela classe definida em HelloAction.class (a nossa Action). Em seguida, definimos as consequências, ou seja, o que a Action fará a cada possível saída. Se caso o retorno for SUCCESS, direcionaremos a navegação para hello.jsp (a classe Forward faz o redirecionamento) e, caso for ERROR, voltamos para username.jsp. Por fim, adicionamos a configuração com o método addActionConfig().

 

O próximo e último passo é criar as duas JSPs. Se você não tem familiaridade com elas, fique tranquilo, pois sua sintaxe compartilha de muitas tags do HTML padrão. No nosso caso, ainda usaremos algumas tags extras do Mentawai. Vamos criar primeiro o arquivo username.jsp na raiz do diretório de páginas web.

 

É necessário se cadastrar para acessar o conteúdo.

• Entre
• ou
• Cadastre-se

 

É um formulário bastante simples, com um campo chamado username e um botão com a identificação Enviar. O que temos de “diferente” é a inclusão da taglib, para que possamos utilizar as tags do Mentawai, e que os elementos específicos do Mentawai, tem o prefixo de mtw:. Definimos que ao clicarmos no botão, será chamada a Action HelloWorld.mtw.

 

Vamos agora criar o arquivo hello.jsp:

 

É necessário se cadastrar para acessar o conteúdo.

• Entre
• ou
• Cadastre-se

 

Nesta página, exibimos com a tag mtw:eek:ut o valor username. Pronto! É só isso! Agora basta jogar no servidor (geralmente a IDE fará isso automaticamente quando você mandar executar) e acessar em seu navegador localhost:8080/<nome-do-aplicativo> (obs: o valor da porta pode mudar, de acordo com a sua configuração).

 

 

 

Fonte:

http://www.rafaeltoledo.net/tutorial-mentawai-1-criando-uma-aplicacao/