Instant EJB QL API Reference

본 부록에서는 Instant EJB QL API Reference로 메소드와 인터페이스의 사용법에 대해서 설명한다.

1. 개요

EJB QL API는 EJB 클라이언트 애플리케이션 개발자가 클라이언트의 코드에 직접 EJB QL 질의를 지정하여 EJB finder 메소드들이 가지는 제약점을 극복할 수 있도록 한다. 이 API는 단 하나의 인터페이스와 하나의 메소드로 구성되어 있다.

API의 사용은 아주 극단적인 상황에서만 사용되어야 한다. 이 API는 표준 EJB Entity finder 메소드보다 고정적이고 다소 비효율적이다.

2. EJBInstanceFinder Interface

interface jeus.ejb.bean.objectbase.EJBInstanceFinder

이 인터페이스는 jeus-ejb-dd.xml 파일의 <enable-instant-ql> element가 true로 설정되어 있는 환경에서 CMP 2.0 Entity Bean의 home Interface에 의해 구현된다. 이 인터페이스는 클라이언트 코드 내에 임의의 EJB QL 질의를 직접 삽입할 수 있도록 한다.

public abstract interface EJBInstanceFinder extends Remote

3. EJBInstanceFinder Method

java.util.Collection findWithInstantQL(java.util.Collection findWithInstantQL)

  • 사용법

    "ejbQlQuery" 파라미터로 표현된 EJB QL 질의에 해당하는 Bean의 EJB 집합을 리턴한다.

    java.util.Collection findWithInstantQL (String ejbQlQuery)

  • 파라미터

    파라미터 설명

    string ejbQlQuery

    유효한 EJB QL 문장으로 "?"가 없는 것이어야 한다. 이 문법은 JEUS에서 정의한 EJB QL 3가지 추가 사항의 대상 중 하나이다.

  • 반환값

    반환값 설명

    java.util.Collection

    질의에 답에 해당하는 Bean Interface의 집합이다.

  • 예외

    • FinderException

    • RemoteException