AGES 2017/2

Problemas para criar o ambiente em seu computador pessoal?

Como já deve ter percebido, executar o projeto no computador quando ainda não se está 100% ambientado com a arquitetura e as tecnologias não é uma tarefa trivial. Pensando nisto, separe uma xícara de café, se acalme e leia este tutorial que visa explicar como configurar seu computador pessoal para executar esta tarefa e nunca mais ter dor de cabeça. Este tutorial foi feito utilizando Windows, logo alguns passos podem ser diferentes dependendo do sistema operacional que utilizas.

Istalando o JDK

Como em qualquer projeto que utiliza Java como uma das tecnologias, faz-se necessário ter o Java Development Kit (JDK) instalado no ambiente, logo o primeiro passo foi o download e a instalação do JDK 1.8. O download pode ser feito em: http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html?ssSourceSiteId=otnpt

Ao executar o instalador a seguinte tela será exibida:

Os passos de instalação são simples, como geralmente é utilizando o instalador do software, basta ir clicando em “Next” até que o processo seja concluído. É importante ressaltar que recomenda-se que não seja alterado o diretório destino do JDK a fim de garantir que a IDE o ache automaticamente posteriormente, caso contrário o processo de configuração do ambiente pode se tornar um tanto mais complexo.

Pronto!

O Tomcat

Baixe o arquivo .zip do Tomcat 8.0 referente a arquitetura de seu processador, o download pode ser feito em: [https://tomcat.apache.org/download-80.cgi]

Extraia os arquivos para um diretório em seu computador. Por costume, quando há a necessidade de configurar uma nova maquina, eu crio um diretório no disco “C” onde irei armazenar os softwares do ambiente, neste caso foi “C:\Softwares”, então eu sei que a partir da extração meu Tomcat está locado no seguinte caminho C:\Softwares\apache-tomcat-8.0.46.

SGDB - MySQL

Faça o download do SGBD MySQL que é o utilizado em nosso projeto, ele está disponível no seguinte link: https://dev.mysql.com/downloads/windows/installer/5.7.html

Se você optou pela forma mais fácil de instalação do MySQL, neste passo ele verificará dentre os softwares de seu Sistema Operacionais quais são os requisitos faltantes para que a instalação ocorra com sucesso. Se você optou no momento do download pelo instalador que tem cerca de 300MB alguns dos instaladores foram baixados junto, logo serão executados automaticamente, bastando clicar em “next”, “next” e “next”...

Essas instalações se repetirão até que o Sistema Operacional esteja apto a receber o MySQL Server e os componentes que foram selecionados anteriormente dependendo da forma de instalação escolhida. Depois de fazer todas as instalações necessárias, o botão “next” finalmente será habilitado, então “Let’s go!”.

A seguinte janela será exibida com os instaladores, clique em “Execute”.

Como nos computadores da AGES, inclua para o usuário root a senha “senha”

Next:

Na tela abaixo clique em execute:

Finish:

Caso haja algum problema na instalação, indico que verifique na documentação do MySQL que está disponível no site: [https://dev.mysql.com/doc/refman/5.7/en/mysql-installer.html]

Um problema bastante comum, é quando em sistema de 64 bits instalamos o Visual C++ Redistributable 2013 na pasta relativa ao x64 e este instalador acaba não reconhecendo o diretório, neste caso o MySQL Server não será instalado e no log será descrito o seguinte motivo: “1: This application requires Visual Studio 2013 Redistributable. Please install the Redistributable then run this installer again.” Neste caso faça o download da versão 32 bits (x86) do site da Microsoft e o Instale na máquina.

Execute o MySQL Workbench 6.3 CE, provavelmente ele estará acessível em Iniciar > Todos os Programas > MySQL (se estiver usando o Windows 7).

Clique sobre Local Instance MySQL57 e digite a senha do usuário “root”, que neste caso é “senha”.

Clicando em Server > Server Status será possível verificar se o servidor local foi corretamente configurado e iniciado.

A IDE - Eclipse Oxygen

Deixando o banco de dados um pouco, agora acesse o site do Eclipse e faça download da versão correspondente a sua arquitetura de processador, o utilizado na Ages é o Oxygen. O download pode ser feito em: http://www.eclipse.org/downloads/

Após o download, basta extrair os arquivos para um diretório em seu computador, como feito com o Tomcat, extraí para “C:\Softwares”.

Confirgurando o Tomcat no Eclipse

Feita extração, é hora de executar e configurar a IDE, então mãos na massa! Acesse o diretório onde os arquivos foram extraídos, execute o eclipse e inclua a Workspace. Lembra do Tomcat que baixamos antes? Então, esta é a hora que diremos a IDE que ele existe e que iremos utiliza-lo! Após o Eclipse carregar, navegue até “Window > Preferences > Server > Server Runtime Enviroments” a tela abaixo deve ser exibida:

Clique em “Add”:

Selecione Apache Tomcat v8.0, marque “Create a new local server” e clique em “Next. Nesta tela clique em Browse para indicar onde o Tomcat foi extraído, no meu caso “C:\Softwares\apache-tomcat-8.0.46”

Clique em “Finish” e voilá (VOA LÁ) a IDE já sabe que o Tomcat existe! Quando a janela abaixo for exibida clique em “apply and close”

Importar o Projeto do GitLab

Agora vamos importar nosso projeto para o Eclipse, então dentro do packge explorer, clique com o botão direito do mouse e depois em “import”.

Clique em Git > Projects from Git

Abra seu navegador e e acesse o Git do projeto em http://www.tools.ages.pucrs.br/projetos/Biblioteca e clique para copiar a URL do fonte (“Copy URL to clipboard”):

De volta ao eclipse, na janela aberta clique em “Clone URI” e depois em “next”

Automaticamente o eclipse reconhecerá a URL que foi copiada da página do Git e trará o formulário preenchido, neste passo você pode usar suas credenciais, mas não é obrigatório. Clique em “Next”:

Na janela que foi exibida, deixe selecionada somente a branch “Dev” e clique em “next”:

Selecione o diretório destino do projeto e clique em “Next”:

Após esta tela carregar, deixe marcada a primeira opção e clique em “Next”:

Agora “Finish him”:

A partir disto, o projeto já estará importado no Eclipse, após ele terminar de carregar a Workspace, o projeto será exibido no Package Explorer com alguns erros, fique calmo!

Clique com o botão direito do mouse sobre o projeto, depois Maven e Update Project:

O projeto será atualizado e os erros sumirão!

Criando e Populando o Banco de Dados

Agora Localize dentro do diretório “src” o package br.com.biblioteca.db e nele o arquivo BIBLIOTECA_SCRIPT.sql, abra-o e copie todo seu conteúdo para o Workbench como mostrado abaixo:

Clique no “Raio” que dica na parte superior para que as tabelas sejam criadas:

Faça o mesmo com o arquivo “ BIBLIOTECA_POPULACAO_SRIPT” para que as tabelas sejam populadas:

Executando o Projeto

Banco criado, tabelas populadas, servidor configurado, o que falta? Executar a aplicação! Clique com o botão direito do mouse sobre o projeto, depois em Run As > Run on Server.

Selecione o server que criamos anteriormente e clique em “Next”:

Clique em “Finish”:

Pode demorar um pouco e dependendo das configurações de segurança de sua máquina pode ser que o Sistema Operacional peça algumas permissões, conceda-as e tcharammmmm:

Só para testar a conexão com o banco, peque um usuário qualquer e senha do banco de dados e tente o acesso, neste caso usamos "[email protected]" e a senha “adm”:

Pronto, o projeto está funcionando!

Se perdeu em algum passo? Ficou curioso em relação a algo? Procure um dos colegas da Ages que teremos o prazer em ajudar!

Ahhh! Você pode configurar o Eclipse para abrir o projeto em seu navegador favorito, mas dai isto é por sua conta ;D