Agentes do DataGrid e Mapas Baseados em Entidade

Um mapa contém objetos-chave e objetos de valor. O objeto-chave é uma tupla gerada conforme o valor. Um agente normalmente é fornecido com o aplicativo especificado pelos objetos-chave.

O objeto-chave é uma tupla gerada conforme o valor. Um agente normalmente é fornecido com o aplicativo especificado pelos objetos-chave. Esse agente será os objetos-chave utilizados pelo aplicativo ou Tuplas se for um Mapa de entidade. Um aplicativo que usa Entidades não desejará lidar com Tuplas diretamente e preferirá trabalhar com os objetos Java mapeados para a Entidade.

Portanto, uma classe de Agente pode implementar a interface EntityAgentMixin. Isso força a classe a implementar mais um método, o getClassForEntity(). Isso retorna a classe de entidade para utilizar com o agente no lado do servidor. As chaves são convertidas nessa Entidade antes de chamar os métodos de processo e de redução.

Essa é uma diferença semântica de um agente não EntityAgentMixin em que esses métodos são fornecidas apenas com as chaves. Um agente implementando EntityAgentMixin recebe o objeto de Entidade que inclui as chaves e os valores em um objeto.
Nota: Se a entidade não existir no servidor, as chaves estão no formato de Tupla bruto da chave ao invés da entidade gerenciada.