Appendix B. Instant EJB QL API Reference

Table of Contents

B.1. Overview
B.2. EJBInstanceFinder Interface
B.3. EJBInstanceFinder Method

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.

Note

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.

interface jeus.ejb.bean.objectbase.EJBInstanceFinder

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

java.util.Collection findWithInstantQL

  • 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

    ParameterDescription
    string ejbQlQueryShould 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 ValueDescription
    java.util.CollectionA group of bean interfaces that are part of the query result.
  • Exception

    • FinderException

    • RemoteException