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-fonte.
- Clique com o botão direito do mouse em qualquer lugar no Editor de código-fonte e escolha Inserir código > Adicionar método localizador.
- Na caixa de diálogo Adicionar método localizador, defina a assinatura do método:
- Adicione o texto ao nome de base findBy do método.
- Especifique os parâmetros necessários para o método.
- Especifique em quais interfaces o método será adicionado (remota e/ou local).
- 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 "Many", 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á.
- 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 deployment geral.
- Se o bean de entidade utilizar CMP, está pronto. O contêiner 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 visualização Detalhes.
- Clique na aba XML e faça suas alterações no editor XML.
- Se você fizer alterações em ejb-jar.xml, também precisará fazer as alterações correspondentes no código-fonte do bean.
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 do código-fonte do bean.
- Exclua a consulta localizadora de ejb-jar.xml.
- 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