Agents DataGrid et mappes fondées sur des entités

Une mappe contient des objets clés et des objets valeurs. Un objet clé est un bloc de données généré, de même qu'un objet valeur. Un agent est normalement fourni avec les objets clés définis dans l'application.

Un objet clé est un bloc de données généré, de même qu'un objet valeur. Un agent est normalement fourni avec les objets clés définis dans l'application. Ces objets sont les objets clés utilisés par l'application ou les blocs de données, dans le cas d'une mappe d'entités. Une application qui utilise des entités ne souhaite pas traiter directement avec les blocs de données, mais préfère utiliser les objets Java mappés vers l'entité.

Une classe d'agent peut donc implémenter l'interface EntityAgentMixin. La classe doit alors implémenter une méthode supplémentaire, getClassForEntity(). Celle-ci renvoie la classe d'entités à utiliser avec l'agent côté serveur. Les clés sont converties dans cette entité avant que les méthodes de traitement et de réduction soient appelées.

Il s'agit d'une sémantique différente de celle d'un agent non-EntityAgentMixin où ces méthodes sont simplement fournies avec les clés. Un agent qui implémente EntityAgentMixin reçoit l'objet Entity qui contient les clés et les valeurs dans un seul objet.
Remarque : Si l'entité n'existe pas sur le serveur, les clés sont au format de bloc de données brut à la place de l'entité gérée.