kodojdo指南十一章

第十一章  查询

  你可以从PersistenceManager中得到查询实例.查询可以筛选符合某些标准的一批候选对象.这个筛选过程可能在数据库中进行,或者在内存中执行.JDO没有明文规定查询机制.许多JDO实现品会根据情况混合使用内存执行方式和数据库执行方式.
  现在开始研究查询接口.你会发现自己对将讨论的东西迷惑不解.这是可预料的.我们会通过一些具体的例子来说明.

11.1 必需的查询元素

  每个查询都有三个必需元素:
  1)候选类.查询的筛选是针对候选类或子类的实例进行的.候选类通过setClass 方法指定.
  2)一批候选类.候选者可以是对象的集合形式或者扩展.这两种情况都可以调用setCandidate 指定候选者.如果给出了扩展,那么不必再个别地指定查询的候选类.查询会自动继承扩展的候选类.(??翻译得不好)
  3)筛选条件.这是用JDO查询语言JDOQL编写并通过setFilter 方法指定的字符串.如果不指定筛选条件,那么查询会返回候选类的所有对象.

11.2 可选的查询元素
  以下是JDO查询的可选元素
  1)Imports.导入通过declareImports 方法指定.根据标准的java导入语法,导入是单一的由";"划分的字符串.在声明参数和变量的时候,使用导入你就不必输入类的全名.
  2)参数声明.参数是筛选字符串里的一个占位符.它允许你写一次查询,然后多次执行.每次都提供新值参数通过.declareParameters 方法指定,这个方法的参数语法和JVA方法的参数声明语法一致.
  3)变量声明.变量用来检测集合里的一些项是否匹配某些条件.通过declareVariables 方法来指定.语法和标准java变量声明语法一致.
  4)排序.有时你希望查询的结果按照指定的顺序返回.例如,你想待售轿车按照价格的升序列出,setOrdering 方法允许你添加查询的排序标准.方法的字符串参数是排序声明根据","分隔的列表.每个声明由字段名加关键字"ascending" 或者"descending"组成.结果会先按第一个(最左边那个)排序声明排序,此后假如有两个记录符合表达式,第二个排序就会执行.以此类推.

11.3 JDOQL

  JDOQL是基于JAVA布尔表达式的数据库无关的查询语言.语法类似JAVA标准语法,只有如下几点例外:
  基本类型和基本类型包装的相等和排序比较是有效的

  日期之间的相等和排序比较是有效的
  
  相等比较通常使用"=="操作符,不支持equals方法.

  不支持.(=, +=, *=, etc) 和 ++ 和 -- 等赋值操作符

  只支持以下方法:Collection.contains ,Collection.isEmpty ,String.startsWith 和String.endsWith

  翻转null值的字段,会抛出NullPointerException,而不是导致子表达式的值为false

  支持以下字面量:字符,整数,浮点数,布尔值,字符串和null
 
(based on 基于 valid 有效的 Equality comparisons 相等比较 Traverse ?? )

  我们会给出一些关于查询接口和JDOQL的例子.该例使用以下的能持久类.

  找出所有price字段值大于10的magazine对象.注意我们可以在筛选字符串中使用候选类的持久化字段.JDOQL 仅仅基于对象模型,而不是数据库所提供的类的具体体现.

  找出title字段以"The"开头的magazine类,以price的升序排序.

 
  找出销售额大于出版商税收的0.01倍的所有magazine.以出版商的revenue 字段的升序和publisher 的name字段的降序排列.注意"."号用法,从publisher中取出revenue和name字段.

  找出所有price 小于等于10出版商是Random House或者Addison Wesley的magazine

  找出这样的magazine:由给出的公司印刷.price大于给出的数目.注意公司名和数字在查询字符串作为占位符体现.在查询没有执行前,不提供值.并且我们使用"导入"导入org.mag.pub包,然后我们可以声明类型是company的参数.我们也可以不使用导入方法,指定类的全名来声明参数.

  找出这样的magazine:封面文章有个"The Real Story"的子标题或者封面文章没有子标题

  找出这样的magazine:有篇文章的标题是"Fourier Transforms",注意变量的用法.代表magezine的文章集合的任一文章.
 
  找出这样的magazine:它的article的title是一批可能的title的其中一个.在这里我们使用集合参数保存所有可能的值,这是sql中in 的用法.

11.4 执行查询

  正如上面显示那样,查询接口有许多执行查询的方法.各个查询方法使用的参数不等.从0个到三个.如果查询超过三个参数,你可以使用executeWithArray 和executeWithMap 方法.详情参看查询接口的javadoc文档
  所有执行方法返回object类型.但事实上它们返回集合.JDO使用object而不是集合的,使厂商可以在某些情况下返回特定的类型,并且允许将来的扩充.

  查询结果会占用数据库资源.所以当查询不再使用的时候最好把它关闭.你可以关闭个别的查询也可以关闭所有已打开的查询.

11.5 查询编译

  查询对象可以通过compile 方法编译.这意味着可以优化已计划的查询.编译期间,所有查询元素都是有效的,任何不一致性都会抛出JDOUserException.
  查询实例也可以序列化.在序列化之后,查询不能被执行.不过它还保留它的候选类,筛选字符串,导入,参数,变量和派讯.一个已序列的查询可以作为相同的配置下创建其他查询的模板.这是通过PersistenceManager的newQuery(Object template)方法来完成