Como criar um projeto Maven com VRaptor no Eclipse

Minha primeira postagem sobre programação, finalmente! Sempre tive a ideia de fazer algo do gênero, tanto para ajudar pessoas com dificuldade na área, como para me ajudar também, quem nunca fez um manual ou apostila de consultas rápidas?
Como pré-requisito para essa tarefa, precisaremos ter um JDK instalado, Eclipse Java EE e o Maven configurados, e um servlet container, nesse tutorial usarei o Apache Tomcat 7.0.39. Tudo será feito no Windows 7. Quem abriu o hiperlink do Maven verá, na seção de documentação, que é necessário configurar as variáveis de ambiente, tanto para o Java (JAVA_HOME) como para o Maven (M2_HOME).
Após o Java e o Maven testados no CLI do Windows (CMD) com os comandos abaixo:

• java -version
• mvn -version

Iremos instalar o plugin do Maven no Eclipse:

• Depois de abrir o Eclipse, navegue até a opção Help/Eclipse Marketplace.
• Vá na aba Popular e instale o plugin Maven Integration for Eclipse (pode demorar um pouco).
• Depois de finalizar o processo de instalação, precisaremos de outro plugin. Faça o mesmo caminho e agora procure por Maven Integration for Eclipse WTP (Incubation) e instale esse plugin, ele que permitirá o uso do Maven para projetos web.

Feita essas duas partes, trocaremos o Maven Embedded do plugin pelo o que você instalou:

• Na tela principal do Eclipse, navegue até a opção Window/Preferences.
• Na janela de preferências, no tree view navegue até Maven/Installations.
• Perceba que o Maven Embedded está selecionado. Clique em no botão Add e navegue até a pasta do Maven, no meu caso é a pasta apache-maven-3.0.5.
• Aplique essa configuração e aperto o botão OK.

Agora já podemos criar um projeto com o Maven! Entretanto, para realizar a tarefa, vamos precisar do vraptor-blank-project. Vamos fazer para a versão 3.5.0. Precisaremos de dois arquivos contidos nele: log4j.xml e web.xml. O primeiro mantém as configurações de log do VRaptor e o segundo as configurações básicas para o VRaptor funcionar, lembrando que não é necessário criar um filtro caso você esteja utilizando um container de servlet 3.0 por causa do recurso de web-fragments, contudo vou utilizar para substituir o web.xml do Maven, retirando apenas o filtro do VRaptor, uma vez que, caso você use o padrão do Maven, o recurso Expression Language não funcionará. Crie um novo projeto do Maven:

• Na tela principal do Eclipse, navegue até File/New/Other.
• Procure pelo wizard Maven/Maven Project.
• Na tela New Maven Project, deixe da maneira que está. Clique no botão Next.
• No campo Filter, digite webapp. Selecionar o registro que apresenta o Artifact Id maven-archetype-webapp.
• Na tela de configuração do projeto, preencha as informações conforme requeridas (vou deixar um link no final com informações sobre cada campo).
• Clique em Finish.

O processo de criação vai demorar um pouco pois o Maven irá baixar do repositório diversas referências para o projeto, isso depende da velocidade de conexão da sua internet. Agora vamos colocar as referências para o Maven baixar o VRaptor:

• Na pasta do projeto, navegue em Deployed Resources/pom.xml.
• Vai na aba Dependencies e clique no botão Add.

• No campo Group Id, coloque: br.com.caelum.
• No campo Artifact Id, coloque: vraptor.
• No campo Version, coloque: 3.5.0.
• Dica: os dados para essa referência podem ser encontrados aqui.
• Clique no botão OK.
• Salve o pom.xml.

Todos os pacotes necessários serão baixados para o seu projeto suportar o VRaptor. Se quiser visualizar o web-fragment.xml que elimina o uso do filtro no web.xml principal:

• No Project Explorer do Eclipse, navegue na pasta do projeto que criamos até Java Resources/Libraries/Maven Dependencies/vraptor-3.5.0.jar/META-INF/web-fragment.xml.

Vamos colocar agora o log4j.xml e substituir o web.xml do Maven:

• No projeto em branco que baixamos, copie o arquivo src/log4j.xml.
• No Eclipse, cole ele na Source Folder: Java Resources/"src/main/resources".

• Para resolver o problema de validação do log4j.xml, sugiro a seguinte solução.
• Para substituir o conteúdo do web.xml padrão do projeto, procure pelo web.xml no projeto em branco que baixamos, copie o conteúdo do arquivo WebContent/WEB-INF/web.xml, porém retirando a parte dos filtros do VRaptor, conforme a figura:

• Cole isso no web.xml do seu projeto (src/main/webapp/WEB-INF/web.xml) e substitua o display-name pelo nome do seu projeto.

Veja que no seu projeto, dentro de Java Resource, não tem a source folder src/main/java, para solucionar o problema, sugiro a seguinte solução.
Vamos agora criar nossa classe controller, e disponibilizar uma view para testar:

• Crie uma nova classe IndexController no pacote br.com.teste.controller.

• Anote a classe com @Resource do VRaptor.
• Crie um método público que retorne uma String com qualquer nome sem parâmetro.
• Anote esse método com @Path("/") do VRaptor.
• No escopo do método coloque para retornar uma string, como um "Olá mundo!".

• Crie um JSP com o nome index.jsp no diretório src/main/webapp/WEB-INF/jsp/index.

• Coloque o seguinte conteúdo conforme a figura:

• Clique com o botão direito do mouse sobre o projeto, navegue até Run As/Run on Server.
• Selecione o seu servlet container e veja o resultado.

Espero que tenha dado certo para você!
É necessário ter um conhecimento básico do VRaptor para entender o porquê de criar as pastas, colocar as anotações, entre outros, o mesmo vale para o Maven. Segue alguns links rápidos de ajuda:

• Guia inicial de 10 minutos do VRaptor.
• As três principais teclas de atalho do Eclipse.
• Tópico do fórum GUJ que referência um PDF muito interessante sobre o Maven.

Apostilas sensacionais sobre desenvolvimento com Java:

• FJ-11 - Java e Orientação a objetos
• FJ-21 - Java para Desenvolvimento Web
• FJ-28 - Desenv. Ágil para Web com VRaptor, Hibernate e AJAX

Aqlbras!