SimpleFlatMapper can aggregate join objects in sub-list of the root object. The CSV mapper as of 3.11.1 still has limitation and can only handle 1 join as it relies on id changes to create new objects, with more than 1 joins the second joins id can’t be ordered continuously and that will create duplicates.

let’s say you have the followings tables

The following SQL query will retrieve each user with his roles and Phone numbers

SELECT as id, as name, as roles_id, as roles_name, as phones_id, p.number as phones_number
FROM user u 
    left join role r on r.user_id =
    left join phone p on p.user_id =

It can be map to the following object

class User {
    List<Role> roles;
    List<PhoneNumber> phones;

For the aggregation to work you will need to be sure to order by the root object - ORDER BY - and also tell the mapper what are the keys of the different objects. Also, it is better to specify all the keys if none is specified the mapper will assume that each row will create a different object. There are two ways to specify the keys the first one is on the MapperFactory, like the following with a JDBC mapper.

    JdbcMapper<Object> jdbcMapper = 
                .addKeys("id", "roles_id", "phones_id")

The second way is to annotate the object with @Key on the field, the setter or the getter.

class User {
    int id;

The aggregation can deal with any number of inner level, and any number like the following - except for CSV -:

class Root {
    List<Child> children;
    List<Car> cars;

class Child {
    List<Toy> toys;

class Toy {
    List<Language> laguages;

The join support might be limited third party framework integration if it expect one object per row, check the specific docs for more detail.