Query 介绍
你可以通过PersistenceManager获得一个Query对象。Query对象用于从持久化对象中查询数据。下面我们将详细的讨论Query中的每个部分。
1． 必须的Query元素
public void setClass (Class candidateClass);
public void setCandidates (Extent candidates);
public void setCandidates (Collection candidates);
public void setFilter (String filter);
Query有3个必须的元素：
1) 候选类：用于查询的候选类或子类，这个候选类通过setClass方法设置。
2) 候选对象集合：候选类可以被置于一个集合中或是一个Extent中，你可以通过setCandidates方法来设置他们。
3) 查询字符串：这是一个JDOQL字符串，你可以通过setFilter来设置它。
2． 可选的Query元素
public void declareImports (String imports);
public void declareParameters (String parameters);
public void declareVariables (String variables);
public void setOrdering (String ordering);
Query有4个可选的元素：
1） Import：它可以通过declareImports来设置，这个字符串是几个由分号格开的标准的Javaa Import语法，这和JSP中的@page import=””语法相似。通过这个设置你就可以不必把输出的类名全部列处理。
2） 参数声明：用于设置Query的查询参数，可以通过declareParameters设置。
3） 变量声明：用于设置Query查询参数的值，可以通过declareVariables设置。
4） 排序：设置返回的查询结果的排序方式,含义相当于sql语言中的order by，可以通过setOrdering设置。
3． JDOQL
JDOQL是一个与具体数据库无关的查询语言，它和标准的SQL语法非常类似，但也有一些不同：
1） 允许原始类型和原始类型的封装类的比较和排序。
2） 允许Date对象的比较和排序。
3） 比较操作使用“==”，不支持equals比较操作。
4） 不支持=, +=, *=,++ 和—等操作
5） 不支持除了下面以为的方法：
Collection.contains
Collection.isEmpty
String.startsWith
String.endsWith
6） 如果得到一个空值将抛出NullPointException异常。
现在我们将举例说明JDOQL和Query的使用，它将使用下面的持久化类
package org.mag;
public class Magazine
{
private String title;
private double price;
private int copiesSold;
private Company publisher;
private Article coverArticle;
private Set articles;
...
}
public class Article
{
private String title;
private Collection subTitles;
...
}
package org.mag.pub;
public class Company
{
private String name;
private double revenue;
...
}
例1：最基本的查询
查询价格大于10元的杂志（Magazine）。注意我们也可以在查询字符中使用持久化类的持久字段。
Extent mags = pm.getExtent (Magazine.class, false);
String filter = "price > 10.0";
Query query = pm.newQuery (mags, filter);
Collection results = (Collection) query.execute ();
例子2：排序和方法调用
查询以The开头的记录并按升序排列结果。
Extent mags = pm.getExtent (Magazine.class, false);
String filter = "title.startsWith (\"The \")";
Query query = pm.newQuery (mags, filter);
query.setOrdering ("price ascending");//按升序排列
Collection results = (Collection) query.execute ();
例子3：精确操作和关系遍历
Extent mags = pm.getExtent (Magazine.class, false);
String filter = "price * copiesSold > publisher.revenue * .01";
Query query = pm.newQuery (mags, filter);
query.setOrdering ("publisher.revenue descending, publisher.name ascending");
Collection results = (Collection) query.execute ();
查询杂志的价格收入大于1％的记录，把价格按降序排列，出版社的名称按升序排列。
例子4：优先和逻辑操作
查询杂志的价格小于等于10元并且出版社的名称是Random House或Addison Wesley的。
Extent mags = pm.getExtent (Magazine.class, false);
String filter = "price <= 10.0 "
+ "&& (publisher.name == \"Random House\" "
+ "|| publisher.name == \"Addison Wesley\")";
Query query = pm.newQuery (mags, filter);
Collection results = (Collection) query.execute ();
例子5：导入和参数
通过给定的公司或价格查询属于这个出版社并且价格大于10元的杂志。
declareImports导入了我们需要的Company类，你要可以通过设置字符串为“import org.mag.pub.Company“只导入一个Company类。
Company myCompany = ...;
Double myPrice = ...;
Extent mags = pm.getExtent (Magazine.class, false);
String filter = "publisher == pub && price > amnt";
Query query = pm.newQuery (mags, filter);
query.declareImports ("import org.mag.pub.*;");
query.declareParameters ("Company pub, Double amnt");
Collection results = (Collection) query.execute (myCompany, myPrice);
例子6：集合
查询杂志的中标题包含“The Real Story“或者没有标题的文章。
Extent mags = pm.getExtent (Magazine.class, false);
String filter = "coverArticle.subTitles.contains (\"The Real Story\") "
+ "|| coverArticle.subTitles.isEmpty ()";
Query query = pm.newQuery (mags, filter);
Collection results = (Collection) query.execute ();
例子7：变量
查询标题为“Fourier Transforms“的文章。注意这里的标题使用了一个变量art来代替Article。
Extent mags = pm.getExtent (Magazine.class, false);
String filter = "articles.contains (art) "
+ "&& art.title == \"Fourier Transforms\"";
Query query = pm.newQuery (mags, filter);
query.declareVariables ("Article art");
Collection results = (Collection) query.execute ();
例子8：集合参数
查询文章标题符合条件的记录，可能的标题放到一个集合中，这有点和SQL中in操作类似。
Collection titles = ...; // 可能的标题集合
Extent mags = pm.getExtent (Magazine.class, false);
String filter = "articles.contains (art) "
+ "&& titles.contains (art.title)";
Query query = pm.newQuery (mags, filter);
query.declareParameters ("Collection titles");
query.declareVariables ("Article art");
Collection results = (Collection) query.execute ();
4． 执行查询
public Object execute ();
public Object execute (Object param1);
public Object execute (Object param1, Object param2);
public Object execute (Object param1, Object param2, Object param3);
public Object executeWithArray (Object[] params);
public Object executeWithMap (Map params);
所有的查询都是通过execute执行的，它返回的结果包含在一个Collection集合中，这个集合中包含结果集的对象。你可以通过集合的迭代获得集合中的对象。最后通过close关闭Query
public void close (Object result);
public void closeAll ();
举例：
PersistenceManager pm = ...;
Query query = pm.newQuery (Employee.class, "salary > 50000");
Collection employees = (Collection) query.execute ();
try
{
for (Iterator itr = employees.iterator (); itr.hasNext ();)
processEmployee ((Employee) itr.next ());
}
finally
{
query.close (employees);
}
5． 查询编辑
你可以在查询之前首先使用compile编译查询，这样可以优化你的查询，如果查询语句有问题会抛出JDOUserException异常。
public void compile ();
