Instant EJB QL API Reference

This appendix describes how to use the instant EJB QL API methods and interfaces.

1. Overview

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.

2. EJBInstanceFinder Interface

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

3. EJBInstanceFinder Method

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

    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