WebServices with CXF - My Pojos & DAOs

First thing, is a good practice declaring methods equals and hashCode
You know what, I'll skip these methods on my code, eclipse can do it for you, don't be lazy!!!
And one more thing, as Architect it's a must declaring toString method, because when you're debugging these method it's going to be really helpful, and you know what... declare toString it's a must too.
package mx.com.mylibrary.core.persistence.domain; import java.io.Serializable; import java.util.ArrayList; import java.util.Date; import java.util.List; import javax.persistence.Column; import javax.persistence.Entity; import javax.persistence.FetchType; import javax.persistence.GeneratedValue; import javax.persistence.GenerationType; import javax.persistence.Id; import javax.persistence.OneToMany; import javax.persistence.Table; /** * * Domain Object * * @author Juan Carlos Cruz * @since Sep 26 2009 */ @Entity @Table(name = "EDITOR") public class Editor implements Serializable { private static final long serialVersionUID = 5125858002922739070L; @Id @GeneratedValue(strategy = GenerationType.AUTO) @Column(name = "editor_id", unique = true) private Integer editorId; @Column(name = "title", length = 200, nullable = false) private String name; @Column(name = "url", length = 255, nullable = true) private String url; @Column(name = "create_date", insertable = false, updatable = false, columnDefinition = "Timestamp DEFAULT CURRENT_TIMESTAMP") private Date createDate; @OneToMany(mappedBy="editor", fetch=FetchType.LAZY) private List<Book> books = new ArrayList<Book>(0); //Setters & Getters } package mx.com.mylibrary.core.persistence.domain; import java.io.Serializable; import java.util.ArrayList; import java.util.Date; import java.util.List; import javax.persistence.Column; import javax.persistence.Entity; import javax.persistence.FetchType; import javax.persistence.GeneratedValue; import javax.persistence.GenerationType; import javax.persistence.Id; import javax.persistence.JoinColumn; import javax.persistence.JoinTable; import javax.persistence.ManyToMany; import javax.persistence.ManyToOne; import javax.persistence.Table; import javax.persistence.UniqueConstraint; /** * * Domain Object * * @author Juan Carlos Cruz * @since Sep 26 2009 */ @Entity @Table(name = "BOOK") public class Book implements Serializable { private static final long serialVersionUID = -5220399448304637221L; @Id @GeneratedValue(strategy = GenerationType.AUTO) @Column(name = "book_id", unique = true) private Integer bookId; @Column(name = "title", length = 200, nullable = false) private String title; @Column(name = "create_date", insertable = false, updatable = false, columnDefinition = "Timestamp DEFAULT CURRENT_TIMESTAMP") private Date createDate; @ManyToOne(optional = true, fetch = FetchType.EAGER) @JoinColumn(name = "editor_id", nullable = true, updatable = true) private Editor editor; @ManyToMany(fetch = FetchType.LAZY) @JoinTable(name = "AUTHOR_BOOK", joinColumns = @JoinColumn(name = "book_id", referencedColumnName = "book_id"), inverseJoinColumns = @JoinColumn(name = "author_id", referencedColumnName = "author_id"), uniqueConstraints = @UniqueConstraint( columnNames = {"book_id", "author_id"} ) ) private List<Author> autores = new ArrayList<Author>(0); //Setters & Getters } package mx.com.mylibrary.core.persistence.domain; import java.io.Serializable; import java.util.ArrayList; import java.util.Date; import java.util.List; import javax.persistence.CascadeType; import javax.persistence.Column; import javax.persistence.Entity; import javax.persistence.FetchType; import javax.persistence.GeneratedValue; import javax.persistence.GenerationType; import javax.persistence.Id; import javax.persistence.JoinColumn; import javax.persistence.JoinTable; import javax.persistence.ManyToMany; import javax.persistence.Table; /** * * Domain Object * * @author Juan Carlos Cruz * @since Sep 26 2009 */ @Entity @Table(name = "AUTHOR") public class Author implements Serializable { private static final long serialVersionUID = 3065679411071650221L; @Id @GeneratedValue(strategy = GenerationType.AUTO) @Column(name = "author_id", unique = true) private Integer authorId; @Column(name = "name", length = 100, nullable = false) private String name; @Column(name = "email", length = 100, nullable = true) private String email; @Column(name = "create_date", insertable = false, updatable = false, columnDefinition = "Timestamp DEFAULT CURRENT_TIMESTAMP") private Date createDate; @ManyToMany(fetch = FetchType.LAZY, cascade = CascadeType.ALL) @JoinTable(name = "AUTHOR_BOOK", joinColumns = @JoinColumn(name = "author_id", referencedColumnName = "author_id"), inverseJoinColumns = @JoinColumn(name = "book_id", referencedColumnName = "book_id") ) private List<Book> books = new ArrayList<Book>(0); //Setters & Getters } The next step is explain what are those annotations, well they're Java 6 annotations, so we can skip some configurations and declare them into our code. I'll try to explain as simple as possible these annotations, let's analyze them: @Entity @Table(name = "EDITOR") public class Editor...

What I'm doing here is just declaring that this POJO will be an Entity which maps to a table called EDITOR

@Id @GeneratedValue(strategy = GenerationType.AUTO) @Column(name = "editor_id", unique = true) private Integer editorId; @Column(name = "title", length = 200, nullable = false) private String name; @Column(name = "url", length = 255, nullable = true) private String url; @Column(name = "create_date", insertable = false, updatable = false, columnDefinition = "Timestamp DEFAULT CURRENT_TIMESTAMP") private Date createDate; @OneToMany(mappedBy="editor", fetch=FetchType.LAZY) private List<Book> books = new ArrayList<Book>(0);

Using Annotations, I declared that editorId is my PK which basically is AutoIncremental and to which column will be mapped. With columns is really easy.

But what about relations??? Like

BOOK >-- EDITOR

In this case I just declared what I needed to declare: One Editor has Many books using a List of Book, like in every mapping of Hibernate: the most common fetching strategy to be used will be LAZY; basically what I did was linking the current ENTITY by it's PK (mappedBy="editor") to Book

So in Book this is what we have to do (the inverse to OneToMany and define an Editor for each Book, so each child will have a reference to it's Dad):
@ManyToOne(optional = true, fetch = FetchType.EAGER) @JoinColumn(name = "editor_id", nullable = true, updatable = true) private Editor editor;

The last thing is just declare which column & attribute will be used to do the JOIN between child and father

You can get more details if you look for that topic in Hibernate official documentation.
And these are my DAO's (I just included 1 as example), others should be similar. Always code oriented to interfaces! Later you'll thank me. package mx.com.mylibrary.core.persistence.dao; import java.util.List; import mx.com.mylibrary.core.persistence.domain.Book; import org.springframework.dao.DataAccessException; /** * Data access object Interface (DAO) for domain model class Book. * * @author Juan Carlos Cruz * @since September 29 2009 */ public interface BookDAO { public void save(Book transientInstance) throws DataAccessException; public void delete(Book persistentInstance) throws DataAccessException; public Book findById(Integer id) throws DataAccessException; public List<Book> findByExample(Book instance) throws DataAccessException; public List<Book> findByProperty(String propertyName, Object value) throws DataAccessException; public void saveOrUpdate(Book instance) throws DataAccessException; public void update(Book instance) throws DataAccessException; } package mx.com.mylibrary.core.persistence.dao.impl; import java.util.List; import mx.com.mylibrary.core.persistence.dao.BookDAO; import mx.com.mylibrary.core.persistence.domain.Book; import org.hibernate.Criteria; import org.hibernate.SessionFactory; import org.hibernate.criterion.Example; import org.hibernate.criterion.MatchMode; import org.hibernate.criterion.Restrictions; import org.springframework.dao.DataAccessException; /** * Data access object Implementation (DAO) for domain model class Book. * * @author Juan Carlos Cruz * @since September 29 2009 */ public class BookDAOImpl implements BookDAO { private SessionFactory sessionFactory; public void setSessionFactory(SessionFactory sessionFactory) { this.sessionFactory = sessionFactory; } public void delete(Book persistentInstance) { this.sessionFactory.getCurrentSession().delete(persistentInstance); } @SuppressWarnings("unchecked") public List<Book> findByExample(Book instance) throws DataAccessException { Criteria criteria = this.sessionFactory.getCurrentSession().createCriteria(Book.class); Example example = Example.create(instance).ignoreCase(); example.enableLike(MatchMode.START); example.excludeZeroes(); criteria.add(example); return criteria.list(); } @SuppressWarnings("unchecked") public Book findById(Integer id) { Criteria criteria = this.sessionFactory.getCurrentSession().createCriteria(Book.class); criteria.add(Restrictions.eq("bookId", id)); List<Book> items = criteria.list(); return items.isEmpty()?null:items.get(0); } @SuppressWarnings("unchecked") public List<Book> findByProperty(String propertyName, Object value) throws DataAccessException { Criteria criteria = this.sessionFactory.getCurrentSession().createCriteria(Book.class); criteria.add(Restrictions.eq(propertyName, value)); return criteria.list(); } public void save(Book transientInstance) { this.sessionFactory.getCurrentSession().save(transientInstance); } public void saveOrUpdate(Book instance) { this.sessionFactory.getCurrentSession().saveOrUpdate(instance); } public void update(Book instance) { this.sessionFactory.getCurrentSession().update(instance); } } In my next entry I will explain my Services and we'll be ready for using CXF.