Skip to main content

JPA 2 new feature @ElementCollection explained

@ElementCollection is new annotation introduced in JPA 2.0, This will help us get rid of One-Many and Many-One shitty syntax.

Example 1: Stores list of Strings in an Entity

@Entity
public class Users implements Serializable {

    private static final long serialVersionUID = 1L;
    @Id
    @GeneratedValue(strategy = GenerationType.AUTO)
    private Long id;
    @ElementCollection
    private List<String> certifications = new ArrayList<String>();

    public Long getId() {
        return id;
    }

    public void setId(Long id) {
        this.id = id;
    }

    public List
<String> getCertifications() {
        return certifications;
    }

    public void setCertifications(List
<String> certifications) {
        this.certifications = certifications;
    }

..
}

        Users u = new Users();
        u.getCertifications().add("Sun Certified Java Programmer");
        em.persist(u);

Generated Tables

   Users
   Column --> ID
    Row             1

Users_CERTIFICATIONS
  Column  Users_ID      CERTIFICATIONS
  Row           1                 Sun Certified Java Programmer

 @ElementCollection rules
  1.    This annotation was introduced to map basic and embedded type objects
  2.    You can use any collection of type Collection, List, Set, Map
  3.    Its easy to override default values for generated Tables and Columns
  4.    JPA 1.0 only supported collection holding entity types using (@ManyToOne, @OneToMany) annotations
Lets quickly look at code snippet for Embedded object based collection


@Embeddable
public class Certification {

    @Column(name = "name")
    private String name;
    @Temporal(TemporalType.DATE)
    @Column(name = "issue_date")
    private Date issueDate;

    public Date getIssueDate() {
        return issueDate;
    }

    public void setIssueDate(Date issueDate) {
        this.issueDate = issueDate;
    }

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }
}


@Entity
public class Users implements Serializable {

    private static final long serialVersionUID = 1L;
    @Id
    @GeneratedValue(strategy = GenerationType.AUTO)
    private Long id;
    @ElementCollection
    @CollectionTable(name = "Certification", joinColumns = {@JoinColumn(name="user_id")})
    private List<Certification> certifications = new ArrayList<Certification>();

   
    public Long getId() {
        return id;
    }

    public void setId(Long id) {
        this.id = id;
    }

    public List
<Certification> getCertifications() {
        return certifications;
    }

    public void setCertifications(List
<Certification> certifications) {
        this.certifications = certifications;
    }
..

}


        Users u = new Users();
        Certification c = new Certification();
        c.setName("Sun Certified Java Programmer");
        c.setIssueDate(new Date());
        u.getCertifications().add(c);
        em.persist(u);

Resulted Table structure

Table --> Users
   Column --> ID
    Row             1

Table --> Users_Certification
  Column  user_id      name                                                   Issue_Date                         
  Row           1                 Sun Certified Java Programmer        2010-09-05

Map based Collection is a rich area it needs a seperate article to describe it some detail.

Comments

John said…
Nice article. Nice blog. It's bookmarked now :-) Well done and thanks for the clean and clear explanation.
Anonymous said…
Very Nice.
Thanks from Mumbai
Jin Kwon said…
Where is the entry for Map based collection?
good explanation :)
www.shikaku.ru
VPS and Web hosting
Anonymous said…
Amazing... thanks for your service to help community. I just bookmarked...
Rags said…
Nice article. Are there any scenarios where use of onetomany or manytoone is still valid/required/preferred to elementcollection?
Rory said…
You sir, deserve a beer! This is a really good and clean explanation. Cheers!
Petr Jeřábek said…
and db query by elementcollection values?
Oo^sai^oO said…
Where Do we mention the tablename here for the collection? how does that happen?
Unknown said…
explained nicely, formatted code would be more readable.

Popular posts from this blog

Validating CSV Files

What is CsvValidator ?
  A Java framework which validates any CSV files something similar to XML validation using XSD.

Why should I use this ?
  You don't have to use this and in fact its easy to write something your own and also checkout its source code for reference.

Why did I write this ?
  Some of our projects integrate with third party application which exchanges information in CSV files so I thought of writing a generic validator which can be hooked in multiple projects or can be used by QA for integration testing.

What is the license clause ?
GNU GPL v2

Are there any JUnit test cases for me checkout ?
 Yes, source

How to integrate in my existing project ?

Just add the Jar which can be downloaded from here CsvValidator.jar and you are good.

Instantiate CsvValidator constructor which takes these 3 arguements

         // filename is the the file to be validated and here is a sample         // list - defines all the fields in the above csv file ( a field has index, type, isOptional, rege…

ArrayList vs LinkedList vs HashSet Performance Comparision

ConclusionsInserting & Reading sequentially from Collection prefer LinkedList/ArrayListInserting & Reading/Deleting by Search/equals from Collection prefer HashSetInserting, ArrayList & LinkedList performs best while HashSet takes double the timeReading, HashSet performs best while ArrayList & LinkedList are marginally lessDeleting, HashSet performs 10 times better than ArrayList & ArrayList performs 4 times better than LinkedList. LinkedList is slow because of sequencial search Bottom line : unless you are not going to iterate using for(Integer i : list ) then prefer HashSet
Inserting/Reading/Deleting integer's from zero till countJDK7Collectionactioncounttime msArrayListInsert1000/1LinkedListInsert1000/1HashSetInsert1000/1ArrayListInsert100005LinkedListInsert100004HashSetInsert100007ArrayListInsert10000011LinkedListInsert10000011HashSetInsert10000021ArrayListGet/Read1000LinkedListGet/Read1000HashSetGet/Read1000ArrayListGet/Read100004LinkedListGet/Read100003Has…