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:

  1. Abra a classe do bean no Editor de código-fonte.
  2. 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.
  3. Na caixa de diálogo Adicionar método localizador, defina a assinatura do método:
    1. Adicione o texto ao nome de base findBy do método.
    2. Especifique os parâmetros necessários para o método.
    3. Especifique em quais interfaces o método será adicionado (remota e/ou local).
    4. 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.
    5. 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á.
  4. 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.

Para exibir, editar ou excluir métodos localizadores existentes:

  1. Na janela Projetos, expanda o nó Arquivos de configuração do projeto de módulo EJB.
  2. Clique duas vezes em ejb-jar.xml. O editor gráfico se abre na visualização Detalhes.
  3. Clique na aba XML e faça suas alterações no editor XML.

Observações:

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