New Tutorial - Feedback appreciated

michael · **Posted:** Mon Jan 12, 2004 8:15 pm

Hi everybody,

I have started writing yet another Hibernate tutorial. It is not finished yet, but I would greatly appreciate any oppinions and critisism:

http://www.gloegl.de/5.html

david · **Posted:** Tue Jan 13, 2004 12:21 am

Looks good. Did not read in detail but it appears to move forward at the right pace. Christian can add this to the external documentation section of the wiki.

emmanuel · **Posted:** Tue Jan 13, 2004 1:55 pm

Hi Michael,
Good job! Here are some remarks to improve it:

Tell the Hibernate version you use. Some materials on the internet refers to hibernate 1.2 and people are confused.
Don't be too precise in your links. Example for the documentation, which is generated and where anchors can be renamed.

I'm not sure

Code:

<property name="transaction.factory_class">
             net.sf.hibernate.transaction.JDBCTransactionFactory
        </property>

works

Tell

Code:

<property name="transaction.factory_class">net.sf.hibernate.transaction.JDBCTransactionFactory</property>

Points to the hibernate features list to show the "extra" capabilities of Hibernate.

Put at the begining a short summary of what an ORM tool do. It'll help people to be in the mood.

michael · **Posted:** Tue Jan 13, 2004 5:21 pm

Hi,

thanks for your suggestions. I line-breaked the XML examples on purpose because such long lines in <pre> blocks will cause ugly horizontal scrolling for the page. But I think in this case I should probably change it, as there were some forum questions caused by this allready I think. Well, people should use a propper screen resolution anyways :)

I will include the rest of your suggestions, but will keep the links in as they are. I will add a chapter and paragraph reference in the text, so people can scroll to the right place manually if the anchors break.

michael · **Posted:** Tue Jan 13, 2004 7:00 pm

I added most of your suggestions, Emmanuel. I left the line breaks in, because the "not working" part was actually a bug and was fixed somewhere around 2.1-rc6. So it will work for people using a recent version, and without the line breaks, it really messes up my layout :)

thstory · **Posted:** Sat Jan 17, 2004 9:06 pm

This is a really good tutorial, especially from an architectural perspective. Additionally, I'd like to see:

* How you'd do JUnit tests (Session)
* Integration with business objects - how would you decouple the Session from the business object (extension of JUnit test). Is it simply passing the Session instance around?

Thanks for a great tutorial.

michael · **Posted:** Sun Jan 18, 2004 9:23 am

Thanks for the suggestions, I will include a chapter about testing Hibernate. This is acutally quite easy to do using WebWork and the ThreadLocalSession pattern.

For decoupling you have to look into DAO patterns and such, but I will most likely not include this, because I don't want to introduce unnecessary architectural complexity into the tutorial.