WikiStart

Version 29 (Oliver Gierke, 05/15/2009 02:49 pm)

1 26 Oliver Gierke
{{>toc}}
2 26 Oliver Gierke
3 20 Oliver Gierke
h1. Hades
4 21 Oliver Gierke
5 20 Oliver Gierke
h2. Overview
6 21 Oliver Gierke
7 1
Hades is a utility library to work with Data Access Objects implemented with Spring and JPA. The main goal is to ease the development and operation of a data access layer in applications.
8 1
9 23 Oliver Gierke
To get a first impression of what the library can do for you, you should read the [[Rationale]]. A good next step might be reading through the "reference documentation":http://redmine.synyx.org/attachments/download/17.
10 1
11 19 Oliver Gierke
h2. Features
12 11 Oliver Gierke
13 19 Oliver Gierke
* Implementation of CRUD methods for JPA Entities
14 19 Oliver Gierke
* Transparent triggering of JPA NamedQueries by finder methods
15 19 Oliver Gierke
* Dynamic query generation from finder method names
16 19 Oliver Gierke
* Implementation domain base classes providing basic properties
17 19 Oliver Gierke
* Support for transparent auditioning (created, last changed)
18 27 Oliver Gierke
* Possibility to integrate custom DAO code
19 19 Oliver Gierke
* Easy Spring integration with custom namespace
20 28 Oliver Gierke
* [[Eclipse plugin]] to integrate with Spring IDE
21 18 Oliver Gierke
22 1
h2. Downloads
23 1
24 29 Oliver Gierke
* "hades-0.5.0 - binary":http://repo.synyx.org/org/synyx/hades/org.synyx.hades/0.5.0/org.synyx.hades-0.5.0.jar
25 29 Oliver Gierke
* "hades-0.5.0 - sources":http://repo.synyx.org/org/synyx/hades/org.synyx.hades/0.5.0/org.synyx.hades-0.5.0-sources.jar
26 29 Oliver Gierke
* "hades-0.5.0 - javadoc":http://repo.synyx.org/org/synyx/hades/org.synyx.hades/0.5.0/org.synyx.hades-0.5.0-javadoc.jar - ("browse":http://trac.synyx.org/hades/chrome/site/mvn/org.synyx.hades/apidocs/index.html directly)
27 19 Oliver Gierke
28 19 Oliver Gierke
h2. Maven integration
29 19 Oliver Gierke
30 10 Oliver Gierke
To use Hades in your Maven project you need to add Synyx Maven repository to your list of repositories:
31 25 Oliver Gierke
<pre><code class="xml">
32 10 Oliver Gierke
<repository>
33 29 Oliver Gierke
	<id>repo.synyx.de</id>
34 10 Oliver Gierke
	<name>Synyx Maven2 Repository</name>
35 29 Oliver Gierke
	<url>http://repo.synyx.org</url>
36 1
</repository>
37 25 Oliver Gierke
</code>
38 19 Oliver Gierke
</pre>
39 1
40 25 Oliver Gierke
After that integrating Hades is just a matter of declaring the dependency:
41 1
<pre><code class="xml">
42 10 Oliver Gierke
<dependency>
43 10 Oliver Gierke
	<groupId>org.synyx.hades</groupId>
44 29 Oliver Gierke
	<artifactId>org.synyx.hades</artifactId>
45 29 Oliver Gierke
	<version>0.5.0</version>
46 10 Oliver Gierke
</dependency>
47 25 Oliver Gierke
</code>
48 10 Oliver Gierke
</pre>
49 1
50 1
Make sure you add the persistence provider of your choice, too.
51 1
52 19 Oliver Gierke
h2. Further documents
53 25 Oliver Gierke
54 27 Oliver Gierke
* "Maven site":http://trac.synyx.org/hades/chrome/site/mvn/index.html
55 25 Oliver Gierke
* Reference documentation: attachment:hades-reference.pdf
56 29 Oliver Gierke
* "JavaDoc":http://trac.synyx.org/hades/chrome/site/mvn/org.synyx.hades/apidocs/index.html