public interface QueryByExampleExecutor<T> { 
<S extends T> S findOne(Example<S> example); //根据“实例”查找一个对象。
<S extends T> Iterable<S> findAll(Example<S> example); //根据“实例”查找一批对象
<S extends T> Iterable<S> findAll(Example<S> example, Sort sort); //根据“实例”查找一批对象，且排序
<S extends T> Page<S> findAll(Example<S> example, Pageable pageable); //根据“实例”查找一批对象，且排序和分页
<S extends T> long count(Example<S> example); //根据“实例”查找，返回符合条件的对象个数
<S extends T> boolean exists(Example<S> example); //根据“实例”判断是否有符合条件的对象
}

@NoRepositoryBean public interface JpaRepository<T, ID extends Serializable> 
　　extends PagingAndSortingRepository<T, ID>, QueryByExampleExecutor<T> {
 ...... 
@Override 
<S extends T> List<S> findAll(Example<S> example); //根据实例查询 
@Override 
<S extends T> List<S> findAll(Example<S> example, Sort sort);//根据实例查询，并排序。 
}

/**
* 客户
*/
@Entity
@Table(name = "demo_lx_Customer")
public class Customer extends BaseBo
{
　　private String name; //姓名
　　private String sex; //性别
　　private int age; //年龄
　　private String address; //地址
　　private boolean focus ; //是否重点关注
　　private Date addTime; //创建时间
　　private String remark; //备注
　　@ManyToOne
　　private CustomerType customerType; //客户类型
　　......
}

/**
* 客户类型
*/
@Entity
@Table(name = "demo_lx_CustomerType")
public class CustomerType extends BaseBo
{ 
　　private String code; //编号
　　private String name; //名称
　　private String remark; //备注
　　......
}

　　　　　//创建查询条件数据对象
        Customer customer = new Customer();
        customer.setName("刘");
        customer.setAddress("河南省郑州市");

        //创建匹配器，即如何使用查询条件
        ExampleMatcher matcher = ExampleMatcher.matching() //构建对象
                .withMatcher("name", GenericPropertyMatchers.startsWith()) //姓名采用“开始匹配”的方式查询
                .withIgnorePaths("focus");  //忽略属性：是否关注。因为是基本类型，需要忽略掉
        
        //创建实例
        Example<Customer> ex = Example.of(customer, matcher); 
        
        //查询
        List<Customer> ls = dao.findAll(ex);
        
        //输出结果
        System.out.println("数量："+ls.size());
        for (Customer bo:ls)
        {
            System.out.println(bo.getName());
        }

数量：1
刘芳

public class ExampleMatcher {
NullHandler nullHandler; //Null值处理方式
StringMatcher defaultStringMatcher; //默认字符串匹配方式
boolean defaultIgnoreCase; //默认大小写忽略方式
PropertySpecifiers propertySpecifiers; //各属性特定查询方式
Set<String> ignoredPaths; //忽略属性列表
......
}

    （1）nullHandler：Null值处理方式，枚举类型，有2个可选值，INCLUDE（包括）,IGNORE（忽略）。标识作为条件的实体对象中，一个属性值（条件值）为Null是，是否参与过滤。当该选项值是INCLUDE时，表示仍参与过滤，会匹配数据库表中该字段值是Null的记录；若为IGNORE值，表示不参与过滤。

在ExampleMatcher中定义了一系列方式，用于设置这5项设置值，所有的设置方法均返回 ExampleMatcher 对象，所以支持链式编程配置。

（1）创建一个默认的 ExampleMatcher 对象。

定义：

public static ExampleMatcher matching()

默认配置如下：
A、nullHandler：IGNORE。Null值处理方式：忽略
B、defaultStringMatcher：DEFAULT。默认字符串匹配方式：默认（相等）
C、defaultIgnoreCase：false。默认大小写忽略方式：不忽略
D、propertySpecifiers：空。各属性特定查询方式，空。
E、ignoredPaths：空列表。忽略属性列表，空列表。

（2）改变Null值处理方式。

定义：
public ExampleMatcher withNullHandler(NullHandler nullHandler)
public ExampleMatcher withIncludeNullValues()
public ExampleMatcher withIgnoreNullValues()

产生效果：
改变配置项nullHandler，分别设为：指定值、INCLUDE（包括）、IGNORE（忽略）。

（3）改变默认字符串匹配方式。
定义：
public ExampleMatcher withStringMatcher(StringMatcher defaultStringMatcher)

产生效果：
改变配置项defaultStringMatcher，设为指定值。

（4）改变默认大小写忽略方式。
定义：
public ExampleMatcher withIgnoreCase()
public ExampleMatcher withIgnoreCase(boolean defaultIgnoreCase)

产生效果：
改变配置项defaultIgnoreCase，分别设为：true，指定值。

（5）向“忽略属性列表”中添加属性。
定义：
public ExampleMatcher withIgnorePaths(String... ignoredPaths)

产生效果：
改变配置项ignoredPaths，向列表中添加一个或多个属性。

（6）配置属性特定查询方式

    一个属性的特定查询方式，包含了3个信息：字符串匹配方式、大小写忽略方式、属性转换器，存储在 propertySpecifiers 中，操作时用 GenericPropertyMatcher 类来传递配置信息。有4个方法来改变配置，这4个方法操作时，内部均采用增量改变的方式，即如果没有为属性定义“特定查询方式”，则会定义一个，并根据传进来的“非空信息”进行配置，如果已经定义有，则会根据传进来的“非空信息”进行更新。如果一个“特定查询方式”中的“字符串匹配方式、大小写忽略方式”没有设置值，查询时则采用ExampleMatcher中的默认配置。

A、自定义类的方式。

定义：
public ExampleMatcher withMatcher(String propertyPath, MatcherConfigurer<GenericPropertyMatcher> matcherConfigurer)

产生效果：

向 propertySpecifiers 中增加或更新属性“特定查询方式”的配置。

参数说明：
propertyPath：要配置特定查询的属性名。
matcherConfigurer：自定义类对象。自定义类需要实现MatcherConfigurer接口，在接口的 configureMatcher() 实现方法中指定相关配置。

B、直接传入通用属性查询对象方式。

定义：
public ExampleMatcher withMatcher(String propertyPath, GenericPropertyMatcher genericPropertyMatcher)

产生效果：

向 propertySpecifiers 中增加或更新属性“特定查询方式”的配置。

参数说明：
propertyPath：要配置特定查询的属性名。
genericPropertyMatcher：直接传入一个通用查询对象。 ExampleMatcher.GenericPropertyMatchers工具类中提供了常用对象创建的静态方法，所有方法均返回 GenericPropertyMatcher 对象，所以支持链式编程配置。

另外：GenericPropertyMatcher 类本身也提供了诸多方法，用于改变相关配置项。

C、改变的大小写忽略方式

定义：
public ExampleMatcher withIgnoreCase(String... propertyPaths)

产生效果：
向 propertySpecifiers 中增加或更新属性“特定查询方式”中的“大小写忽略方式”配置。。

D、设置属性转换器

定义：
public ExampleMatcher withTransformer(String propertyPath, PropertyValueTransformer propertyValueTransformer)

1、关于基本数据类型。
实体对象中，避免使用基本数据类型，采用包装器类型。如果已经采用了基本类型，
而这个属性查询时不需要进行过滤，则把它添加到忽略列表（ignoredPaths）中。

2、Null值处理方式。
默认值是 IGNORE（忽略），即当条件值为null时，则忽略此过滤条件，一般业务也是采用这种方式就可满足。当需要查询数据库表中属性为null的记录时，可将值设为INCLUDE，这时，对于不需要参与查询的属性，都必须添加到忽略列表（ignoredPaths）中，否则会出现查不到数据的情况。

3、默认配置、特殊配置。
默认创建匹配器时，字符串采用的是精确匹配、不忽略大小写，可以通过操作方法改变这种默认匹配，以满足大多数查询条件的需要，如将“字符串匹配方式”改为CONTAINING（包含，模糊匹配），这是比较常用的情况。对于个别属性需要特定的查询方式，可以通过配置“属性特定查询方式”来满足要求。

4、非字符串属性
如约束中所谈，非字符串属性均采用精确匹配，即等于。

5、忽略大小写的问题。
忽略大小的生效与否，是依赖于数据库的。例如 MySql 数据库中，默认创建表结构时，字段是已经忽略大小写的，所以这个配置与否，都是忽略的。如果业务需要严格区分大小写，可以改变数据库表结构属性来实现，具体可百度。

　　　　 //创建查询条件数据对象
        Customer customer = new Customer();
        customer.setAddress("河南省郑州市");
        customer.setFocus(true);
        
        //创建实例
        Example<Customer> ex = Example.of(customer); 
        
        //查询
        List<Customer> ls = dao.findAll(ex);
        
        //输出结果
        System.out.println("数量："+ls.size());
        for (Customer bo:ls)
        {
            System.out.println(bo.getName());
        }

数量：4
李明
刘芳
zhang ming
ZHANG SAN

　　　　 //创建查询条件数据对象
        Customer customer = new Customer();
        customer.setName("zhang");
        customer.setAddress("河南省");
        customer.setRemark("BB");

        //创建匹配器，即如何使用查询条件
        ExampleMatcher matcher = ExampleMatcher.matching() //构建对象
                .withStringMatcher(StringMatcher.CONTAINING) //改变默认字符串匹配方式：模糊查询
                .withIgnoreCase(true) //改变默认大小写忽略方式：忽略大小写
                .withMatcher("address", GenericPropertyMatchers.startsWith()) //地址采用“开始匹配”的方式查询
                .withIgnorePaths("focus");  //忽略属性：是否关注。因为是基本类型，需要忽略掉
        
        //创建实例
        Example<Customer> ex = Example.of(customer, matcher); 
        
        //查询
        List<Customer> ls = dao.findAll(ex);
        
        //输出结果
        System.out.println("数量："+ls.size());
        for (Customer bo:ls)
        {
            System.out.println(bo.getName());
        }

数量：2
zhang ming
ZHANG SAN

　　　　 //创建查询条件数据对象
        CustomerType type = new CustomerType();
        type.setCode("01"); //编号01代表潜在客户
        Customer customer = new Customer();
        customer.setCustomerType(type);        

        //创建匹配器，即如何使用查询条件
        ExampleMatcher matcher = ExampleMatcher.matching() //构建对象
                .withIgnorePaths("focus");  //忽略属性：是否关注。因为是基本类型，需要忽略掉                
        
        //创建实例
        Example<Customer> ex = Example.of(customer, matcher); 
        
        //查询
        List<Customer> ls = dao.findAll(ex);
        
        //输出结果
        System.out.println("数量："+ls.size());
        for (Customer bo:ls)
        {
            System.out.println(bo.getName());
        }

数量：4
李明
李莉
张强
ZHANG SAN

　　　　 //创建查询条件数据对象
        Customer customer = new Customer();

        //创建匹配器，即如何使用查询条件
        ExampleMatcher matcher = ExampleMatcher.matching() //构建对象
                .withIncludeNullValues() //改变“Null值处理方式”：包括
                .withIgnorePaths("id","name","sex","age","focus","addTime","remark","customerType");  //忽略其他属性
        
        //创建实例
        Example<Customer> ex = Example.of(customer, matcher); 
        
        //查询
        List<Customer> ls = dao.findAll(ex);
        
        //输出结果
        System.out.println("数量："+ls.size());
        for (Customer bo:ls)
        {
            System.out.println(bo.getName());
        }

数量：2
张强
刘明