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.
  2. Clique com o botão direito do mouse no Editor de código e escolha Métodos EJB > Adicionar método localizador.
  3. Na caixa de diálogo Novo método localizador, defina a assinatura do método:
    1. Adicione o texto ao nome de base findBy do método.
    2. 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.
    3. 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. Especifique em quais interfaces o método será adicionado (remota e/ou local).
    5. Especifique os parâmetros necessários para o método.
  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 implantação 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 exibição Detalhes.
  3. 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.
  4. Clique em Adicionar ou Editar para alterar a lista de métodos localizadores.

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