1月底发布了Hibernate OGM的第一个最终版本之后，团队一直在忙于制作一系列教程式博客，使您有机会轻松地从Hibernate OGM重新开始。 第一部分是关于设置和保留您的第一个实体 。 在第二部分中，您将学习如何查询数据。 Hibernate OGM将使您以几种不同的方式获取数据：
- 使用Java持久性查询语言（JP-QL）
- 使用您选择的数据存储的NoSQL本机查询语言（如果有的话）
- 使用Hibernate Search查询–主要是全文查询
所有这些替代方案将使您可以在数据存储上运行查询，并以托管实体列表的形式获得结果。
准备测试课
我们将添加一个新的类HikeQueryTest。 它将使用有关加息的一些信息填充数据存储区：
public class HikeQueryTest {
private static EntityManagerFactory entityManagerFactory;
@BeforeClass
public static void setUpEntityManagerFactoryAndPopulateTheDatastore() {
entityManagerFactory = Persistence.createEntityManagerFactory( "hikePu" );
EntityManager entityManager = entityManagerFactory.createEntityManager();
entityManager.getTransaction().begin();
// create a Person
Person bob = new Person( "Bob", "McRobb" );
// and two hikes
Hike cornwall = new Hike(
"Visiting Land's End", new Date(), new BigDecimal( "5.5" ),
new HikeSection( "Penzance", "Mousehole" ),
new HikeSection( "Mousehole", "St. Levan" ),
new HikeSection( "St. Levan", "Land's End" )
);
Hike isleOfWight = new Hike(
"Exploring Carisbrooke Castle", new Date(), new BigDecimal( "7.5" ),
new HikeSection( "Freshwater", "Calbourne" ),
new HikeSection( "Calbourne", "Carisbrooke Castle" )
);
// let Bob organize the two hikes
cornwall.setOrganizer( bob );
bob.getOrganizedHikes().add( cornwall );
isleOfWight.setOrganizer( bob );
bob.getOrganizedHikes().add( isleOfWight );
// persist organizer (will be cascaded to hikes)
entityManager.persist( bob );
entityManager.getTransaction().commit();
entityManager.close();
}
@AfterClass
public static void closeEntityManagerFactory() {
entityManagerFactory.close();
}
}此方法将确保在运行测试之前已创建实体管理器工厂，并且数据存储区包含一些数据。 数据与我们在第1部分中存储的数据相同。
现在我们已经有了一些数据，我们可以开始编写一些测试来搜索它们。
使用Java持久性查询语言（JP-QL）
JP-QL是一种查询语言，定义为Java Persistence API（JPA）规范的一部分 。 它旨在与实体一起使用并且独立于数据库。
以实体远足为例：
@Entity
public class Hike {
@Id
@GeneratedValue(generator = "uuid")
@GenericGenerator(name = "uuid", strategy = "uuid2")
private String id;
private String description;
private Date date;
private BigDecimal difficulty;
@ManyToOne
private Person organizer;
@ElementCollection
@OrderColumn(name = "sectionNo")
private List<HikeSection> sections;
// constructors, getters, setters, ...
}JP-QL查询可获取按难度排序的可用加息列表，如下所示：
SELECT h FROM Hike h ORDER BY h.difficulty ASCHibernate OGM将解析此查询，并将其转换为您选择的数据存储区的本机查询语言中的等效查询。 例如，在Neo4j中，它创建并执行以下Cypher查询：
MATCH (h:Hike) RETURN h ORDER BY h.difficulty在MongoDB中，使用MongoDB JavaScript API作为查询符号，它看起来像这样：
db.Hike.find({}, { "difficulty": 1})如果在应用程序中使用JP-QL，则无需更新查询就可以在数据存储区之间切换。
现在您已经了解了所发生的情况，我们可以开始查询持久化的数据。 例如，我们可以获取可用加息的列表：
@Test
public void canSearchUsingJPQLQuery() {
// Get a new entityManager
EntityManager entityManager = entityManagerFactory.createEntityManager();
// Start transaction
entityManager.getTransaction().begin();
// Find all the available hikes ordered by difficulty
List<Hike> hikes = entityManager
.createQuery( "SELECT h FROM Hike h ORDER BY h.difficulty ASC" , Hike.class )
.getResultList();
assertThat( hikes.size() ).isEqualTo( 2 );
assertThat( hikes ).onProperty( "description" ).containsExactly( "Visiting Land's End", "Exploring Carisbrooke Castle" );
entityManager.getTransaction().commit();
entityManager.close();
}如果您曾经使用过JPA规范，就会发现此代码非常熟悉：这与使用JPA处理关系数据库时所编写的代码相同。
您可以通过在Neo4j和MongoDB之间切换配置和依赖项来进行测试：测试仍将通过而无需更改代码。
很棒的事情是，您可以对没有自己的查询引擎的数据存储使用JP-QL查询。 在这种情况下，Hibernate OGM的查询解析器将创建全文查询，这些查询通过Hibernate Search和Lucene执行。 稍后我们将详细介绍如何执行此操作。
查询的结果是被管理实体的列表。 这意味着对对象的更改将自动应用于数据库中的数据。 您还可以浏览结果对象图，从而根据需要加载惰性关联。
JP-QL语言的支持不完整，并且可能会因后端而异。 我们将把细节留给Hibernate的OGM官方文档。 目前支持的是：
- 简单比较
- IS NULL和IS NOT NULL
- 布尔运算符AND ， OR ， NOT
- LIKE，IN和BETWEEN
- 订购
如果JP-QL不适合您的用例，我们将了解如何使用所选后端的本机语言执行查询。
使用本机后端查询语言
有时，您可能决定牺牲可移植性，以支持基础本机查询语言的功能。 例如，您可能想从Neo4j的Cypher语言的功能中受益，以运行分层/递归查询。 使用MongoDB，让我们通过“ Penzance”进行加息：
// Search for the hikes with a section that start from "Penzace" in MongoDB
List<Hike> hikes = entityManager.createNativeQuery("{ $query : { sections : { $elemMatch : { start: 'Penzance' } } } }", Hike.class ).getResultList();Neo4j的相同代码如下所示：
// Search for the hikes with a section that start from "Penzace" in Neo4j
List<Hike> hikes = entityManager.createNativeQuery( "MATCH (h:Hike) -- (:Hike_sections {start: 'Penzance'} ) RETURN h",
Hike.class ).getResultList();需要注意的重要一点是，与JPA查询一样，查询返回的对象是托管实体。
您还可以使用注释javax.persistence.NamedNativeQuery定义查询：
@Entity
@NamedNativeQuery(
name = "PenzanceHikes",
query = "{ $query : { sections : { $elemMatch : { start: 'Penzance' } } } }", resultClass = Hike.class )
public class Hike { ... }然后像这样执行它：
List<Hike> hikes = entityManager.createNamedQuery( "PenzanceHikes" ).getResultList();使用Hibernate Search查询
Hibernate Search提供了一种将Java对象索引到Lucene索引中并对其执行全文查询的方法。 索引确实位于数据存储区之外。 这意味着即使本机不支持查询功能，也可以具有查询功能。 它还在功能集和可伸缩性方面提供了一些有趣的属性。 特别是，使用Hibernate Search，您可以减轻查询执行的负担，以分离节点并独立于实际的数据存储节点进行扩展。
在此示例中，我们将使用MongoDB。 您首先需要将Hibernate Search添加到您的应用程序。 在Maven项目中，您需要在pom.xml中添加以下依赖项：
<dependencies>
...
<dependency>
<groupId>org.hibernate</groupId>
<artifactId>hibernate-search-orm</artifactId>
</dependency>
...
</dependencies>现在，您可以选择要索引的内容：
@Entity
@Indexed
public class Hike {
@Id
@GeneratedValue(generator = "uuid")
@GenericGenerator(name = "uuid", strategy = "uuid2")
private String id;
@Field
private String description;
private Date date;
private BigDecimal difficulty;
@ManyToOne
private Person organizer;
@ElementCollection
@OrderColumn(name = "sectionNo")
private List<HikeSection> sections;
// constructors, getters, setters, ...
}@Indexed注释标识我们要索引的类，而@Field注释指定我们要索引的类的属性。 每当使用Hibernate OGM通过实体管理器保留新的Hike实体时，Hibernate Search都会自动将其添加到索引中并跟踪对托管实体的更改。 这样，索引和数据存储就可以保持最新状态。
您现在可以使用Lucene查询来寻找Carisbrooke的远足。 在此示例中，我们将使用Hibernate Search提供的查询构建器：
@Test
public void canSearchUsingFullTextQuery() {
EntityManager entityManager = entityManagerFactory.createEntityManager();
entityManager.getTransaction().begin();
//Add full-text superpowers to any EntityManager:
FullTextEntityManager ftem = Search.getFullTextEntityManager(entityManager);
// Optionally use the QueryBuilder to simplify Query definition:
QueryBuilder b = ftem.getSearchFactory().buildQueryBuilder().forEntity( Hike.class ).get();
// A Lucene query to search for hikes to the Carisbrooke castle:
Query lq = b.keyword().onField("description").matching("Carisbrooke castle").createQuery();
//Transform the Lucene Query in a JPA Query:
FullTextQuery ftQuery = ftem.createFullTextQuery(lq, Hike.class);
//This is a requirement when using Hibernate OGM instead of ORM:
ftQuery.initializeObjectsWith( ObjectLookupMethod.SKIP, DatabaseRetrievalMethod.FIND_BY_ID );
// List matching hikes
List<Hike> hikes = ftQuery.getResultList();
assertThat( hikes ).onProperty( "description" ).containsOnly( "Exploring Carisbrooke Castle" );
entityManager.getTransaction().commit();
entityManager.close();
}代码的结果将是描述中提到“ Carisbrooke城堡”的远足清单。
Hibernate Search是一个非常强大的工具，具有许多不同的选项，在本教程中描述所有这些选项都将花费很长时间。 您可以查看参考文档以了解更多信息。
包起来
目前为止就这样了。 如您所见，Hibernate OGM为您提供了一系列对数据存储区运行查询的选项，这些选项应满足您大多数典型的查询需求：JP-QL，本机NoSQL查询和通过Hibernate Search / Apache Lucene进行的全文查询。 即使您以前从未使用过NoSQL数据存储区，也可以轻松地对其进行试验。
您可以在GitHub上找到此博客文章（以及上一篇）的完整示例代码 。 只需叉子，然后随心所欲地玩就可以了。
现在您已经知道如何存储和查找实体，在本系列的下一部分中，我们将看到如何将所有内容放入WildFly之类的应用程序容器中。
我们渴望了解您的意见，随时发表评论或与我们联系 ，我们将回答您的问题并听到您的反馈。
感谢Gunnar Morling（ @gunnarmorling ）和Davide D'Alto（@Github： DavidD ）创建了本教程。
翻译自: https://www.javacodegeeks.com/2015/02/nosql-hibernate-ogm-part-two-querying-data.html