康器 发表于 2025-5-29 15:00:43

NHibernate拾贝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)

来源:程序园用户自行投稿发布,如果侵权,请联系站长删除
免责声明:如果侵犯了您的权益,请联系站长,我们会及时删除侵权内容,谢谢合作!
页: [1]
查看完整版本: NHibernate拾贝1902:示例查询(Query By Example)