EJB QL是基于EJB2.1容器管理持久性类型模型而设计的类型表达式语言。每个EJB QL表达式都拥有类型。表达式的类型取决于表达式的结构、标记变量声明（indetification variable declaration）的抽象模式类型、对cmp-field和cmr-field的进行求值的类型和字面值的类型。EJB QL中容许类型是Entity Bean的抽象模式类型和cmp-field的定义类型。

由Entity Bean类和部署描述中提供的信息得到Entity Bean的抽象模式类型。抽象模式类型和Entity Bean之间存在一对一的关系。定义在abstract-schema-name部署描述元素中的抽象模式的名字，用于在EJB QL中标识抽象模式类型。

抽象模式类型拥有以下特征：

EJB QL查询的范围，由同一个部署描述中的所有容器管理持久性的Entity Bean组成。

EJB QL查询的可定位范围，由Entity Bean抽象模式类型中的cmr-field决定。使用cmr-field，查询可以选取关联的Entity Bean和在查询中使用关联的Entity Bean的抽象模式类型。

在EJB QL查询字符串中使用Entity Bean的抽象模式名来指定Entity Bean。

在部署过程中，开发者需要为每个容器管理持久性的Entity Bean分配一个唯一的抽象模式名字，以在查询中使用此名字来指定Entity Bean。名字的作用域范围在整个部署描述文件之内。

本节中所使用的Entity Bean范例名字遵循如下约定：Entity Bean使用<name>EJB方式进行命名，Entity Bean类和抽象模式类型使用<name>方式进行命名。如表示订单的Entity Bean命名为OrderEJB，其Entity Bean类和抽象模式类型名称为Order。

例如某个部署描述文件中包含如下几个Entity Bean，OrderEJB、ProductEJB、LineItemEJB、ShippingAddressEJB和BillingAddressEJB，对应的抽象模式类型名字为Order、Product、LineItem、ShippingAddress和BillingAddress。只有OrderEJB和ProductEJB拥有远程和远程Home接口。

以上Entity Bean之间的关系如下图：

范例关系图

开发者可以通过Order和LineItem中定义的cmr-field和cmp-field，为OrderEJB定义finder查询，查找所有未完成的Order的finder查询可用如下方式编写：

SELECT DISTINCT OBJECT(o)
FROM Order AS o, IN(o.lineItems) AS l
WHERE l.shipped = FALSE

查询定位到Order抽象模式类型中的cmr-field域lineItems，并在其中中遍历对lineItems进行查找，并使用LineItem中的cmp-field域shipped选择至少有一个lineItem未发送的Order的集合。

尽管上面的例子使用了如SELECT、DISTINCT、OBJECT、FROM、AS、IN、WHERE和FALSE等大写的保留字，但是，EJB QL中的保留字是大小写无关的。

上例中的SELECT子句指定了查询的返回值类型是Order，如这个查询语句用于定义一个在Entity Bean的远程Home接口中的finder方法，则对应于由查询所选取的抽象模式类型实例，方法返回值类型为Entity Bean的远程接口类型。如这个查询语句用于定义一个在Entity Bean的本地Home接口中的finder方法，则方法返回值类型为Entity Bean的本地接口类型。

因为同一个部署描述中定义了相关的Entity Bean的抽象持久模式，所以同样可以在OrderEJB的查询中使用ProductEJB的抽象模式类型，也可使用Order和Product抽象模式类型中的cmp-field和cmr-field。例如，Product抽象模式类型中包含一个product_type的cmp-field，OrderEJB中的finder查询可以使用这个cmp-field。如“查找包含产品种类为‘办公用品’的订单”，则可以用如下查询语句定义查询方法：

SELECT DISTINCT OBJECT(o)
FROM Order o, IN(o.lineItems) l
WHERE l.product.product_type = ‘office_supplies’

通过Order与LineItem、LineItem和Product的关联，Order关联到Product，为表达此查询，必须通过lineItem和product这两个cmr-field进行定位（navigation）。通过在整个语句范围内指定使用OrderEJB的抽象模式名称Order指定了查询的类型。

本部分文档中的余下部分将对本节中的例子进行扩展，以详细说明EJB QL的特性和用法。

EJB QL查询使用Entity Bean的抽象模式类型进行编写。使用SELECT子句指定的返回值类型，应该是Entity Bean的抽象模式类型或者是cmp-field类型。finder和select方法和在部署描述文件中定义的查询语句，决定了finder和select方法返回的结果被映射到何种Java类型。

查询结果如何映射取决于查询语句定义的查询方法是finder方法还是select方法，也取决于finder方法是定义在远程Home接口中还是定义在本地Home接口中。

如前面的例子：“查找包含产品种类为‘办公用品’的订单”

EJB QL的FROM子句通过声明标记变量（indetification variable）定义查询的范围。范围可以使用路径表达式进行限制。

标记变量（indetification variable）指定特定的Entity Bean的抽象模式类型实例。通过在标记变量（indetification variable）之间使用逗号分隔，FROM子句可以包含多个标记变量（indetification variable）。

from_clause ::= 
          FROM identification_variable_declaration 
          [, identification_variable_declaration]*

identification_variable_declaration ::= 
          collection_memeber_declaration |range_member_declaration

collection_member_declaration ::= 
          IN ( colleciton_value_path_expression) [AS] identifier

range_variable_declaration ::= abstract_schema_name [AS] identifier

下面章节讨论FROM子句的构成。

SELECT DISTINCT OBJECT(o)
FROM Order o, IN(o.lineItems) l
WHERE l.product.product_type = ‘office_supplies’

IN(o.lineItems) l

FROM Order AS o, IN(o.lineItems) l

single_valued_path_expression ::= 
    {single_valued_navigation | identification_variable} . cmp_field |
    single_valued_navigation
single_valued_navigation ::=
    identification_variable . [single_valued_cmr_field .]* single_valued_cmr_field
collection_valued_path_expression ::=
    identification_variable . [single_valued_cmr_field .]* collection_valued_cmr_field 

SELECT OBJECT(o)
FROM Order AS o, IN(o.lineItems) l
WHERE l.product.name = ‘widget’

SELECT OBJECT(o)
FROM Customer AS o
WHERE o.info.name = ‘Jim Clark’

where_clause ::= WHERE conditional_expression

conditional_expression ::= 
    conditional_term | conditional_expression OR conditional_term

conditional_term ::= 
    conditional_factor | conditional_term AND conditional_factor
conditional_factor ::= [ NOT ] conditional_test

conditional_test :: = conditional_primary

conditional_primary ::= 
    simple_cond_expression | (conditional_expression)

simple_cond_expression ::= 
    comparison_expression | between_expression | like_expression |
    in_expression | null_comparison_expression |
    empty_collection_comparison_expression | 
    collection_member_expression

arithmetic_expression [NOT] BETWEEN arithmetic-expr AND arithmetic-expr

p.age BETWEEN 15 AND 19

p.age >= 15 AND p.age <= 19

single_valued_path_expression [NOT] IN (string-literal [, string-literal]*)

o.country IN ('UK', 'US', 'France')

(o.country = ’UK’) OR (o.country = ’US’) OR (o.country = ’France’)

o.country NOT IN (’UK’, ’US’, ’France’)

NOT ((o.country = ’UK’) OR (o.country = ’US’) OR (o.country = ’France’))

single_valued_path_expression [NOT] LIKE pattern-value [ESCAPE escape-character]

address.phone LIKE '12%3'

asentence.word LIKE 'l_se'

aword.underscored LIKE '\_%' ESCAPE '\'

address.phone NOT LIKE '12%3'

single_valued_path_expression IS 
						[NOT] NULL
					

collection_valued_path_expression IS [NOT] EMPTY
					

SELECT OBJECT(o)
FROM Order o, IN(o.lineItems) l
WHERE o.lineItems IS EMPTY

{single_valued_navigation | identification_variable | input_parameter}
    [NOT] MEMBER [OF] collection_valued_path_expression

SELECT子句表示查询的结果。因为finder方法不能返回任意类型的值，定义fnder方法的查询语句中的SELECT子句必须对应finder方法返回的Entity Bean的抽象模式类型；对于select方法，可以返回Entity Bean的抽象模式类型和cmp-field域的值。

SELECT子句的语法如下：

select_clause ::=SELECT [DISTINCT ] {select_expression |OBJECT (identification_variable)}
select_expression ::= single_valued_path_expression | aggregate_select_expression
aggregate_select_expression ::=
{AVG |MAX |MIN |SUM |COUNT }( [DISTINCT ] cmp_path_expression) |
COUNT ( [DISTINCT ] identification_variable | single_valued_cmr_path_expression)

SELECT子句中所有的标记变量（indetification variable）必须使用OBJECT运算符进行限制。SELECT子句中不能使用OBJECT运算符对路径表达式进行限制。

DISTINCT关键字从查询结果中删除重复的值。

如应用查询语句的方法返回值类型是java.util.Collection，如查询语句中未使用DISTINCT关键字，则返回的集合中可包含重复的元素；如方法的返回值类型是java.util.Set，查询语句中未使用DISTINCT关键字，则返回的集合中也不包含重复的元素。

例子:

SELECT l.product FROM Order AS o, IN(o.lineItems) l

注意SELECT子句必须指定返回的是一个单值表达式。下例是无效的查询语句：

SELECT o.lineItems FROM Order AS o

如希望通过比较多个Entity Bean抽象模式类型来选取值，则需要在FROM子句中声明多个抽象模式类型的标记变量（indetification variable）。

下面的finder方法的查询语句返回订单数量大于John Smith的订单数量的订单。本例中使用了两个不同的标记变量（indetification variable），都使用Order抽象模式类型。

SELECT DISTINCT OBJECT(o1)
FROM Order o1, Order o2
WHERE o1.quantity > o2.quantity AND
    o2.customer.lastname = ‘Smith’ AND
    o2.customer.firstname= ‘John’

下例返回订单的所有订单项：

SELECT OBJECT(l)
FROM Order o, IN(o.lineItems) l

下例返回所有的订单项：

SELECT OBJECT(l)
FROM LineItems AS l

ORDER BY字句的作用是对查询返回的对象或值进行排序。

ORDER BY字句的语法如下：

orderby_clause ::=ORDER BY orderby_item [, orderby_item]*
orderby_item ::= cmp_path_expression [ASC | DESC]

当使用了ORDER BY字句时，SELECT字句必须符合以下形式：

ORDER BY字句的排序项必须是SELECT 字句中的返回项或返回对象所包含的字段。

举例：以下前两个EJB QL表达式是正确的，后两个是错误的

SELECT OBJECT(o)
FROM Customer c, IN(c.orders) o
WHERE c.address.state = ‘CA’
ORDER BY o.quantity, o.totalcost

SELECT o.quantity
FROM Customer c, IN(c.orders) o
WHERE c.address.state = ‘CA’
ORDER BY o.quantity

SELECT l.product.product_name
FROM Order o, IN(o.lineItems) l
WHERE o.customer.lastname = ‘Smith’ AND o.customer.firstname = ‘John’
ORDER BY l.product.price

SELECT l.product.product_name
FROM Order o, IN(o.lineItems) l
WHERE o.customer.lastname = ‘Smith’ AND o.customer.firstname = ‘John’
ORDER BY o.quantity

如果在ORDER BY字句中有多个排序项（对应sql中有多个排序字段），排序规则是从左到右进行处理的。

ASC表示升序，DESC表示降序，默认是ASC

当记录中排序项的值存在null值时，这些记录排在所有非空值记录的前面或者排在所有非空值记录后面。

当引用的对象不存在持久存储中，其值被视为NULL。SQL92中的NULL的语义定义了对包含NULL值的条件表达式的求值方式。

下面是这些语义的简短说明：

EJB QL只允许能对其使用like运算符的类型的值进行比较。但这个规则有一个例外，近似数字和精确数字是可以比较的（Java的数值提升提供了必要的类型转换）。

包括上文中提到的NULL值的例外，值的比较必须考察Java语言中的相关语义。例如，使用Java基本（primitive type）类型定义的cmp-field，不能假定其为NULL值。如此cmp-field域需要使用NULL值，则必须使用对应的引用（reference type）类型，如使用Integer替代int。持久存储中的存储机制不影响对字符串的比较，如数据填充（padding）的因素。当且仅当字符串包含同样的字符序列时，才可以决定两个字符串相等，这点与标准的SQL不同。

当且仅当同样抽象模式类型的Entity对象的Primary Key相等，才可以决定它们是相等的。

日期和时间值应使用Java标准中的long类型的值，使用毫秒为单位。生成毫秒值的标准方法是使用java.util.Carlendar。

尽管SQL支持在算术表达式中，进行定点十进制数的比较。但是EJB QL并不支持。因为EJB QL限制精确数字类型的数字字面值中不可包含小数点（并且使用小数点作为近似类型数字的表示）。

字符串和布尔值的比较只能使用=，和<>。

在EJB QL查询语句中不能使用注释。

容器管理持久性的数据模型目前不支持继承。因此，不同类型的Entity对象或值不能进行比较。包含此类比较操作的查询语句无效。

查找所有订单：

SELECT OBJECT(o)
FROM Order o

查找所有需要运到加里福利亚的订单：

SELECT OBJECT(o)
FROM Order o
WHERE o.shipping_address.state = ‘CA’

查找所有订单涉及的州：

SELECT DISTINCT o.shipping_address.state
FROM Order o

查找有line item的订单：

SELECT DISTINCT OBJECT(o)
FROM Order o, IN(o.lineItems) l

查找没有line item的订单：

SELECT OBJECT(o)
FROM Order o
WHERE o.lineItems IS EMPTY

查找未完成订单：

SELECT DISTINCT OBJECT(o)
FROM Order o, IN(o.lineItems) l
WHERE l.shipped = FALSE

查找所有发货地址与收款地址不一样的订单，本例假定发货地址与收款地址都使用Entity Bean：

SELECT OBJECT(o)
FROM Order o
WHERE
    NOT (o.shipping_address.state = o.billing_address.state AND
    o.shipping_address.city = o.billing_address.city AND
    o.shipping_address.street = o.billing_address.street)

如果在两个不同的关系中发货地址与收款地址使用相同的Entity Bean表示，基于第 44.7.2.5.7.10 节 “NULL比较表达式”中的定义，以上查询可以简化为：

SELECT OBJECT(o)
FROM Order o
WHERE o.shipping_address <> o.billing_address

查询所有包含书名为“EJB deveplopment”的书的订单：

SELECT DISTINCT OBJECT(o)
FROM Order o, IN(o.lineItems) l
WHERE l.product.type = ‘book’ AND
    l.product.name = ‘Applying Enterprise JavaBeans:
    Component-Based Development for the J2EE Platform’

查询名字由输入参数指定的所有订单：

SELECT DISTINCT OBJECT(o)
FROM Order o, IN(o.lineItems) l
WHERE l.product.name = ?1

对于此查询，参数必须是产品名称的类型，java.lang.String。

下面查询演示值的选取而非Entity Bean的选取：

选取所有已被定购的产品的名称：

SELECT DISTINCT l.product.name
FROM Order o, IN(o.lineItems) l

以下查询在一个指定订单号码的订单中查找所有包含产品的产品名称。订单号码由一个输入参数指定，并且订单号码是订单的Primary Key。

SELECT l.product.name
FROM Order o, IN(o.lineItems) l
WHERE o.ordernumber = ?1

EJB QL与SQL相似，将FROM子句作为笛卡尔积，与SQL一样，即使未使用WHERE子句，已声明的标记变量（indetification variable）也会影响查询的结果。必须小心地定义标记变量，因为已声明类型的值是否存在，决定了查询的范围。

例如，下面的FROM子句定义了对订单的查询，订单必须包含line item和包含已有产品。如持久存储中不存在产品实例，查询的范围为空且不选取订单。

SELECT OBJECT(o)
FROM Order AS o, IN(o.lineItems) l, Product p