JSF Issue Tracker Project

<<<<<<<<<<<<<< ENGLISH >>>>>>>>>>>>>

This project is a simple issue tracker using the following tecnologies: JSF 2.1.x, Primefaces(4.0), CDI(Weld 2.2.x), CODI(1.0.6), Conventions(1.3.1) and Hibernate 4.1.4 with the intention of showing some features of each tecnologies and how to integrate them in a real project.

Its (yet another version of) another version of the project https://github.com/rponte/jsf-issuetracker-project which is built during the courses and trainings of JSF 2, Spring and Hibernate lead by TriadWorks.

If you have any doubt or interest about TriadWorks, get in touch with them at (http://www.triadworks.com.br/contatos.html)

Configuring project database.

By default the project is configured to run in Postgresql database, but as its about an ORM based app it should run in any other SQL based datatabse.

Basic steps;

1. Import the project in Eclipse Java EE IDE for Web Developers (Indigo) or superior;
2. add a JDBC Driver which can be found at /WebContent/WEB-INF/lib if you dont intend to use PostgreSQL;
3. create the datasource - in tomcat add an entry in the file TOMCAT_HOME/conf/context.xml (an example can be found at folder etc/snippets/config/context.xml or here;
4. create the database issuetracker with your tool of choice - like eg: PGAdmin in postgres
5. deploy the app in Apache Tomcat 7.x and start tomcat;
6. Access the application at [http://localhost:8080/issuetracker](http://localhost:8080/issuetracker];
7. login with user:admin, pass:admin (first access this user is created);

Generating the .war

1. To generate the .war of issuetracker just run the ant script (build.xml) from ecplise or in command line;

    $ ant
   

2 - after the execution the ant script will place the generated .war at /target/war/snapshot/issuetracker.war;

3 - also you can execute the Run As command in ecplise by right clicking in the project (instead of generating the .war and deploying it in tomcat);

Additional information

• the database schema , issuetracker, will be created by Hibernate at first application startup time;
• in /etc/lib directory you find all libraries and dependencies of each framework;
• in /etc/lib/jdbc-drivers folder you'll find some JDBC drivers like MySQL, PostgreSQL and Oracle;
• in /etc/mockups folder you'll find the screens prototypes.
• as im very bad designer the application css was copied(and slighted modified) from vraptor-blank-project from Caelum;

Information ++

TriadWorks

• http://www.triadworks.com.br
• http://www.triadworks.com.br/servico.html

Rafael Ponte (the JSF and Spring guy)

• blog
• Twitter @rponte

Rafael Pestano (the CDI adventurer)

• blog
• Twitter @realpestano
• Homegrow framework used in this project (http://conventions.github.io/home).

JSF Group (the group where we spread our crazy ideas)

• https://groups.google.com/group/javasf/

<<<<<<<<<<<<<< Português >>>>>>>>>>>>>

Projeto simples de uma aplicação de Issue Tracker com JSF 2.1.x, Primefaces(4.0), CDI(Weld 2.2.2), CODI(1.0.6), Conventions(1.3.1) e Hibernate 4.1.4 com o objetivo de explanar as principais features de cada tecnologia e como integra-las de maneira produtiva em um projeto real.

Esta é mais uma versão do projeto https://github.com/rponte/jsf-issuetracker-project que é construído durante os cursos e treinamentos de JSF 2, Spring e Hibernate ministrados pela TriadWorks.

Caso tenha interesse ou alguma dúvida sobre os cursos e treinamentos da TriadWorks, entre em contato com (http://www.triadworks.com.br/contatos.html).

Configurando o projeto e banco de dados.

Por padrão o projeto está configurado para o banco de dados PostgreSQL, mas já que se trata de uma aplicação com Hibernate, você pode simplesmente configura-lo para trabalhar com qualquer outro banco.

Os passos básicos são:

1. Importe o projeto no Eclipse Java EE IDE for Web Developers (Indigo) ou superior;
2. Adicione o JDBC Driver no diretório /WebContent/WEB-INF/lib caso não pretenda utilizar o PostgreSQL;
3. crie o datasource - no tomcat adicione uma entrada no arquivo TOMCAT_HOME/conf/context.xml, um exemplo é encontrado na pasta etc/snippets/config/context.xml ou aqui
4. Crie o banco de dados issuetracker com a ferramenta de sua preferência (como o PGAdmin, no caso do PostgreSQL);
5. Faça o deploy no Apache Tomcat 7.x e inicie o servidor;
6. Acesse a aplicação através da url http://localhost:8080/issuetracker ;
7. Faça o login com o usuário admin senha admin(no primeiro acesso esse usuario é criado);

Gerando .war da aplicação

1. Para gerar o .war da aplicação basta executar o ant script (build.xml) no Eclipse ou na linha de comando:

    $ ant
   

2. Após ter executado o ant script o .war será gerado em /target/war/snapshot/issuetracker.war;

Informações adicionais

• O schema do banco de dados, issuetracker, será criado pelo Hibernate ao iniciar a aplicação pela primeira vez;
• Dentro do diretório /etc/lib você encontra todas as libs e dependências organizadas de cada framework;
• Dentro do diretório /etc/lib/jdbc-drivers é possível encontrar alguns drivers já disponíveis, como MySQL, PostgreSQL e Oracle;
• Dentro do diretório /etc/mockups você encontra os mockups (esboços) das telas da aplicação;
• Como eu sou um péssimo Web designer, o design da aplicação foi copiado (e levemente modificado) do projeto vraptor-blank-project da Caelum;

Mais informações

TriadWorks

• http://www.triadworks.com.br
• http://www.triadworks.com.br/servico.html

Rafael Ponte

• Meu blog
• Meu Twitter @rponte

Rafael Pestano

• Meu blog
• Meu Twitter @realpestano
• framework caseiro usado neste projeto (http://conventions.github.io/home).

JSF Group

• https://groups.google.com/group/javasf/