-
Notifications
You must be signed in to change notification settings - Fork 1
/
Copy pathREADME.markdown~
127 lines (86 loc) · 6.72 KB
/
README.markdown~
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
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](http://www.triadworks.com.br).
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)](http://www.eclipse.org/downloads/) 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](https://github.com/rmpestano/conventions-issuetracker/blob/master/etc/snippets/config/context.xml);
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](http://vraptor.caelum.com.br/en) from Caelum;
Information ++
----------------
**TriadWorks**
- http://www.triadworks.com.br
- http://www.triadworks.com.br/servico.html
**Rafael Ponte (the JSF and Spring guy)**
- [blog](http://www.rponte.com.br)
- Twitter [@rponte](http://twitter.com/#!/rponte)
**Rafael Pestano (the CDI adventurer)**
- [blog](http://rpestano.wordpress.com/)
- Twitter [@realpestano](http://twitter.com/#!/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.x)`, `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](http://www.triadworks.com.br).
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)](http://www.eclipse.org/downloads/) 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](https://github.com/rmpestano/conventions-issuetracker/blob/master/etc/snippets/config/context.xml)
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](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](http://vraptor.caelum.com.br/en) da Caelum;
Mais informações
----------------
**TriadWorks**
- http://www.triadworks.com.br
- http://www.triadworks.com.br/servico.html
**Rafael Ponte**
- Meu [blog](http://www.rponte.com.br)
- Meu Twitter [@rponte](http://twitter.com/#!/rponte)
**Rafael Pestano**
- Meu [blog](http://rpestano.wordpress.com/)
- Meu Twitter [@realpestano](http://twitter.com/#!/realpestano)
- framework caseiro usado neste projeto (http://conventions.github.io/home).
**JSF Group**
- https://groups.google.com/group/javasf/