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 should be used in a very extreme situation. It is more fixed and less efficient than the standard EJB entity finder method.
The API consists of only one interface and one 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 | Should be an available EJB QL statement without “?”. This syntax is one of the three additions to EJB QL that were defined by JEUS. |
Return Value
Return Value | Description |
---|---|
java.util.Collection | A group of bean interfaces that are part of the query result. |
Exception
FinderException
RemoteException