Definindo um método seletor
Consulte também
Os métodos de seleção são um tipo de método de consulta que, como os métodos localizadores, são usados nos Beans de entidade CPM do EJB 2.1 para bancos de dados de consulta. Um método seletor é mais flexível que um método localizador e é visível somente pela classe do Bean. Portanto, um método seletor pode ser usado somente por métodos da classe do Bean. Um método seletor herda o contexto de transação do método que o chama. Além de retornar um Bean ou um conjunto de Beans, um método seletor pode retornar também o valor de um campo. Os métodos de seleção estão disponíveis somente para Beans de entidade que usam persistência gerenciada por recipiente (CMP).
Para definir um método de seleção de um Bean de entidade CMP:
- 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 seletor.
Você também pode clicar com o botão direito do mouse no nó do Enterprise Bean na janela Projetos e escolher Adicionar > Adicionar método seletor.
- Na caixa de diálogo Adicionar método seletor, defina a assinatura do método:
- Adicione o texto ao nome de base ejbSelectBy do método.
- Escolha o tipo de retorno do método na caixa de combinação:
- Se o método retornar o valor de um campo CMP, escolha o tipo de dados primitivo ou de Java apropriados, como java.lang.String ou int.
- Se o método retornar um Enterprise Bean, digite o tipo do Bean na caixa de combinação.
- Se o método retornar mais de um Bean, digite java.util.Set ou java.util.Collection na caixa de combinação. Utilize java.util.Set se os Beans retornados não podem ser duplicados. Utilize java.util.Collection se os Beans retornados podem ser duplicados.
- Insira a instrução QL EJB que o método usará para procurar os dados que retornará.
- 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 à classe do Bean e registra o método de seleção no descritor de implantação do módulo EJB.
Para exibir ou editar um método de seleção existente:
- 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 nó do Bean de entidade e o cabeçalho Métodos seletores CMP. A tabela lista todos os métodos de seleção CMP existentes.
- Clique em Adicionar ou Editar para alterar a lista de métodos.
- Consulte também
- Sobre os Beans de entidade
- Definindo um método localizador
- Definindo um método empresarial
- Adicionando QL EJB a um método localizador ou seletor
- Sobre mapeamentos CMP do EJB 2.1
- Definindo um campo CMP
- Gerando Beans de entidade CMP de um banco de dados
Notificações legais