Hibernate Best Practices

Some contrarian thoughts about the hibernate team's recommended best practices: link

Components in queries - must fully qualify each part of the key

Do this:

public List getMemberNotes(MembershipId membershipId) {
    return session.createQuery(
            "from MemberNote where "
                    + "membershipId.memberNumber=:memberNumber and "
                    + "membershipId.memberPrefix=:memberPrefix")
            .setInteger("memberNumber", membershipId.getMemberNumber())
            .setInteger("memberPrefix", membershipId.getMemberPrefix())
            .list();}

Not this:

public List getMemberNotes(MembershipId membershipId) {
    return session.createQuery(
            "from MemberNote where membershipId=:membershipId")
            .setParameter("membershipId", membershipId).list();
}

Generated Keys
The equals() Method
Custom types