O termo Container-Managed Persistence (CMP), persistência gerenciada por recipiente em português, significa que o recipiente EJB toma conta de todos os acessos ao banco de dados requeridos pelo bean de entidade. Ao codificar para a especificação J2EE 1.4, crie os beans de entidade CMP e descreva como os beans de entidade são mapeados para tabelas no banco de dados em um .
Se você estiver implantando no servidor de aplicativos Sun Java System/GlassFish, os mapeamentos de CMP para o módulo EJB serão especificados no arquivo do descritor sun-cmp-mappings.xml no diretório src/conf do módulo. Se você gerar os Beans de entidade CMP a partir de uma fonte de dados, o IDE gera o sun-cmp-mappings.xml para você quando os Beans de entidade CMP forem criados. Para editar os mapeamentos de CMP, é necessário abrir o sun-cmp-mappings.xml no Editor XML.
O arquivo do descritor sun-cmp-mapping.xml descreve como os beans de entidade, os campos CMP e as relações CMR são mapeados para o banco de dados. O código do Bean não contém chamadas de acesso ao banco de dados (SQL). Conseqüentemente, o código do Bean não está vinculado a um mecanismo de armazenamento persistente específico (banco de dados). Por causa desta flexibilidade, até mesmo se você reimplantar o bean de entidade para diferentes servidores J2EE que usem diferentes bancos de dados, você não vai precisar modificar ou recompilar o código do Bean. Isso torna o Bean de entidade mais portátil.
Com o propósito de gerar as chamadas de acesso aos dados, você tem que prover um esquema que defina os campos persistentes dos Beans e os relacionamentos. Os beans de entidades CMP espelham a estrutura do banco de dados. Os campos CMP dos Beans correspondem às colunas das tabelas do banco de dados e os campos dos relacionamentos correspondem às chaves externas do banco de dados.
Se você está implantando no servidor da aplicação Sun Java System, o IDE poderá auxiliá-lo a gerar e configurar mapeamentos de CMP. Se você está implantando em um servidor da aplicação diferente, terá que configurar os mapeamentos de CMP por sua conta, editando os descritores de deployment específicos para servidores.
Existem três estratégias para trabalhar com os mapeamentos de CMP no IDE:
Para obter uma descrição detalhada das especificações do bean de entidade CMP, consulte a Especificação Enterprise JavaBeans, v2.1.