アグリゲート戦略 

アグリゲート戦略は、任意のSELECT文からエンティティアグリゲートを構築する方法を定義します。リレーショナルなクエリ結果を階層構造のエンティティにマッピングするために、エンティティ同士の関連付け方法を指定する構造化されたアプローチを提供します。

アグリゲート戦略の定義 

アグリゲート戦略は、インターフェースに @AggregateStrategy アノテーションを付与することで表されます。このアノテーションは、クエリ結果からエンティティアグリゲートをどのように再構築するかを定義するために使用されます。

@AggregateStrategy(root = Department.class, tableAlias = "d")
interface DepartmentAggregateStrategy {
    ...
}

root 要素は、アグリゲートのルートとして機能するエンティティクラスを指定します。
tableAlias 要素は、ルートエンティティクラスに対応するテーブルのエイリアスを指定します。このエイリアスは、SELECT文でクエリの結果をエンティティプロパティに正しくマップするために使用する必要があります。

関連付けリンカーの定義 

アグリゲート戦略には、@AssociationLinker で注釈された BiFunction 型のフィールドが少なくとも1つ含まれている必要があります。BiFunction は、2つのエンティティインスタンスを動的に関連付ける責任があります。

@AggregateStrategy(root = Department.class, tableAlias = "d")
interface DepartmentAggregateStrategy {
  @AssociationLinker(propertyPath = "employees", tableAlias = "e")
  BiFunction<Department, Employee, Department> employees =
      (d, e) -> {
        d.getEmployees().add(e);
        e.setDepartment(d);
        return d;
      };

  @AssociationLinker(propertyPath = "employees.address", tableAlias = "a")
  BiFunction<Employee, Address, Employee> address =
      (e, a) -> {
        e.setAddress(a);
        return e;
      };
}

BiFunction の最初と 3 番目の型パラメータはプロパティを所有するクラスを表し、2 番目の型パラメータはプロパティの型を表します。
propertyPath 要素は、ルートエンティティクラスからドットで区切られたパスとしてターゲットプロパティの名前を指定します。
tableAlias 要素は、BiFunction の 2 番目の型パラメータとして使用されるエンティティクラスに対応するテーブルのエイリアスを指定します。このエイリアスはSELECT文で使用する必要があります。

例 

上記の DepartmentAggregateStrategy は以下のエンティティ定義に基づいています。

@Entity(naming = NamingType.SNAKE_LOWER_CASE)
public class Department {
  @Id Integer id;
  String name;
  @Association List<Employee> employees = new ArrayList<>();

  // getter, setter
}

@Entity(naming = NamingType.SNAKE_LOWER_CASE)
public class Employee {
  @Id Integer id;
  String name;
  Integer departmentId;
  Integer addressId;
  @Association Department department;
  @Association Address address;

  // getter, setter
}

@Entity(naming = NamingType.SNAKE_LOWER_CASE)
public class Address {
  @Id Integer id;
  String street;

  // getter, setter
}

エンティティクラスでは、関連プロパティに @Association を付与する必要があります。これらのプロパティは @AssociationLinker を使用してリンクできます。