Definindo um método localizador
Consulte também
Um método localizador consiste em um método de consulta usado em um Bean de entidade do EJB 2.1. (Os métodos de seleção consistem em outro tipo de método de consulta.) Os métodos localizadores são exclusivos dos Beans de entidade porque tais Beans representam os dados em um banco de dados que pode ser identificado e encontrado. Os Beans de sessão não representam dados de banco de dados e, portanto, não apresentam dados que possam ser encontrados.
Para definir um método localizador de um Bean de entidade:
- Abra a classe do Bean no Editor de código.
- Clique com o botão direito do mouse no Editor de código e escolha Métodos EJB > Adicionar método localizador.
- Na caixa de diálogo Novo método localizador, defina a assinatura do método:
- Adicione o texto ao nome de base findBy do método.
- Especifique a cardinalidade de retorno do método. Esta configuração deve corresponder a cardinalidade de retorno da instrução do banco de dados. Se selecionar Um, a instrução retorna a interface do Bean. Se selecionar Vários, a instrução retorna um objeto java.util.Collection.
- Se o Bean utiliza a persistência gerenciada por recipiente (CMP), insira a instrução QL EJB que o método usará para procurar o Enterprise Bean ou os Beans que método retornará.
- Especifique em quais interfaces o método será adicionado (remota e/ou local).
- Especifique os parâmetros necessários para o método.
- Clique em OK para criar o método.
O IDE adiciona a assinatura do método às interfaces do Bean e registra o método no descritor de implantação geral.
- Se o Bean de entidade utilizar CMP, está pronto. O recipiente implementa o método localizador da assinatura na interface de início ou na interface de início local, assim a interface de início e a interface de início local são os únicos locais nos quais o método aparece.
- Se o Bean de entidade utilizar a persistência gerenciada por Bean (BMP), o IDE adicionará um método ejbFindyourname vazio à classe do Bean de modo que você possa implementar o método. O método ejbFindyourname deve ser implementado por você.
Para exibir, editar ou excluir métodos localizadores existentes:
- Na janela Projetos, expanda o nó Arquivos de configuração do projeto de módulo EJB.
- Clique duas vezes em ejb-jar.xml. O editor gráfico se abre na exibição Detalhes.
- Expanda o cabeçalho do Bean de entidade e o cabeçalho Métodos localizadores CMP. A tabela lista todos os métodos localizadores CMP existentes.
- Clique em Adicionar ou Editar para alterar a lista de métodos localizadores.
Observações:
- Quando o IDE adiciona um método localizador a um Bean de entidade, ele não salva nem a classe nem as interfaces do Bean. Somente quando você compilar ou salvar o projeto é que as alterações serão salvas no disco.
- Para remover completamente o método localizador de um Enterprise Bean, adote um dos seguintes procedimentos:
- Exclua o método da lista Métodos home do Bean na janela Projetos.
- Exclua o método do cabeçalho Métodos localizadores CMP no editor gráfico ejb-jar.xml.
Se excluir o método localizador no Editor de código, o IDE não o removerá das interfaces do Bean.
- Consulte também
- Sobre os Beans de entidade
- Definindo um método seletor
- Definindo um método empresarial
- Definindo um campo CMP
- Adicionando QL EJB a um método localizador ou seletor
- Gerando Beans de entidade CMP de um banco de dados
Notificações legais