15.6. クエリの例

org.hibernate.criterion.Example クラスは、与えられたインスタンスからクエリクライテリオンを構築できます。 
Cat cat = new Cat();
cat.setSex('F');
cat.setColor(Color.BLACK);
List results = session.createCriteria(Cat.class)
    .add( Example.create(cat) )
    .list();
バージョンプロパティ、識別子、関連は無視されます。デフォルトでは null 値のプロパティは除外されます。
どのように Example を適用するか調整することができます。 
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 comparisons
List results = session.createCriteria(Cat.class)
    .add(example)
    .list();
関連オブジェクトに criteria を指定するために、 example を使うことも可能です。 
List results = session.createCriteria(Cat.class)
    .add( Example.create(cat) )
    .createCriteria("mate")
        .add( Example.create( cat.getMate() ) )
    .list();