Currently I just try to understand how I declare an one-to-many association with XDoclet. I know the "@hibernate Tag Reference" http://xdoclet.sourceforge.net/xdoclet/tags/hibernate-tags.html , but unfortunately that is not enough for me.

From http://www.hibernate.org/hib_docs/online/workshop_toolset/java/src/org/hibernate/workshop/ I took the method getItems() from class User to understand how things work:



- With hibernate.set you specify that a set is used to manage a collection of items.
- With hibernate.collection-key... ???
- With hibernate.collection-one-to-many you specify the class that is saved within the collection (Items are saved in the collection in class User, because a User can have many Items: one-to-many)

It would be nice if somebody could put a comment on every single line of the example to explain how this works.

smo

The doclet tags map to hibernate mapping tags and attributes. If you understand how you can hand create a mapping hbm xml file then the doclet is much easier to understand. Having said that:



@hibernate.set - is the collection container to be used. In this case a HashSet. This matches the Java return type of the method that returns the collection.

@hibernate.collection-key - is the foreign key column in the child table.

@hibernate.collection-one-to-many class - It the domain object representing each individual record of the collection. Hibernate knows which table its referencing when it refers to the Item mapping document.

See the hibernate reference manual for the HBM xml markup.

Thanks for answering. I think your advice to first get the hbm-notation and then move on to XDoclet should work fine.

By the way I found a nice Hibernate-XDoclet-Tutorial:
http://www.downside.ch/hibernate/

I think it would be nice if someone could add a link to HibernateDocs-area..

smo

I have added the reference to the Wiki.