Abra este editor de propriedades na guia Consultas do localizador EJB1.1 no painel Entity Bean do editor visual sun-ejb-jar.xml.
O servidor de aplicativos Sun Java System usa uma extensão de consultas de JDOQL (Java Data Objects Query Language - Linguagem de consulta de objetos de dados de Java) para implementar os métodos localizador e seletor.
A caixa de diálogo Consultas do localizador/seletor permite fornecer a QL (Query Language - Linguagem de consulta) do JDO para métodos de consulta de persistência gerenciada por recipiente. A QL JDO permite que o fornecedor do Bean especifique a semântica dos métodos de consulta de maneira portável.
Na caixa de propriedades, você pode especificar os seguintes elementos da consulta:
Nome do método. Contém o nome do método do campo da consulta.
Parâmetros de consulta. Especifica o nome e tipo de um ou mais parâmetros de entrada para consultas. A declaração do parâmetro é uma seqüencia de caracteres contendo uma ou mais declarações de tipo do parâmetro separadas por vírgulas. Ela obedece a sintaxe de Java para assinaturas de método.
Filtro da consulta. Expressão do tipo Java que especifica uma condição que deve ser satisfeita por todos os objetos resultantes da consulta. Corresponde à expressão "WHERE" na QL EJB.
Variáveis da consulta. Especifica o nome e tipo de uma ou mais variáveis da consulta. Obedece a sintaxe das variáveis locais na linguagem de Java. As variáveis de identificação designam as instâncias de um tipo de esquema abstrato de um determinado Bean de entidade.
Ordem da consulta. Especifica a expressão da ordem da consulta. Corresponde à expressão "ORDER BY" da QL EJB. A especificação da ordem é uma seqüência de caracteres que contém uma lista de expressões separadas por vírgulas, todas com indicadores crescente/decrescente.
Os métodos localizadores permitem que os resultados de uma consulta QL JDO sejam usados pelos clientes do Bean de entidade. Os métodos localizadores são definidos na(s) interface(s) inicial(is) de um Bean de entidade e apresentam objetos de entidade ou objetos de entidades locais.
Para obter mais informações e exemplos sobre a sintaxe das consultas, consulte "Configurando consultas dos localizadores 1.1" no Guia do desenvolvedor do servidor da aplicativos Sun Java System.