Java Collections

In previous versions of HOM, a POJO containing a Java Collection property could not be easily mapped to Cassandra columns using HOM. You would have needed to create a custom converter that would handle the mapping ... until now. Now you can annotate a collection property using @Column just like any other property and HOM will do "the right thing".

How does it work? Each element of the collection is mapped to a Cassandra column with a simple naming scheme, "<pojo-property-name>:<index>". There is also an "informational column" persisted, "<pojo-property-name>", that contains the type of the Collection and its size. A consequence of persisting Collections is that any previously persisted POJO properties are removed and persisted again. This is because HOM tries to keep persisting fast, and for most cases (if not all) simply removing everything and persisting again, saves a read to get the existing Collection information. When reading, all columns are read and the "informational column" tells HOM what Collection to to instantiate and how many columns exist.

Let's look at an example:

@Entity
@DiscriminatorValue("table_desk")
public class Desk extends BasicTable {

  @Column(name = "desk_type")
  private String deskType;

  @Column(name = "drawerList")
  private List<String> drawerList = new ArrayList<String>();

  public List<String> getDrawerList() {
    return drawerList;
  }

  public void setDrawerList(List<String> drawerList) {
    this.drawerList = drawerList;
  }

  public String getDeskType() {
    return deskType;
  }

  public void setDeskType(String deskType) {
    this.deskType = deskType;
  }
}

As you can see above, there is a "List" Collection property, drawerList. Let's assume there are three elements in the list. HOM will persist four columns: drawerList, drawerList:0, drawerList:1, drawerList:2. drawerList contains java.util.ArrayList and size of 3. Pretty simple!

Note that the implementation does not implement relationships between objects, like many-to-one, etc ... at least not yet. If you have a collection of custom typed objects, you will need to implement a converter that can persist the object within a single column.

---

Up to Hector Object Mapper (HOM)