WikiStart
Version 39 (Oliver Gierke, 12/23/2009 03:35 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 | 30 | 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 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 | 39 | Oliver Gierke | * "hades-1.1 - binary":http://repo.synyx.org/org/synyx/hades/org.synyx.hades/1.1/org.synyx.hades-1.1.jar |
| 26 | 39 | Oliver Gierke | * "hades-1.1 - sources":http://repo.synyx.org/org/synyx/hades/org.synyx.hades/1.1/org.synyx.hades-1.1-sources.jar |
| 27 | 39 | Oliver Gierke | * "hades-1.1 - javadoc":http://repo.synyx.org/org/synyx/hades/org.synyx.hades/1.1/org.synyx.hades-1.1-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 | 39 | Oliver Gierke | <version>1.1</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]] |