terça-feira, 2 de novembro de 2010

Configurando o ZK

Neste artigo irei abordar a configuração do Eclipse e o ZK Studio, plugin pro Eclipse, para trabalhar com o ZK.

Ferramentas necessárias:
  1. JDK 6
  2. Eclipse Helios Java EE
  3. Tomcat 7
  4. Algum browser, recomendo o Firefox.
  5. ZK 5.0.5, versão da data deste artigo.
  6. ZK Studio
Após a instalação do JDK, baixe o Eclipse, e descompacte no local que preferir. 
No meu caso foi escolhido o caminho C:\Java\eclipse, com worspace em C:\Java\workspace.
Feito isso, baixe o tomcat 7 e descompacte para C:\Java\tomcat.
Abra o Eclipse. No menu navegue para Window -> Show View -> Other... , 
ou no canto inferior esquerdo clique no botão "Show View as fast view", e procure por Servers.
Com a janela aberta, clique com o botão direito dentro da janela e vá para New -> Server.
Nessa janela escolha o Tomcat v7.0 Server e clique next.

Na Janela seguinte, procure pelo diretório do Tomcat 7 e clique em finish.
Feito isso vamos baixar o ZK Studio. navegue até Help -> Install New Software....
Nessa Janela voce clicar em Add..., para adicionar uma nova url de busca de plugins para o Eclipse.
Em Name, coloque o nome de ZK Studio e Location o url para download descrita no site.
Feito isso, o Eclipse irá buscar o plugin. Escolha o plugin ZK Studio e instale.

Antes de criar um projeto vá em Window -> Preferences, escolha o item ZK e depois ZK Packages. Voce notará que a versão utilizada é a 3.6.3. Baixe a última versão do ZK, na janela anterior escolha clique em Add File/ Directory..., depois em File Import. Escolha o local onde está o arquivo .zip da versão do ZK e depois em finish. Marque a opção da versão mais nova. O ZK Studio não atualiza a versão do ZK sozinho, então a cada nova versão que voce deseja instalar voce deve realizar esse procedimento, É permitido que voce tenha projetos ZK com versão diferentes basta voce configurar cada projeto separadamente. A cada novo projeto, o Eclipse irá gerar com a versão escolhida aqui
Clique em apply e depois finish.
Voce pode notar que no Project Explorer existe as 2 versões das libs:
Feito isso, vamos criar um novo projeto ZK. Vá em File -> New -> Other... e escolha ZK Project.
O nome do nosso projeto vai ser HelloWorld:
Note que ele mostra a versão do ZK utilizada e o servidor a ser utilizado, podendo ser configurado antes de cada projeto.
Lembre-se de selecionar a versão 2.5 do Dynamic web module, e clique em Finish.
Feito isso vamos analisar melhor o projeto gerado:
Em Java Resources ficam as classes Java, arquivos XML, arquivos texto, etc.
Dentro de WebContent fica os arquivos que irão serão responáveis pela vista como os arquivos ZUL. No projeto gerado temos 2 : index e o timeout.
Quando um url é enviada para o servidor, o servidor irá processar e devolver o arquivo index por padrão, mas isso pode ser configurado para enviar outro arquivo. Como estamos trabalhando com uma aplicação AJAX, existe um tempo de resposta para a pagina. Quando tenta-se acessar um componente e é gerado um evento mas o tempo de resposta acabou, o servidor processa e devolve a pagina timeout com uma resposta, também podemos configurar a mensagem de timeout e o tempo de resposta.
Nessa pasta podemos ter outras pastas, contendo outros arquivos .zul, .html, .css, .js, imagens, entre outras coisas.
Dentro da pasta WEB-INF temos todas as libs usadas no projeto e os arquivos web.xml e zk.xml, usados para configurar nossa aplicação. Se precisarmos adicionar alguma lib extra, basta adicionar na pasta lib.

Agora vamos iniciar a aplicação. COm o botão direito na projeto, seleciona Run As -> Run on Server.
Irá aparecer uma tela pra voce escolher o servidor o qual voce deseja rodar a apicação. No nosso caso o tomcat já está selecionado, então basta clicar em Finish. Voce pode marcar uma opção que permite que ele sempre rode dentro do servidor selecionado, se preferir.
Feito isso temos, nossa primeira aplicação funcioando:

ATUALIZAÇÃO - 03/12/2010
Na imagem de criação de projeto ZK aparece um warning dizendo que precisa do JDK instalado.
Para resolver isso basta ir em Window->Preferences e depois navegue para Java -> Installed JREs.
Escolha a versão da jre instalada e clique em edit. Em JRE home basta colocar o caminho do JDK, no meu caso está em C:\Java\jdk1.6.0_20. Se quiser renomear o nome de jre para jdk fique a vontade.
Feito isso não vai mais aparacer aquele warning.



Nenhum comentário:

Postar um comentário