You open this property editor from the EJB1.1 Finder Queries tab in the Entity Bean pane of the sun-ejb-jar.xml
visual editor.
The Sun Java System Application Server uses an extension of Java Data Objects Query Language (JDOQL)
queries to implement finder and selector methods.
The Finder/Select Queries dialog enables you to provide the JDO Query Language (QL)
for Container-Managed Persistence Query Methods. JDO-QL enables the Bean Provider to
specify the semantics of query methods in a portable way.
In the property box you can specify the following elements of the query:
Method Name. This contains the method name for the query field.
Query Params. Specifies the name and the type of one or more query input parameters.
The parameter declaration is a String containing one or more parameter type declarations separated by commas.
This follows the Java syntax for method signatures.
Query Filter. A Java-like expression that specifies a condition that each object returned
by the query must satisfy. Corresponds to the WHERE clause in EJB QL.
Query Variables. Specifies the name and type of one or more query variables.
Follows the syntax for local variables in the Java language. Identification variables designate
instances of a particular entity bean abstract schema type.
Query Ordering. Specifies the ordering expression of the query. Corresponds to the
ORDER BY clause of EJBQL. An ordering specification is a String that contains a list of comma-separated
expressions, each with an ascending/descending indicator.
Finder methods allow the results of an JDO QL query to be used by the clients of the entity bean.
Finder methods are defined in the home interface(s) of an entity bean and return entity objects or
local entity objects.
For more on query syntax and examples,
see "Configuring Queries for 1.1 Finders" in
the Sun Java System Application Server Developer's
Guide.