본 부록에서는 Instant EJB QL API Reference로 메소드와 인터페이스의 사용법에 대해서 설명한다.
EJB QL API는 EJB 클라이언트 애플리케이션 개발자가 클라이언트 측 코드에 직접 EJB QL 질의를 지정하여 EJB finder 메소드들이 가지는 제약점을 극복할 수 있도록 한다.
이 API의 사용은 아주 극단적인 상황에서만 사용되어야 한다. 이 API는 표준 EJB Entity finder 메소드보다 고정적이고 다소 비효율적이다.
이 API는 단 하나의 인터페이스와 하나의 메소드로 구성되어 있다.
이 인터페이스는 jeus-ejb-dd.xml 파일의 enable-instant-ql element가 “true”로 설정되어 있는 환경에서 CMP 2.0 Entity Bean의 home Interface에 의해서 구현된다. 이 인터페이스는 클라이언트 코드 내에 임의의 EJB QL 질의를 직접 넣을 수 있도록 한다.
public abstract interface EJBInstanceFinder extends Remote
사용법
“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