ogm session_带有Hibernate OGM的NoSQL –第一部分:持久化您的第一个实体

ogm session

Hibernate OGM的第一个最终版本已经发布 ,团队从发布狂潮中恢复了一些。 因此,他们考虑开设一系列教程风格的博客,使您有机会轻松地从Hibernate OGM重新开始。 感谢Gunnar Morling( @gunnarmorling )创建了本教程。

介绍

不知道什么是Hibernate OGM? Hibernate OGM是Hibernate下的最新项目,它允许您通过著名的JPA将实体模型持久保存在不同的NoSQL存储中。

我们将在接下来的几周内介绍这些主题:

  • 坚持您的第一个实体(此批次)
  • 查询数据
  • 在WildFly上运行
  • 在Java SE上使用CDI运行
  • 将数据存储到同一应用程序中的两个不同存储中

如果您希望我们讨论任何其他主题,请告诉我们。 只需在下面添加评论或向我们发送您的建议 。

在本系列的第一部分中,我们将建立一个具有所需依赖项的Java项目,创建一些简单实体,然后将它们写入商店或从商店中读取。 我们将从Neo4j图形数据库开始 ,然后仅需进行少量配置更改就切换到MongoDB文档存储 。

项目设置

首先让我们创建一个具有所需依赖项的新Java项目。 接下来,我们将使用Maven作为构建工具,但是Gradle或其他工具当然也可以很好地工作。

将此添加到pom.xml的dependencyManagement块中:

...
<dependencyManagement><dependencies>...<dependency><groupId>org.hibernate.ogm</groupId><artifactId>hibernate-ogm-bom</artifactId><type>pom</type><version>4.1.1.Final</version><scope>import</scope></dependency>...</dependencies>
</dependencyManagement>
...

这将确保您使用的是匹配版本的Hibernate OGM模块及其依赖项。 然后将以下内容添加到dependencies块:

...
<dependencies>...<dependency><groupId>org.hibernate.ogm</groupId><artifactId>hibernate-ogm-neo4j</artifactId></dependency><dependency><groupId>org.jboss.jbossts</groupId><artifactId>jbossjta</artifactId></dependency>...
</dependencies>
...

依赖项是:

  • Hibernate OGM模块,用于处理嵌入式Neo4j数据库; 这将引入所有其他必需的模块,例如Hibernate OGM内核和Neo4j驱动程序。 使用MongoDB时,可以将其与hibernate-ogm-mongodb交换。
  • JBoss对Java Transaction API(JTA)的实现,当不在WildFly之类的Java EE容器中运行时需要此实现

领域模型

我们的示例域模型由三个类组成: HikeHikeSectionPerson

027c5fc5

之间存在组合关系HikeHikeSection ,即上调包括几个部分,其生命周期是完全依赖于远足。 远足部分列表已订购; 坚持远足及其部分时,必须保持此顺序。

HikePerson (充当远足组织者)之间的关联是双向的多对一/一对多关系:一个人可以组织零个或多个远足,而一个远足恰好有一个人充当组织者。

映射实体

现在,通过创建实体类并用所需的元数据注释它们来映射域模型。 让我们从Person类开始:

@Entity
public class Person {@Id@GeneratedValue(generator = "uuid")@GenericGenerator(name = "uuid", strategy = "uuid2")private long id;private String firstName;private String lastName;@OneToMany(mappedBy = "organizer", cascade = CascadeType.PERSIST)private Set<Hike> organizedHikes = new HashSet<>();// constructors, getters and setters...
}

实体类型使用@Entity注释进行标记,而表示标识符的属性则使用@Id注释。

Hibernate OGM无需手动分配ID,而是可以解决此问题,它提供了几种ID生成策略,例如(模拟)序列,UUID等。 通常,使用UUID生成器是一个不错的选择,因为它可以确保跨不同NoSQL数据存储的可移植性,并使ID生成快速且可扩展。 但是根据您使用的商店,在MongoDB的情况下,您也可以使用特定的ID类型,例如对象ID(有关详细信息,请参阅参考指南 )。

最后, @OneToManyorganizedHikes属性标记为实体之间的关联。 由于它是双向实体,因此必须使用mappedBy属性来指定负责管理它的关联方。 指定级联类型PERSIST可确保坚持一个人也将自动导致其关联的远足也被坚持。

接下来是Hike类:

@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;@ManyToOneprivate Person organizer;@ElementCollection@OrderColumn(name = "sectionNo")private List<HikeSection> sections;// constructors, getters and setters...
}

在这里, @ManyToOne注释标记了HikeOrganizer之间的双向关联的另一面。 由于HikeSection应该依赖于Hike,因此部分列表通过@ElementCollection映射。 为了确保在数据存储区中保持节的顺序, @OrderColumn使用@OrderColumn 。 这将在保留的记录中添加一个额外的“列”,其中包含每个部分的订单号。

最后, HikeSection类:

@Embeddable
public class HikeSection {private String start;private String end;// constructors, getters and setters...
}

PersonHike不同,它不是通过@Entity而是使用@Embeddable映射的。 这意味着它始终是另一个实体(在本例中为Hike )的一部分,因此本身也没有身份。 因此,它不会声明任何@Id属性。

请注意,如果您将Hibernate ORM与关系数据存储一起使用,则这些映射看起来完全相同。 的确,这就是Hibernate OGM的承诺之一:尽可能简化关系和NoSQL范例之间的迁移!

创建persistence.xml

有了实体类之后,JPA的persistence.xml描述符又丢失了一件事。 在src / main / resources / META-INF / persistence.xml下创建它:

<?xml version="1.0" encoding="utf-8"?><persistence xmlns="http://java.sun.com/xml/ns/persistence"xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"xsi:schemaLocation="http://java.sun.com/xml/ns/persistence http://java.sun.com/xml/ns/persistence/persistence_2_0.xsd"version="2.0"><persistence-unit name="hikePu" transaction-type="RESOURCE_LOCAL"><provider>org.hibernate.ogm.jpa.HibernateOgmPersistence</provider><properties><property name="hibernate.ogm.datastore.provider" value="neo4j_embedded" /><property name="hibernate.ogm.datastore.database" value="HikeDB" /><property name="hibernate.ogm.neo4j.database_path" value="target/test_data_dir" /></properties></persistence-unit>
</persistence>

如果您以前使用过JPA,那么对您来说,这个持久性单元定义应该看起来非常熟悉。 与在关系数据库之上使用经典Hibernate ORM的主要区别在于,我们需要为Hibernate OGM指定特定的提供程序类: org.hibernate.ogm.jpa.HibernateOgmPersistence

此外,还定义了一些特定于Hibernate OGM和所选后端的属性来设置:

  • 使用的后端(在这种情况下为嵌入式Neo4j图形数据库)
  • Neo4j数据库的名称
  • 存储Neo4j数据库文件的目录

根据您的用法和后端,可能需要其他属性,例如,设置主机,用户名,密码等。您可以在名为<BACK END>Properties的类中找到所有可用的<BACK END>Properties ,例如Neo4jProperties , MongoDBProperties等。 。

保存和加载实体

所有这些位都准备就绪后,就可以保留(并加载)某些实体了。 为此创建一个简单的JUnit测试外壳:

public class HikeTest {private static EntityManagerFactory entityManagerFactory;@BeforeClasspublic static void setUpEntityManagerFactory() {entityManagerFactory = Persistence.createEntityManagerFactory( "hikePu" );}@AfterClasspublic static void closeEntityManagerFactory() {entityManagerFactory.close();}
}

这两种方法为persistence.xml中定义的持久性单元管理实体管理器工厂。 它保存在一个字段中,因此可以用于多种测试方法(请记住,实体管理器工厂的创建成本相当高,因此应将它们初始化一次并保留以备重用)。

然后创建一个持久保存并加载一些数据的测试方法:

@Test
public void canPersistAndLoadPersonAndHikes() {EntityManager entityManager = entityManagerFactory.createEntityManager();entityManager.getTransaction().begin();// create a PersonPerson bob = new Person( "Bob", "McRobb" );// and two hikesHike 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 hikescornwall.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();// get a new EM to make sure data is actually retrieved from the store and not Hibernate's internal cacheentityManager.close();entityManager = entityManagerFactory.createEntityManager();// load it backentityManager.getTransaction().begin();Person loadedPerson = entityManager.find( Person.class, bob.getId() );assertThat( loadedPerson ).isNotNull();assertThat( loadedPerson.getFirstName() ).isEqualTo( "Bob" );assertThat( loadedPerson.getOrganizedHikes() ).onProperty( "description" ).containsOnly( "Visiting Land's End", "Exploring Carisbrooke Castle" );entityManager.getTransaction().commit();entityManager.close();
}

注意这两个动作是如何在事务中发生的。 Neo4j是一个完全事务性的数据存储库,可以通过JPA的事务处理API很好地控制它。 在实际的应用程序中,可能会使用一种较为冗长的方法来进行事务控制。 根据所选的后端和应用程序运行的环境类型(例如Java EE容器,例如WildFly ),您可以利用通过CDI或EJB进行的声明式事务管理。 但是,让我们再保存一次。

保留了一些数据之后,您可以使用Neo4j随附的漂亮的Web控制台对其进行检查。 下面显示了测试保留的实体:

aDXbhi6

Hibernate OGM旨在为您要定位的数据存储提供最自然的映射。 对于Neo4j作为图形数据存储的情况,这意味着任何实体都将映射到相应的节点。

实体属性被映射为节点属性(请参见描述黑名单节点之一的黑框)。 任何不受本机支持的属性类型都将根据需要进行转换。 例如, date属性就是这种情况,它作为ISO格式的字符串保留。 此外,每个实体节点都有标签 ENTITY(以将其与其他类型的节点区分开)和指定其实体类型的标签(在这种情况下为远足)。

关联被映射为节点之间的关系,关联角色被映射为关系类型 。

请注意,Neo4j没有嵌入式对象的概念。 因此, HikeSection对象被映射为带有标签EMBEDDED的节点,并与拥有的Hike节点链接。 节的顺序通过关系上的属性保留。

切换到MongoDB

Hibernate OGM的承诺之一是允许使用相同的API(即JPA)与不同的NoSQL存储一起使用。 因此,让我们看一下它如何保存和利用MongoDB,它与Neo4j不同,它是一个文档数据存储区,并以类似JSON的表示形式保留数据。 为此,请首先将Neo4j后端替换为以下内容:

...
<dependency><groupId>org.hibernate.ogm</groupId><artifactId>hibernate-ogm-mongodb</artifactId>
</dependency>
...

然后使用可通过以下方式访问的属性更新persistence.xml中的配置,以将MongoDB作为后端使用
提供与您的环境匹配的主机名和凭据的MongoDBProperties (如果尚未安装MongoDB,则可以在此处下载):

...
<properties><property name="hibernate.ogm.datastore.provider" value="mongodb" /><property name="hibernate.ogm.datastore.database" value="HikeDB" /><property name="hibernate.ogm.datastore.host" value="mongodb.mycompany.com" /><property name="hibernate.ogm.datastore.username" value="db_user" /><property name="hibernate.ogm.datastore.password" value="top_secret!" />
</properties>
...

这就是将实体保留在MongoDB中而不是Neo4j中所需要做的全部工作。 如果现在再次运行测试,您将在数据存储区中找到以下BSON文档:

# Collection "Person"
{"_id" : "50b62f9b-874f-4513-85aa-c2f59015a9d0","firstName" : "Bob","lastName" : "McRobb","organizedHikes" : ["a78d731f-eff0-41f5-88d6-951f0206ee67","32384eb4-717a-43dc-8c58-9aa4c4e505d1"]
}
# Collection Hike
{"_id" : "a78d731f-eff0-41f5-88d6-951f0206ee67","date" : ISODate("2015-01-16T11:59:48.928Z"),"description" : "Visiting Land's End","difficulty" : "5.5","organizer_id" : "50b62f9b-874f-4513-85aa-c2f59015a9d0","sections" : [{"sectionNo" : 0,"start" : "Penzance","end" : "Mousehole"},{"sectionNo" : 1,"start" : "Mousehole","end" : "St. Levan"},{"sectionNo" : 2,"start" : "St. Levan","end" : "Land's End"}]
}
{"_id" : "32384eb4-717a-43dc-8c58-9aa4c4e505d1","date" : ISODate("2015-01-16T11:59:48.928Z"),"description" : "Exploring Carisbrooke Castle","difficulty" : "7.5","organizer_id" : "50b62f9b-874f-4513-85aa-c2f59015a9d0","sections" : [{"sectionNo" : 1,"start" : "Calbourne","end" : "Carisbrooke Castle"},{"sectionNo" : 0,"start" : "Freshwater","end" : "Calbourne"}]
}

同样,映射是非常自然的,就像使用MongoDB这样的文档存储时所期望的那样。 通过将参考ID存储在任意一侧,可以映射PersonHike之间的双向一对多/多对一关联。 当加载回数据时,Hibernate OGM将解析ID,并允许将关联从一个对象导航到另一个对象。

元素集合使用MongoDB存储分层结构的功能进行映射。 在此,加息的各个部分映射到拥有加息的文档中的数组,并带有附加的字段sectionNo来维护收集顺序。 这样可以通过一次往返数据存储的方式非常有效地加载实体及其嵌入式元素。

结语

带有Hibernate OGM 101NoSQL的第一部分中,您学习了如何设置具有所需依赖项的项目,映射某些实体和关联并将其持久化在Neo4j和MongoDB中。 所有这些都是通过众所周知的JPA API进行的。 因此,如果您过去在关系数据库之上使用过Hibernate ORM和JPA,那么深入NoSQL领域将变得异常简单。

同时,每个商店都针对某些用例,因此提供了特定的功能和配置选项。 自然,这些不能通过通用API(例如JPA)公开。 因此,Hibernate OGM允许您使用本机NoSQL查询,并允许通过其灵活的选项系统配置商店特定的设置。

您可以在GitHub上找到此博客文章的完整示例代码 。 只需叉子,然后随心所欲地玩就可以了。

当然,存储实体并通过其ID取回实体仅仅是开始。 在任何实际的应用程序中,您都希望对数据运行查询,并且还可能希望利用所选NoSQL存储库的某些特定功能和设置。 我们将在本系列的下一部分中谈到这一点,请继续关注!

翻译自: https://www.javacodegeeks.com/2015/01/nosql-with-hibernate-ogm-part-one-persisting-your-first-entities.html

ogm session

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处:http://www.mzph.cn/news/338258.shtml

如若内容造成侵权/违法违规/事实不符,请联系多彩编程网进行投诉反馈email:809451989@qq.com,一经查实,立即删除!

相关文章

c语言volatile关键字的作用是什么?

一.前言1.编译器优化介绍&#xff1a;由于内存访问速度远不及CPU处理速度&#xff0c;为提高机器整体性能&#xff0c;在硬件上引入硬件高速缓存Cache&#xff0c;加速对内存的访问。另外在现代CPU中指令的执行并不一定严格按照顺序执行&#xff0c;没有相关性的指令可以乱序执…

jaxb解析字符串xml_一个JAXB Nuance:字符串与枚举(受限制的XSD字符串)的枚举

jaxb解析字符串xml尽管用于XML绑定的Java体系结构 &#xff08; JAXB &#xff09;在名义情况下&#xff08;尤其是自Java SE 6以来&#xff09; 相当容易使用&#xff0c;但它也存在许多细微差别。 一些常见的细微差别是由于无法将 XML架构定义 &#xff08;XSD&#xff09;类…

php伪静态后不能访问html,php伪静态后html不能访问怎么办

php伪静态后html不能访问的解决办法&#xff1a;首先判断文件是否存在&#xff1b;然后设置存在则不rewirte&#xff0c;不存在且符合规则才rewrite&#xff1b;最后修改htaccess文件即可。推荐&#xff1a;《PHP视频教程》具体问题&#xff1a;PHP伪静态后不能访问纯html文件.…

c语言中,char型数据是以什么形式存储的?

C语言 字符型&#xff08;char&#xff09;简介字符型&#xff08;char&#xff09;用于储存字符&#xff08;character&#xff09;&#xff0c;如英文字母或标点。严格来说&#xff0c;char 其实也是整数类型&#xff08;integer type&#xff09;&#xff0c;因为char 类型储…

声明式编程与函数式编程_实用程序类与函数式编程无关

声明式编程与函数式编程最近&#xff0c;我被指控反对函数式编程&#xff0c;因为我将实用程序类称为反模式 。 绝对是错的&#xff01; 好吧&#xff0c;我确实认为它们是一个糟糕的反模式&#xff0c;但是它们与函数式编程无关。 我相信有两个基本原因。 首先&#xff0c;函数…

C语言中位运算符有哪些

C语言中位运算符有&#xff1a;位操作是程序设计中对位模式按位或二进制数的一元和二元操作。在许多古老的微处理器上&#xff0c; 位运算比加减运算略快&#xff0c; 通常位运算比乘除法运算要快很多。在现代架构中&#xff0c; 情况并非如此&#xff1a;位运算的运算速度通常…

jsf表单验证_JSF:在正确的阶段进行验证(了解生命周期)

jsf表单验证嗨&#xff0c;大家好&#xff01; 尽管标题强调验证一词&#xff0c;但本文实际上是关于JSF生命周期的。 那是因为我相信&#xff0c;真正了解生命周期的最简单方法之一就是通过做出我们一直在做的事情&#xff1a;验证用户输入。 通常&#xff0c;了解所谓的JSF…

java广度优先爬虫示例,【爬虫】广度优先遍历抓取数据概述

这次都是一些纯语言的表达&#xff0c;可能会有点啰嗦&#xff0c;或者有点枯燥&#xff0c;也是对爬虫的一些小小的见解&#xff0c;可能只是一些常见话&#xff0c;哈哈&#xff0c;还是耐心的写完。网络爬虫的整体执行流程&#xff1a;1)确定一个(多个)种子网页2)进行数据内…

if语句的用法是什么

if语句的用法&#xff1a;if语句是指编程语言&#xff08;包括c语言、C#、VB、java、汇编语言等&#xff09;中用来判定所给定的条件是否满足&#xff0c;根据判定的结果&#xff08;真或假&#xff09;决定执行给出的两种操作之一。if语句概述if语句是指编程语言&#xff08;包…

c语言如何实现玫瑰花

c语言实现玫瑰花的方法&#xff1a;#include #include ?#include #include #include #pragma comment(lib,"winmm.lib")//定义全局变量int rosesize 500;int h -250;//定义结构体struct DOT {double x;double y;double z;double r;double g;};bool calc(double a,…

maven 部署nexus_设置本地Nexus存储库并从Maven部署WAR文件

maven 部署nexusMaven Central充当中央存储库管理器&#xff0c;二进制文件由不同的团队/公司/个人上载并与世界其他地方共享。 就像github和其他对源代码控制非常有效的源代码存储库一样&#xff0c;这些存储库管理器还充当您自己生成的二进制工件的部署目标。 设置本地存储库…

c vector用法是什么

在c 中&#xff0c;vector是一个十分有用的容器&#xff0c;c vector用法是&#xff1a;1、基本操作(1)头文件#include.(2)创建vector对象&#xff0c;vector vec;(3)尾部插入数字&#xff1a;vec.push_back(a);(4)使用下标访问元素&#xff0c;cout<<vec[0]<<endl…

c语言for循环如何打印菱形

c语言for循环打印菱形的方法&#xff1a;使用两个for循环&#xff0c;实现条件判断&#xff0c;代码为【int i,j;for(i0; i<2*n-1; i )_(in-i-1&&jc语言for循环打印菱形的方法&#xff1a;方法一&#xff08;以循环为主打印&#xff09;#include void print(int n) …

quasar 异步回调_Java IO基准测试:Quasar与异步ForkJoinPool与ManagedBlock

quasar 异步回调“ Arien看到了我们运行的parallelStreams和ForkJoin基准测试的结果后&#xff0c;在Twitter上与我们联系。 这激起了他的兴趣&#xff0c;因此他进行了一些自己的测试&#xff0c;将Quasar纤维加入了混合物。 这是他的结果和结论。” –塔基皮&#xff08;Taki…

php微信自动回复机器人,微信自动回复机器人功能怎么实现?

原标题&#xff1a;微信自动回复机器人功能怎么实现&#xff1f;微信自动回复机器人功能怎么实现&#xff1f;最近有不少小伙伴都在询问这个问题。很多人在微信营销的过程中&#xff0c;都会有这样的问题&#xff0c;微信好友太多&#xff0c;想要都在第一时间回复&#xff0c;…

C语言怎么合并两个有序链表

C语言合并两个有序链表的方法&#xff1a;拼接指定的两个有序链表的所有节点即可。例如两个有序链表分别为【1->2->4】和【1->3->4】&#xff0c;合并后的有序链表为【1->1->2->3->4->4】。具体方法&#xff1a;将两个有序链表合并为一个新的有序链…

jira集成开发代码_7种JIRA集成可优化您的Java开发流程

jira集成开发代码有哪些最佳集成可以用来优化JIRA工作流程&#xff1f; 我喜欢寻找在工作流程中提高效率的方法。 看着那些小小的自动化和流畅的流程&#xff0c;我的脸上露出了微笑。 我知道我并不孤单&#xff0c;有时花费更多的时间来获得一点点提升以使其正常工作&#xff…

c语言源程序结构是怎样的?

一个C语言源程序至少一个有main函数&#xff0c;定义函数必须指定 4 个元素&#xff1a;返回类型、函数名、圆括号内的形参表&#xff08;可能为空&#xff09;和函数体。源程序的结构特点&#xff1a;1、一个C语言源程序可以由一个或多个源文件组成。2、每个源文件可由一个或多…

c语言规定在一个源程序中main函数的位置是什么?

一个c程序有且仅有一个main函数&#xff0c;除main函数之外可以有若干个其它的函数&#xff0c;每个函数实现某一特定的操作。C语言规定&#xff0c;在一个源程序中&#xff0c;main函数的位置可以任意。因为&#xff1a;在一个C语言源程序中&#xff0c;程序总是从main函数开始…

jax-ws和jax-rs_使用JAX-RS和Jetty创建Web服务和Rest Server

jax-ws和jax-rs用Java创建WebService非常容易。 将其添加到ServletContainer并将其部署到嵌入式WebServer仅需要几行代码。 让我们创建一个具有两个函数的简单计算器&#xff0c;作为WebService的示例。 计算器将计算任意数量的squareRoot和平方。 它将返回一个简单的JSON响应…