WikiStart

Version 43 (Oliver Gierke, 04/08/2010 11:28 am)

1 1
h1. Hades
2 41 Oliver Gierke
3 41 Oliver Gierke
{{>toc}}
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 43 Oliver Gierke
To get a first impression of what the library can do for you, you should read the [[Quickstart]] or the [[Rationale]]. A good next step might be reading through the attachment:hades-reference.pdf.
10 1
11 19 Oliver Gierke
h2. Features
12 11 Oliver Gierke
13 19 Oliver Gierke
* Implementation of CRUD methods for JPA Entities
14 36 Oliver Gierke
* Transparent triggering of JPA queries 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 36 Oliver Gierke
* Support for transparent auditing (created, last changed)
18 27 Oliver Gierke
* Possibility to integrate custom DAO code
19 1
* Easy Spring integration with custom namespace
20 19 Oliver Gierke
* [[Eclipse plugin]] to integrate with Spring IDE
21 36 Oliver Gierke
* OSGi ready bundles and sample application
22 18 Oliver Gierke
23 1
h2. Downloads
24 1
25 42 Oliver Gierke
* "hades-1.1.2 - binary":http://repo.synyx.org/org/synyx/hades/org.synyx.hades/1.1.2/org.synyx.hades-1.1.2.jar
26 42 Oliver Gierke
* "hades-1.1.2 - sources":http://repo.synyx.org/org/synyx/hades/org.synyx.hades/1.1.2/org.synyx.hades-1.1.2-sources.jar
27 42 Oliver Gierke
* "hades-1.1.2 - javadoc":http://repo.synyx.org/org/synyx/hades/org.synyx.hades/1.1.2/org.synyx.hades-1.1.2-javadoc.jar - ("browse":http://hades.synyx.org/static/site/org.synyx.hades/apidocs/index.html directly)
28 19 Oliver Gierke
29 19 Oliver Gierke
h2. Maven integration
30 19 Oliver Gierke
31 10 Oliver Gierke
To use Hades in your Maven project you need to add Synyx Maven repository to your list of repositories:
32 25 Oliver Gierke
<pre><code class="xml">
33 10 Oliver Gierke
<repository>
34 29 Oliver Gierke
	<id>repo.synyx.de</id>
35 10 Oliver Gierke
	<name>Synyx Maven2 Repository</name>
36 29 Oliver Gierke
	<url>http://repo.synyx.org</url>
37 1
</repository>
38 25 Oliver Gierke
</code>
39 19 Oliver Gierke
</pre>
40 1
41 25 Oliver Gierke
After that integrating Hades is just a matter of declaring the dependency:
42 1
<pre><code class="xml">
43 10 Oliver Gierke
<dependency>
44 10 Oliver Gierke
	<groupId>org.synyx.hades</groupId>
45 29 Oliver Gierke
	<artifactId>org.synyx.hades</artifactId>
46 42 Oliver Gierke
	<version>1.1.2</version>
47 10 Oliver Gierke
</dependency>
48 25 Oliver Gierke
</code>
49 10 Oliver Gierke
</pre>
50 1
51 1
Make sure you add the persistence provider of your choice, too.
52 1
53 1
h2. Further documents
54 19 Oliver Gierke
55 38 Oliver Gierke
* [[Resources]] - further documents, videos, presentation slides
56 34 Oliver Gierke
* "Continuous integration (Hudson)":http://ci.synyx.org/job/Hades/
57 34 Oliver Gierke
* "Technical QA (Sonar)":http://techqa.synyx.org/project/index/126
58 32 Oliver Gierke
* "Maven site":http://hades.synyx.org/static/site/index.html
59 25 Oliver Gierke
* Reference documentation: attachment:hades-reference.pdf
60 32 Oliver Gierke
* "JavaDoc":http://hades.synyx.org/static/site/org.synyx.hades/apidocs/index.html
61 35 Oliver Gierke
* [[Development guidelines]]