Criação do Ambiente de Compilação Projeto ApontamentoGeopx Server - GeopixelDesenvolvimento/ApontamentoHoras-Server GitHub Wiki
Para este projeto foi necessário a instalação dos softwares abaixo:
Os mesmos foram escolhidos de acordo com a arquitetura de máquina que eu estou utilizando no caso o é um desktop com o sistema operacional Windwos7 64 bits Após a instalação dos softwares acima será necessário a configuração dos mesmo conforme os passos abaixo;
##Configuração do Java
- Abra o prompt de comando (CMD);
- digite o comando echo %JAVA_HOME% O retorno deste comando deverá ser algo parecido com este: C:\Program Files\Java\jdk1.8.0_60. Caso o JAVA_HOME não esteja devidamente configurado, siga os passo abaixo:
- No Iniciar do Windows selecione Iniciar Windows-Computador e com o botão da direita sobre o Computador, selecione Propriedades.
- Selecione Configurações avançadas do sistema
- Selecione o botão Variáveis de ambiente
- Selecione "Novo"
- Em Nome da variável entre JAVA_HOME
- Em Valor da variável entre C:\Program Files\Java\jdk1.8.0_60, ou o nome do diretório onde o Java JDK foi instalado.
- Selecione o botão OK
Após realizadas as configurações execute novamente o comando echo %JAVA_HOME%, caso o retorno não seja parecido com exemplo citado acima reinicie o equipamento, dessa forma as configurações toraram-se concretas.
##Configuração do Jersey
Jersey é um framework de código fonte aberto sob a licença CDDL JAX-RS(JSR311), é uma implementação de referência para construir serviços web RESTFULL. Mas também é mais que do que uma implementação de referência, o Jersey fornece APIs e pontos de extensão (SPIs) adicional para que os desenvolvedores possam estender o Jersey de acordo com suas necessidades. O projeto apontamento de Horas utiliza o serviço REST do framework Jersey. Este framework é distribuído pelo Maven o que torna sua configuração mais fácil de configurar, porem será necessário somente o download de todos os jars.
- Entre no Eclipse e em uma workspace vazia selecione o botão direito do mouse e então a opção New-Project.
- Selecione Maven-Maven Project para criar um projeto novo com Maven.
- Selecione Next e Next novamente.
Agora selecione o tipo de projeto Maven que você deseja criar, selecionando um Archetype. Archetype é simplesmente uma template, um projeto pré-configurado, que você pode utilizar para criar o seu próprio projeto. Então vamos criar um projeto pré-configurado em Jersey para facilitar a criação do ambiente. Digite no filtro Jersey Selecione a template jersey-quickstart-webapp
Dica: Se você não ver esta opção é por que está template (Archetype) não está registrada. Para isso selecione o botão
*Add Archetype* e preencha na caixa de diálogo que aparecerá a opção:
Archetype Group Id: org.glassfish.jersey.archetypes
Archetype Artifact Id: jersey-quickstart-webapp
Archetype Version: 2.22
2.22 é a versão atual quando foi escrita esta documentação.
Selecione OK, para registrar esta template. Agora você irá localizar a mesma.
Agora você está pronto para cadastrar os detalhes do seu novo projeto.
Na nova caixa de diálogo que aparece entre:
Group Id: br.com.geopixel
Artifact Id: ApontamentoGeopx
Selecione Finish. Você vai perceber no canto inferior direito que está sendo realizado o download automático de tudo. Pronto agora você tem um projeto REST pronto e funcionando. Ainda o mesmo está sem o código que desenvolvemos. O próximo passo é baixar este código e juntar com o projeto.
Obs.:. No projeto ApontamentoGeopx-Server na pasta Java Resources apenas a pasta src/main/Java foi deixada, pois as demais não iram ser utilizadas deixando o projeto mais limpo e sem opção de conflitos internos.
##Configuração do Servidor Web com Apache Tomcat
A primeira coisa é fazer o download. A versão que utilizamos foi a 7.0 e está disponível para download em seu site oficial. Como estamos utilizando Windows 7 64 bits, selecionamos a versão 64-bit Windows zip. Depois que realizar o download, descompacte o arquivo e coloque todos os arquivos no diretório que você deseja. Nós colocamos no diretório** C:\apache-tomcat-7.0.** Embaixo deste diretório existem as pastas bin, conf, lib, etc. Verifique se está correto. Depois apague o arquivo zip. Após o download do Apache Tomcat iremos inserir o serviço ao projeto ApontamentoGeopx.
- Entre no Eclipse vá na barra de ferramentas, opção New – other
- Na caixa de pesquisa digite palavra chave Server;
- Escolha a opção Server – next;
- Selecione a versão do Tamcat que você optou;
- Na opção Server´s host name digite: localhost;
- Na opção Server name digite: Tomcatv7.0 Server at localhost – next;
- Selecione o projeto-Server e adicione a caixa de Configured, depois finish
##Configuração da porta de acesso
O Tomcat está configurado para funcionar na porta 8080, alguns roteadores podem já utilizar esta porta, o que pode gerar uma indisponibilidade de acesso a sua página, quando acessado de um computador de fora de sua rede interna. Na parte inferior do projeto só seu projeto haverá uma barra de menus e nela terá uma aba Sever, será nesta aba que o servidor configurado será mostrado, de um duplo click no servidor configurado e será mostrado uma tela de configuração do Tomcat. Na opção Ports siga as configurações abaixo:
- Tomcat admin port: 8006
- HTTP/1.1: 8081
- AJP/1.3: 8010
Após alterada as configurações click na opção salvar para que as mesmas se tornem validas
##Configuração MYSQL
A configuração do mysql em projetos do tipo maven é um pouco diferente da configuração padrão que você baixa uma versão jar do conector do mysql e acrescenta no projeto, para que a configuração seja válida é necessário acrescentar a dependência abaixo no arquivo pom.xml que fica na pasta Java Resources – src/main/Java:
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>5.1.38</version>
</dependency>
Após acrescentado esta dependência no arquivo acima citado clique com o botão direto do mouse no projeto-Server - opção Run As – 6 Maven Clean, após realizada a limpeza do maven cline novamente com o botão direito do mouse no projeto-server - opção – 8 maven Install. Feito estes procedimentos a dependência do conector mysql será instalada ao projeto.