Overview
This manual consists of three parts.
The first part is called Modeling. It describes how to model a Hibernate Cartridge Persistence Model. It is written for designers and shows all possibilities, the configuration and the customizing facilities of the cartridge.
The second part, Generated Artifacts, shows the generated artifacts in dependence of the modeled elements. It shows the dependencies of the modeled elements and the generated artifacts in more detail.
The third part, Developer Guide, looks more detailed into the Cartridge. The black box is opened and possible source code customizations are shown. Therefore some Extension Points are shown. Extension points are targets in the oAW XPand Templates, what can be used to add self written code in an easy way. Therefore aspect oriented programming (AOP) 
is used.
 |
This area is under construction.
Updating to version 1.4.1 is pending
See also the online documentation:
Manual.html
I'm very happy about any fair comment. What is good or bad? What is described to detailed, or is there any thing what have to be described not in that document? Write me an email (Darius.Jockel [at] itemis [dot] de), or write a comment on the Hibernate Cartridge Project Pages or simply rate the pages. I'm very happy about any feedback! |
For more information about AOP see:
AOP in XPand Templates
Thank you for your work. I was really missing such documentation in the days I stared working with your cartridge! It is also a good overview of features available.
Some of my ideas
What helped me a lot was to have a separate eclipse project for the cartridge with all mappings (hibernate+javabasic). A second project could contain the models and artefacts. This setup is somewhere between what you desribe as "Installation for Developers" and the basic installation.
I would find it very helpful to have a good changelog and bugfix list.
If behaviour changes, you may want to provide extra checks/warnings, that help identify conflicts at modelling level!
regards