This appendix describes how to use the instant EJB QL API methods and interfaces.
EJB QL API helps to overcome the shortcomings of an EJB finder method by allowing an EJB client application developer to specify an EJB QL query from client-side code. The API consists of only one interface and one method.
The API should be used in a very extreme situation. It is more fixed and less efficient than the standard EJB entity finder method.
This interface is implemented by the home interface for the CMP 2.0 entity bean, when the enable-instant-ql element of jeus-ejb-dd.xml is set to "true." This interface enables you to specify any EJB QL query from client-side code.
public abstract interface EJBInstanceFinder extends Remote
Usage
Returns the EJB group of the bean which corresponds to an EJB QL query that is specified in the ejbQlQuery parameter.
java.util.Collection findWithInstantQL (String ejbQlQuery)
Parameter
| Parameter | Description |
|---|---|
| string ejbQlQuery | Valid EJB QL statement without “?”. This syntax is one of the three additions to EJB QL defined to JEUS. |
Return Value
| Return Value | Description |
|---|---|
| java.util.Collection | Group of bean interfaces that are part of the query result. |
Exception
FinderException
RemoteException