📄 querycriteria.html
字号:
<html><head> <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> <title>第 12 章 条件查询(Criteria Query)</title><link rel="stylesheet" href="../shared/css/html.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.65.1"><link rel="home" href="index.html" title="HIBERNATE - 符合Java习惯的关系数据库持久化"><link rel="up" href="index.html" title="HIBERNATE - 符合Java习惯的关系数据库持久化"><link rel="previous" href="queryhql.html" title="第 11 章 Hibernate查询语言(Query Language), 即HQL"><link rel="next" href="querysql.html" title="第 13 章 原生SQL查询"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">第 12 章 条件查询(Criteria Query)</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="queryhql.html">上一页</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="querysql.html">下一页</a></td></tr></table><hr></div><div class="chapter" lang="zh-cn"><div class="titlepage"><div><div><h2 class="title"><a name="querycriteria"></a>第 12 章 条件查询(Criteria Query)</h2></div></div><div></div></div><p> 现在Hibernate也支持一种直观的、可扩展的条件查询API。目前为止，这个API还没有更成熟的HQL查询那么强大，也没有那么多查询能力。特别要指出，条件查询也不支持投影（projection）或统计函数（aggregation）。 </p><div class="sect1" lang="zh-cn"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="querycriteria-creating"></a>12.1. 创建一个<tt class="literal">Criteria</tt>实例</h2></div></div><div></div></div><p> <tt class="literal">net.sf.hibernate.Criteria</tt>这个接口代表对一个特定的持久化类的查询。<tt class="literal">Session</tt>是用来制造<tt class="literal">Criteria</tt>实例的工厂。 </p><pre class="programlisting">Criteria crit = sess.createCriteria(Cat.class);crit.setMaxResults(50);List cats = crit.list();</pre></div><div class="sect1" lang="zh-cn"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="querycriteria-narrowing"></a>12.2. 缩小结果集范围</h2></div></div><div></div></div><p> 一个查询条件(Criterion)是<tt class="literal">net.sf.hibernate.expression.Criterion</tt>接口的一个实例。类<tt class="literal">net.sf.hibernate.expression.Expression</tt>定义了获得一些内置的<tt class="literal">Criterion</tt>类型。 </p><pre class="programlisting">List cats = sess.createCriteria(Cat.class) .add( Expression.like("name", "Fritz%") ) .add( Expression.between("weight", minWeight, maxWeight) ) .list();</pre><p> 表达式（Expressions）可以按照逻辑分组. </p><pre class="programlisting">List cats = sess.createCriteria(Cat.class) .add( Expression.like("name", "Fritz%") ) .add( Expression.or( Expression.eq( "age", new Integer(0) ), Expression.isNull("age") ) ) .list();</pre><pre class="programlisting">List cats = sess.createCriteria(Cat.class) .add( Expression.in( "name", new String[] { "Fritz", "Izi", "Pk" } ) ) .add( Expression.disjunction() .add( Expression.isNull("age") ) .add( Expression.eq("age", new Integer(0) ) ) .add( Expression.eq("age", new Integer(1) ) ) .add( Expression.eq("age", new Integer(2) ) ) ) ) .list();</pre><p> 有很多预制的条件类型（<tt class="literal">Expression</tt>的子类）。有一个特别有用，可以让你直接嵌入SQL。 </p><pre class="programlisting">List cats = sess.createCriteria(Cat.class) .add( Expression.sql("lower($alias.name) like lower(?)", "Fritz%", Hibernate.STRING) ) .list();</pre><p> 其中的<tt class="literal">{alias}</tt>是一个占位符，它将会被所查询实体的行别名所替代。(原文:The <tt class="literal">{alias}</tt> placeholder with be replaced by the row alias of the queried entity.) </p></div><div class="sect1" lang="zh-cn"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="querycriteria-ordering"></a>12.3. 对结果排序</h2></div></div><div></div></div><p> 可以使用<tt class="literal">net.sf.hibernate.expression.Order</tt>对结果集排序. </p><pre class="programlisting">List cats = sess.createCriteria(Cat.class) .add( Expression.like("name", "F%") .addOrder( Order.asc("name") ) .addOrder( Order.desc("age") ) .setMaxResults(50) .list();</pre></div><div class="sect1" lang="zh-cn"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="querycriteria-associations"></a>12.4. 关联（Associations）</h2></div></div><div></div></div><p> 你可以在关联之间使用<tt class="literal">createCriteria()</tt>，很容易地在存在关系的实体之间指定约束。 </p><pre class="programlisting">List cats = sess.createCriteria(Cat.class) .add( Expression.like("name", "F%") .createCriteria("kittens") .add( Expression.like("name", "F%") .list();</pre><p> 注意，第二个<tt class="literal">createCriteria()</tt>返回一个<tt class="literal">Criteria</tt>的新实例，指向<tt class="literal">kittens</tt>集合类的元素。 </p><p> 下面的替代形式在特定情况下有用。 </p><pre class="programlisting">List cats = sess.createCriteria(Cat.class) .createAlias("kittens", "kt") .createAlias("mate", "mt") .add( Expression.eqProperty("kt.name", "mt.name") ) .list();</pre><p> （<tt class="literal">createAlias()</tt>）并不会创建一个<tt class="literal">Criteria</tt>的新实例。） </p><p> 请注意，前面两个查询中<tt class="literal">Cat</tt>实例所持有的kittens集合类<span class="emphasis"><em>并没有</em></span>通过criteria预先过滤！如果你希望只返回满足条件的kittens,你必须使用<tt class="literal">returnMaps()</tt>。 </p><pre class="programlisting">List cats = sess.createCriteria(Cat.class) .createCriteria("kittens", "kt") .add( Expression.eq("name", "F%") ) .returnMaps() .list();Iterator iter = cats.iterator();while ( iter.hasNext() ) { Map map = (Map) iter.next(); Cat cat = (Cat) map.get(Criteria.ROOT_ALIAS); Cat kitten = (Cat) map.get("kt");}</pre></div><div class="sect1" lang="zh-cn"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="querycriteria-dynamicfetching"></a>12.5. 动态关联对象获取（Dynamic association fetching）</h2></div></div><div></div></div><p> 可以在运行时通过<tt class="literal">setFetchMode()</tt>来改变关联对象自动获取的策略。</p><pre class="programlisting">List cats = sess.createCriteria(Cat.class) .add( Expression.like("name", "Fritz%") ) .setFetchMode("mate", FetchMode.EAGER) .setFetchMode("kittens", FetchMode.EAGER) .list();</pre><p> 这个查询会通过外连接(outer join)同时获得 <tt class="literal">mate</tt>和<tt class="literal">kittens</tt>。 </p></div><div class="sect1" lang="zh-cn"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="querycriteria-examples"></a>12.6. 根据示例查询（Example queries）</h2></div></div><div></div></div><p> <tt class="literal">net.sf.hibernate.expression.Example</tt>类允许你从指定的实例创造查询条件。 </p><pre class="programlisting">Cat cat = new Cat();cat.setSex('F');cat.setColor(Color.BLACK);List results = session.createCriteria(Cat.class) .add( Example.create(cat) ) .list();</pre><p> 版本属性，表示符属性和关联都会被忽略。默认情况下，null值的属性也被排除在外。 </p><p> You can adjust how the <tt class="literal">Example</tt> is applied. 你可以调整<tt class="literal">示例(Example)</tt>如何应用。 </p><pre class="programlisting">Example example = Example.create(cat) .excludeZeroes() //exclude zero valued properties .excludeProperty("color") //exclude the property named "color" .ignoreCase() //perform case insensitive string comparisons .enableLike(); //use like for string comparisonsList results = session.createCriteria(Cat.class) .add(example) .list();</pre><p> 你甚至可以用示例对关联对象建立criteria。 </p><pre class="programlisting">List results = session.createCriteria(Cat.class) .add( Example.create(cat) ) .createCriteria("mate") .add( Example.create( cat.getMate() ) ) .list();</pre></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="queryhql.html">上一页</a> </td><td width="20%" align="center"><a accesskey="u" href="index.html">上一级</a></td><td width="40%" align="right"> <a accesskey="n" href="querysql.html">下一页</a></td></tr><tr><td width="40%" align="left" valign="top">第 11 章 Hibernate查询语言(Query Language), 即HQL </td><td width="20%" align="center"><a accesskey="h" href="index.html">起始页</a></td><td width="40%" align="right" valign="top"> 第 13 章 原生SQL查询</td></tr></table></div></body></html>⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -