Tutorial Módulo 01 Arquitetura Anexo I. Tutorial Módulo 01 Arquitetura Anexo I. LABORATÓRIO 01 Arquitetura e Configuração

Transcrição

1 Tutorial Módulo 01 Arquitetura Anexo I LABORATÓRIO 01 Arquitetura e Configuração Este documento tem por objetivo a orientação para a configuração do ambiente, utilizando a IDE Eclipse, e a criação de um projeto Web sem os recursos dos Archetypes do Maven2 ou as facilidades do Wizard. O ambiente do desenvolvedor deverá conter os seguintes softwares: Software Versão Objetivo Compilador Java (JDK) 1.5.0_17* Compilação dos projetos Eclipse Ganymede IDE para desenvolvimento AspectJ Development Tools for Eclipse Compilação de aspectos Maven Integration for Eclipse 0.9.7* Integração com projetos Maven Servidor de Aplicação Tomcat Servidor de aplicação Web Demoiselle Wizard Gerador de código do Framework Demoiselle Jboss Tools 3.0 Kit de acessórios para desenvolvimento * Mínima Objetivos: Criar e configurar um projeto Web para uso com Demoiselle, sem uso de archetype; Criar subsídios para o restante dos módulos. 1 Modificado em: 07/05/10 13:55:01

2 Exercício 1.0 Instalação e configuração do Ambiente: 1. Baixar e instalar a JDK JAVA ( também é possível utilizar JAVA 6, mas mantendo a compatibilidade com JAVA Baixar e instalar a IDE Eclipse Ganymede ( 3. Inicie o uso do Eclipse. 4. Já no interface do Eclipse utilize a opção de Software Updates: Menu-> Help-> Software Updates. 5. Utilize a opção Add Site... para instalar os seguintes softwares: 1. AspectJ Development Tools for Eclipse ( 2. Maven Integration for Eclipse ( 3. Demoiselle Wizard ( 4. JBoss Tools ( Exceto para o Demoiselle Wizard, os demais softwares possuem versões compactadas para download. Recomenda-se, entretanto, o uso do update site. 6. Baixe o servidor de aplicações TomCat ( caso não tenha instalado, e descompacte-o em um diretório do seu computador. 1. No ambiente Eclipse utilize o menu File New Other Server: 2 Modificado em: 07/05/10 13:55:02

3 2. Clique no botão Next para a próxima tela 3. Selecione a opção Tomcat v6.0 Server, e clique no botão Next para a próxima tela 3 Modificado em: 07/05/10 13:55:02

4 4. Na opção Tomcat installation directory, informe o diretório (use o botão Browse...) onde foi descompactado o pacote do servidor. 5. Clique no botão Finish. 4 Modificado em: 07/05/10 13:55:02

5 Exercício 1.1 Criação do Projeto. 1. Criando um novo projeto No ambiente Eclipse acione o menu: File New Dynamic Web Project Caso a opção na apareça na tela, utilize o menu File New Other Web: Na próxima tela defina o nome do projeto e as configurações. 5 Modificado em: 07/05/10 13:55:02

6 Selecione Target Runtime: Apache Tomcat v6.0; Selecione Dynamic Web Module version: 2.5. Selecione Configuration: Default Configuration for Apache Tomcat v6.0. Vá à próxima tela clicando em Next >. 6 Modificado em: 07/05/10 13:55:03

7 Informe os dados do seu projeto. Context Root: nome_do_projeto Content Directory: /src/main/webapp/ Java Source Directory: /src/main/java/ Acione o botão Finish para iniciar a criação do projeto. Em seguida, baixe o pacote do Demoiselle ( descompacte-o, e coloque todos os arquivos *.jar (inclusive pasta /lib) na pasta /src/main/webapp/web-inf/lib. Baixe os binários (fonte: descompacte-os, copie os arquivos *.jar (inclusive pasta /lib) para a mesma pasta (/src/main/webapp/web-inf/lib.), os pacotes dos componentes listados nas versões mais recentes: demoiselle-authorization demoiselle-common demoiselle-environment demoiselle-hibernate-filter demoiselle-jsf-ui demoisell demoiselle-report demoiselle-scheduler demoiselle-security 7 Modificado em: 07/05/10 13:55:03

8 A estrutura de pacotes pode ser criada conforme o exemplo abaixo: Recomendamos também a criação do arquivo package-info.java, em cada pacote, que contém o diretório do pacote (ex: package br.gov.demoiselle.escola;): 8 Modificado em: 07/05/10 13:55:03

9 Crie também as seguintes pastas de código (source folder) no menu File New Source Folder : /src/main/resources /src/test/java /src/test/resources Crie os seguintes arquivos na pasta /src/main/resources: demoiselle.properties: # --- Web Configuration --- framework.demoiselle.web.initialization.action=br.gov.framework.demois elle.web.transaction.webtransactionaction framework.demoiselle.web.redirect.action=br.gov.component.demoiselle.r eport.reportaction # --- View Configuration --- framework.demoiselle.view.faces.datascroller.maxpages=10 framework.demoiselle.view.faces.datascroller.rows=10 # --- Authorization Configuration --- component.demoiselle.authorization.ibusinesscontrollerauthorization=fa lse component.demoiselle.authorization.idaoauthorization=false component.demoiselle.authorization.ifacadeauthorization=false component.demoiselle.authorization.iviewcontrollerauthorization=false # --- Environment Configuration --- application.environment = desenvolvimento environment.desenvolvimento.temporary_path = /private/temp/ environment.desenvolvimento.upload_path = /private/upload/ environment.desenvolvimento.log_path = /private/log/ 9 Modificado em: 07/05/10 13:55:03

10 # --- Report Configuration --- #component.demoiselle.report.builder=<class> # --- Scheduler Configuration --- #component.demoiselle.scheduler.action=<class> # --- Skin Configuration --- application.skin.defaultskin=demoiselle_azul application.skin.demoiselle_azul.description=demoiselle Azul application.skin.demoiselle_azul.css=/jsf/skin/resource/css/demoiselle _azul.css application.skin.demoiselle_laranja.description=demoiselle Laranja application.skin.demoiselle_laranja.css=/jsf/skin/resource/css/demoise lle_laranja.css # --- Resource of Jsf.ui component --- component.demoiselle.jsf.help.fileextension=.hlp component.demoiselle.jsf.help.source=/public/help/\t component.demoiselle.jsf.help.closeimage=/jsf/help/resource/close.jpg component.demoiselle.jsf.js.keyboardhotkeysmanager=/jsf/js/resource/ke yboardhotkeysmanager.js component.demoiselle.jsf.js.browserbackbuttonmanager=/jsf/js/resource/ browserbackbuttonhandler.js component.demoiselle.jsf.js.logouthandler=/jsf/js/resource/logouthandl er.js log4j.properties: log4j.rootcategory=info, stdout log4j.appender.stdout=org.apache.log4j.consoleappender log4j.appender.stdout.layout=org.apache.log4j.patternlayout log4j.appender.stdout.layout.conversionpattern=%d{dd/mm/yyyy hh:mm:ss} %c %M%n%-5p: %m %n Edite o arquivo web.xml (/src/main/webapp/web-inf/), conforme o exemplo abaixo: <?xml version="1.0" encoding="utf-8"?> <web-app xmlns:xsi=" xmlns=" xmlns:web=" xsi:schemalocation=" version="2.5"> <display-name>escola</display-name> <!-- JSF Configuration --> <servlet> <servlet-name>faces Servlet</servlet-name> <servlet-class>javax.faces.webapp.facesservlet</servletclass> </servlet> <servlet-mapping> <servlet-name>faces Servlet</servlet-name> 10 Modificado em: 07/05/10 13:55:04

11 <url-pattern>*.jsf</url-pattern> </servlet-mapping> <context-param> <param-name>javax.faces.state_saving_method</param-name> <param-value>server</param-value> </context-param> <!-- Rich Faces Configuration--> <filter> <display-name>ajax4jsf Filter</display-name> <filter-name>ajax4jsf</filter-name> <filter-class>org.ajax4jsf.filter</filter-class> </filter> <filter-mapping> <filter-name>ajax4jsf</filter-name> <servlet-name>faces Servlet</servlet-name> <dispatcher>forward</dispatcher> <dispatcher>request</dispatcher> <dispatcher>include</dispatcher> <dispatcher>error</dispatcher> </filter-mapping> <!-- Facelets Configuration--> <context-param> <param-name>javax.faces.default_suffix</param-name> <param-value>.xhtml</param-value> </context-param> <!-- Weblets Configuration--> <context-param> <param-name>weblets.config_files</param-name> <param-value>weblets-config.xml</param-value> </context-param> <servlet> <servlet-name>weblets Servlet</servlet-name> <servlet-class> net.java.dev.weblets.webletsservlet </servlet-class> </servlet> <servlet-mapping> <servlet-name>weblets Servlet</servlet-name> <url-pattern>/weblets/*</url-pattern> </servlet-mapping> <!-- MyFaces Configuration--> <filter> <filter-name>myfacesextensionsfilter</filter-name> <filter-class> org.apache.myfaces.webapp.filter.extensionsfilter </filter-class> <init-param> <param-name>uploadmaxfilesize</param-name> <param-value>20m</param-value> </init-param> </filter> 11 Modificado em: 07/05/10 13:55:04

12 <filter-mapping> <filter-name>myfacesextensionsfilter</filter-name> <servlet-name>faces Servlet</servlet-name> </filter-mapping> <filter-mapping> <filter-name>myfacesextensionsfilter</filter-name> <url-pattern>/faces/myfacesextensionresource/*</url-pattern> </filter-mapping> <filter-mapping> <filter-name>myfacesextensionsfilter</filter-name> <url-pattern>*.jsf</url-pattern> </filter-mapping> <!-- Demoiselle Configuration--> <listener> <listenerclass>br.gov.framework.demoiselle.web.init.webinitializationservletconte xtlistener</listener-class> </listener> <listener> <listenerclass>br.gov.framework.demoiselle.web.security.websecurityservletrequest Listener</listener-class> </listener> <listener> <listenerclass>br.gov.framework.demoiselle.web.transaction.webtransactionservletr equestlistener</listener-class> </listener> <servlet> <servlet-name>webredirectservlet</servlet-name> <servletclass>br.gov.framework.demoiselle.web.redirect.webredirectservlet</servl et-class> </servlet> <servlet-mapping> <servlet-name>webredirectservlet</servlet-name> <url-pattern>/redirect</url-pattern> </servlet-mapping> <!-- Demoiselle Scheduler Configuration--> <listener> <listenerclass>br.gov.component.demoiselle.scheduler.web.schedulerinitializations ervletcontextlistener</listener-class> </listener> <!-- Pages Configuration --> <welcome-file-list> <welcome-file>index.jsp</welcome-file> </welcome-file-list> <welcome-file-list> <welcome-file>index.jsp</welcome-file> </welcome-file-list> 12 Modificado em: 07/05/10 13:55:05

13 <error-page> <error-code>404</error-code> <location>/public/pages/error/404.jsp</location> </error-page> <error-page> <error-code>500</error-code> <location>/public/pages/error/500.jsp</location> </error-page> <error-page> <exception-type>java.lang.throwable</exception-type> <location>/public/pages/error/global.jsp</location> </error-page> <!-- Security Configuration --> <security-constraint> <web-resource-collection> <web-resource-name>private</web-resource-name> <description>private resources</description> <url-pattern>/private/*</url-pattern> </web-resource-collection> <auth-constraint> <role-name>*</role-name> </auth-constraint> </security-constraint> <login-config> <auth-method>form</auth-method> <form-login-config> <form-loginpage>/public/pages/security/login.jsp</form-login-page> <form-error-page>/public/pages/error/acess.jsp</formerror-page> </form-login-config> </login-config> <security-role> <role-name>*</role-name> </security-role> </web-app> Na pasta /src/main/webapp/web-inf/, crie o arquivo faces-config.xml conforme o exemplo abaixo: <?xml version="1.0" encoding="utf-8"?> <faces-config xmlns=" xmlns:xsi=" xmlns:xi=" xsi:schemalocation=" version="1.2"> <!-- Facelets Configuration--> <application> <view-handler>com.sun.facelets.faceletviewhandler</viewhandler> </application> </faces-config> 13 Modificado em: 07/05/10 13:55:05

14 Crie as novas pastas em /src/main/webapp private/pages public/pages public/templates Na pasta /src/main/webapp/private/pages, crie a página default.xhtml: <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" " <html xmlns=" xmlns:ui=" xmlns:h=" xmlns:f=" xmlns:rich=" xmlns:serpro=" <ui:composition template="/public/templates/default.xhtml"> <meta http-equiv="content-type" content="text/html; charset=utf-8" /> <ui:define name="body"> <h3>escola</h3> </ui:define> </ui:composition> </html> Na pasta /src/main/webapp/public/pages, crie as pastas: error security Na pasta /src/main/webapp/public/pages/error, crie as páginas: 404.jsp <%@ page contenttype="text/html; charset=utf-8" %> <%@ page iserrorpage="true"%> 14 Modificado em: 07/05/10 13:55:05

15 <html lang="pt-br"> <head> <title>erro 404</title> </head> <body marginheight="0" marginwidth="0" bottommargin="0" leftmargin="0" rightmargin="0" topmargin="0"> <br/> Error Page: 404 <br/> </body> </html> 500.jsp page contenttype="text/html; charset=utf-8" %> page iserrorpage="true"%> <html lang="pt-br"> <head> <title>erro 500</title> </head> <body marginheight="0" marginwidth="0" bottommargin="0" leftmargin="0" rightmargin="0" topmargin="0"> <br/> Error Page: 500 <br/> </body> </html> acess.jsp page contenttype="text/html; charset=utf-8" %> page iserrorpage="true"%> <html lang="pt-br"> <head> <title>erro de Acesso</title> </head> <body marginheight="0" marginwidth="0" bottommargin="0" leftmargin="0" rightmargin="0" topmargin="0"> <br/> Error Page: Acess <br/> </body> </html> global.jsp page contenttype="text/html; charset=utf-8" %> page iserrorpage="true"%> <html lang="pt-br"> <head> <title>erro Global</title> </head> <body marginheight="0" marginwidth="0" bottommargin="0" leftmargin="0" rightmargin="0" topmargin="0"> <br/> Error Page: Global <br/> 15 Modificado em: 07/05/10 13:55:06

16 </body> </html> Na pasta /src/main/webapp/public/pages/security, crie a página: login.jsp <%@ page contenttype="text/html; charset=utf-8" %> <html lang="pt-br"> <head> <title>login</title> </head> <body marginheight="0" marginwidth="0" bottommargin="0" leftmargin="0" rightmargin="0" topmargin="0"> <form method="post" action="j_security_check" > <br/> <table align="center"> <tr> <td> <label for="txt_username">login:</label> </td> <td> <input id="txt_username" type="text" name="j_username" tabindex="1" title="informe o usuario"/> </td> </tr> <tr> <td> <label for="txt_password">senha:</label> </td> <td> <input id="txt_password" type="password" name= "j_password" tabindex="2" title="informe a senha do usuario"/> </td> </tr> <tr> <td colspan="2" align="right"> <input type="submit" value="login" tabindex="3" /> </td> </tr> </table> </form> </body> </html> Na pasta /src/main/webapp/public/pages/templates, crie a página: default.xhtml <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" " <html xmlns=" lang="pt-br" xmlns:ui=" xmlns:h=" xmlns:f=" 16 Modificado em: 07/05/10 13:55:06

17 xmlns:rich=" xmlns:t=" xmlns:a4j=" xmlns:demoiselle=" <head> <title><ui:insert name="title">escola</ui:insert></title> </head> <body> <f:view> <demoiselle:usejs all="true"/> <demoiselle:useskin/> <table width="100%" border="0" cellpadding="0" cellspacing="0" summary="seja bem vindo" > <tr> <td> <ui:insert name="navegation"> <rich:panel styleclass="richpanelstyleclass" bodyclass="richpanelbodyclass" headerclass="richpanelheaderclass"> <h:outputtext value="seja bem vindo" /> <h:outputtext value="" /> </rich:panel> </ui:insert> </td> </tr> <tr> <td> <ui:insert name="menu"> <rich:toolbar height="34" itemseparator="line" styleclass="richpanelbodyclass" > <h:form> <rich:toolbargroup > <h:commandlink value="menu_01" title="menu_01" onclick="javascript:alert('menu_01')" /> </rich:toolbargroup> <rich:toolbargroup > <h:commandlink value="menu_02" title="menu_02" onclick="javascript:alert('menu_02')" /> </rich:toolbargroup> </h:form> </rich:toolbar> </ui:insert> </td> </tr> <tr> <td> <ui:insert name="message"> <h:messages globalonly="true" errorclass="errorfatalmessage" fatalclass="errorfatalmessage" infoclass="infomessage" warnclass="warnmessage" showsummary="true" showdetail="false" /> </ui:insert> </td> 17 Modificado em: 07/05/10 13:55:07

18 </tr> <tr> <td> <ui:insert name="body"> </ui:insert> </td> </tr> </table> </f:view> </body> </html> Na pasta /src/main/webapp/, crie a página: index.jsp: <%@ page contenttype="text/html; charset=utf-8" %> <%response.sendredirect("./private/pages/default.jsf");%> 18 Modificado em: 07/05/10 13:55:07

19 1. Adicionando características do Wizard Demoiselle ao projeto: Clique com o botão direito sobre o projeto. Selecione o menu Demoiselle; Selecione: Adicionar/Remover Características Demoiselle; O projeto receberá o ícone do Framework Demoiselle. Converter o projeto para uso do AspectJ: Clique com o botão direito sobre o projeto. Selecione: AspectJ Tools Convert to AspectJ Project 19 Modificado em: 07/05/10 13:55:07

20 Configurar o path para AspectJ, pois será necessário para os testes unitários com Junit: Clique com o botão direito sobre o projeto. Selecione: AspectJ Tools Configure AspectJ Build Path... Na aba Aspect Path, use o botão Add JARs.. e inclua as libs: demoiselle-web demoiselle-authorization 20 Modificado em: 07/05/10 13:55:08

21 2. Abra a View Servers (Window Show View Servers). Ela deve listar o servidor tomcat conforme abaixo: 3. Inclusão do projeto escola ao Plugin Tomcat: Adicione o projeto escola ao servidor Tomcat: 21 Modificado em: 07/05/10 13:55:08

22 4. Configurando a autenticação da aplicação via Realm padrão do tomcat. No próprio eclipse abra o arquivo tomcat-users.xml localizado dentro do projeto Servers Crie os seguintes usuários e papéis conforme exemplo abaixo <tomcat-users> <role rolename="role_aluno"/> <role rolename="role_professor"/> <role rolename="role_administrador"/> <user username="aluno" password="aluno" roles="role_aluno"/> <user username="professor" password="professor" roles="role_professor"/> <user username="admin" password="admin" roles="role_administrador"/> </tomcat-users> Inicie o Tomcat e verifique se aplicação foi carregada corretamente. Entre na url A página de login deverá ser exibida conforme abaixo: 22 Modificado em: 07/05/10 13:55:08

23 Autentique-se com o usuário admin e senha admin. A tela inicial da aplicação deverá ser exibida conforme abaixo. 23 Modificado em: 07/05/10 13:55:08