NHibernate Issues之1902：示例查询(Query By Example)

本节内容

• 概览
• 实例
• 参考资料

概览

这个系列是以博客形式整理关于NHibernate的Issues。记录一些零碎的小例子，通过零零碎碎的整理，可以巩固自己的知识和扩展我们的知识面。这些小例子也可以适当的在项目中呈现。

这次看看示例查询(Query By Example) 。按示例查询 (QBE) 搜索机制使用现有对象在数据库中搜索相匹配的对象。

实例

在NHibernate之旅系列文章导航中，我仅是简单介绍了按示例查询使用，没有过多深入，下面结合几个场景整理下。

1.Domain

首先按照DDD思想，先创建一Domain，这里使用组件和嵌套子组件。

public class Componentizable
{
    public Componentizable(){}
    public Componentizable(string name, string subName, string subName1)
    {
        Component = new Component
                        {
                            Name = name,
                            SubComponent = new SubComponent
                                               {
                                                   SubName = subName,
                                                   SubName1 = subName1
                                               }
                        };
    }

    public virtual int Id { get; set; }
    public virtual Component Component { get; set; }
    public virtual string NickName { get; set; }
}

public class Component
{
    public virtual string Name { get; set; }
    public virtual SubComponent SubComponent { get; set; }
}

public class SubComponent
{
    public virtual string SubName { get; set; }
    public virtual string SubName1 { get; set; }
}

2.Mapping

映射这个Domain：

<class name="Componentizable">
    <id name="Id">
        <generator class="native"/>
    </id>
    <property name="NickName"/>
    <component name="Component" access="property" class="Component">
        <property name="Name"/>
        <component name="SubComponent" class="SubComponent">
            <property name="SubName"/>
            <property name="SubName1"/>
        </component>
    </component>
</class>

3.Test

先创建三个实例：

var master1 = new Componentizable("nhibernate", "ORM tool", "ORM tool1");
var master2 = new Componentizable("nhibernate", "open source", "open source1");
var master3 = new Componentizable("nhibernate", null, null);

测试1：按照传入的对象，启用Like模糊匹配查询数据库相似的数据。

//传入一个Domain实例
var master = new Componentizable("nhibernate", null, "ope%");
//按照这个Domain实例匹配查询数据库
var result = s.CreateCriteria<Componentizable>()
    .Add(Example.Create(master).EnableLike())
    .List<Componentizable>();

看看SQL生成，使用了like关键字。查询出1笔记录

测试2：按照传入的对象，启用Like模糊前匹配查询数据库相似的数据。

//传入一个Domain实例
var master = new Componentizable("nhib", null, "open source1");
 //按照这个Domain实例匹配查询数据库
var result = s.CreateCriteria<Componentizable>()
    .Add(Example.Create(master).EnableLike(MatchMode.Start))
    .List<Componentizable>();

（一条记录）

测试3：看看后匹配

var master =new Componentizable("nate", null, "ORM tool1");
//按照这个Domain实例匹配查询数据库
var result = s.CreateCriteria<Componentizable>()
    .Add(Example.Create(master).EnableLike(MatchMode.End))
    .List<Componentizable>();

（一条记录）

测试4：全匹配

var master = new Componentizable("bern", null, null);
var result = s.CreateCriteria<Componentizable>()
    .Add(Example.Create(master).EnableLike(MatchMode.Anywhere))
    .List<Componentizable>();

（三条记录）

测试5：查询不匹配的数据

var master = new Componentizable("nhibernate", null, "ope%");

var result = s.CreateCriteria<Componentizable>()
    .Add(Restrictions.Or(
               Restrictions.Not(Example.Create(master).EnableLike()), 
               Example.Create(master).EnableLike()))
    .List<Componentizable>();

（两条记录）

测试6：查询匹配示例，但是某些属性除外，这里排除组件。

var master = new Componentizable("nhibernate", null, "ope%");
var result = s.CreateCriteria<Componentizable>()
    .Add(Example.Create(master).EnableLike()
    .ExcludeProperty("Component.SubComponent"))
    .List<Componentizable>();

（三条记录）

测试7：查询匹配示例，但是某个属性除外

var master2 = new Componentizable("nhibernate", "ORM tool", "fake stuff");
var result2 = s.CreateCriteria<Componentizable>()
    .Add(Example.Create(master2).EnableLike()
    .ExcludeProperty("Component.SubComponent.SubName1"))
    .List<Componentizable>();

（一条记录）

那么按照示例查询到底用在什么地方呢？想想以下几个场景：

我们知道某个对象的几个属性，并不知道其主键，想获取这个对象。

我们的方法参数使用对象传递。

我们在界面中常常看见的选择器、筛选器。

我们按照对象的某个/些属性匹配搜索，有时我们也不需要匹配一些属性。

等等场景......

参考资料

李永京：NHibernate之旅(8)：巧用组件之依赖对象

李永京：NHibernate之旅(4)：探索查询之条件查询(Criteria Query)