Hibernate 4.1中文API指南：入门到高级映射

hibernate

4星 · 超过85%的资源需积分: 9 59 浏览量更新于2024-07-19 收藏 3.6MB PDF 举报

身份认证购VIP最低享 7 折!

领优惠券(最高得80元）

Hibernate 4.1中文API是一份详细的指南，它涵盖了Hibernate框架在Java中的关系型数据持久化的方方面面。Hibernate是一个流行的ORM（对象关系映射）工具，用于简化Java应用程序与关系数据库之间的交互。这份API文档由Hibernate团队和JBoss视觉设计团队共同编撰，适用于那些希望深入理解并使用Hibernate 4.1版本开发的企业级应用程序开发者。文档内容分为多个部分： 1. **教程**：从入门级开始，教程分为四节： - 第一部分介绍了如何建立第一个Hibernate应用程序，包括设置环境、配置文件、构建项目（如使用Maven）、运行示例并操作对象的存储和加载。 - 第二部分专注于映射关联，讲解了如何映射Person类，单向和双向关联的使用，以及值集合的处理。 - 第三部分则深入到实际应用，如EventManagerweb应用程序，涉及编写Servlet、处理请求和渲染、部署测试等。 - 总结部分回顾了前面学习的关键概念。 2. **架构**：阐述了Hibernate的基本架构，包括最小配置、综合架构和核心API，还涉及了JMX集成、上下文会话等高级功能。 3. **配置**：详述了编程配置、SessionFactory获取、JDBC连接设置、可选配置属性（如SQL方言、连接池、缓存、查询语言和统计）、日志管理、命名策略和PersisterClassProvider实现等。 4. **持久化类**：介绍了如何编写和设计持久化类，包括无参数构造函数、标识符属性、继承、equals()和hashCode()方法，以及动态模型和Tuplizers的使用。 5. **基本的O/R映射**：着重讲解了映射声明，包括实体、标识符、乐观锁定、属性和嵌入对象的定义。这份文档对于学习者来说是极其宝贵的资源，提供了从基础到高级的全面指导，帮助开发者在实际项目中高效地利用Hibernate 4.1进行数据持久化。无论是初学者还是经验丰富的开发人员，都能从中找到所需的信息来提升技能和优化应用程序设计。

资源详情

资源推荐

创建两个实体之间的一个关联这些。人可以参与活动,与事件的参与者。设计问题你必须处理是:方向性、多样性、和收集

行为。

1.2.2。一个单向基于集合的协会

通过添加一个事件的集合人类,你可以很容易地导航到一个特定的人的事件, 没有执行显式查询——通过调用

人# getEvents 。多值关联在Hibernate表示的一个Java集合框架合同,这里我们选择一个 java util集因为集合不包含重复

的元素和订购不与我们的例子:

public class Person {

private Set events = new HashSet();

public Set getEvents() {

return events;

}

public void setEvents(Set events) {

this.events = events;

}

这种关联映射之前,让我们考虑一下对方。我们可以保持这个单向或创建另一个收集在事件 ,如果我们想要的可以从两个方

向导航。这是没有必要的, 从功能的角度。你总是可以执行一个显式的查询来检索参与者对于一个特定的事件。这是一个

设计的选择留给你,但什么是清晰的吗讨论是多重性的协会:“许多”价值在双方称为多对多协会。因此,我们使用

Hibernate的多对多映射:

</id>

<many-to-many column="EVENT_ID" class="Event"/>

</set>

</class>

Hibernate支持广泛的集合的映射,一个集是最常见的。对于一个多对多协会,或 n:米实体关系,一个关联表是必需的。在这

个表的每一行代表之间的关系的人,一个事件。表名是 decalred使用表属性的集元素。标识符列名称该协会的人身边,是

定义关键元素,列名为事件的侧与列属性的多对多。你也必须告诉Hibernate 类的对象在您的收集(类的另一边的收藏的

引用)。

数据库模式这种映射的形式是:

_____________ __________________

| | | | _____________

|_____________| |__________________| | PERSON |

| | | | |_____________|

| TITLE | |__________________| | AGE |

|_____________| | FIRSTNAME |

| LASTNAME |

|_____________|

1.2.3。协会工作

现在我们将把一些人物和事件联系在一起,在新方法 EventManager :

private void addPersonToEvent(Long personId, Long eventId) {

Session session = HibernateUtil.getSessionFactory().getCurrentSession();

session.beginTransaction();

Person aPerson = (Person) session.load(Person.class, personId);

Event anEvent = (Event) session.load(Event.class, eventId);

aPerson.getEvents().add(anEvent);

session.getTransaction().commit();

}

在加载人和一个事件 ,只需修改集合使用正常的收集方法。没有显式的调用 Update() 或 save() ; Hibernate自动检测到收

集已被修改和需要更新。这就是所谓的自动脏检查。你也可以尝试它通过修改姓名或日期你的任何财产对象。只要他们

在持久状态,即,绑定到一个特定的冬眠 org hibernate会话 ,冬眠监控和执行SQL的任何变化在- behind时尚。同步的过程

与数据库的内存状态, 通常只在最后一个工作单元,称为冲洗。在我们的代码中,工作单元最后提交或回滚的事务数据库。

你可以加载和事件在不同单位的人的工作。或你可以修改一个对象之外 org hibernate会话 ,当它不是在持续状态(如果它是

持久的,这之前状态被称为分离 )。你甚至可以修改一个收集当它分离:

private void addPersonToEvent(Long personId, Long eventId) {

Session session = HibernateUtil.getSessionFactory().getCurrentSession();

session.beginTransaction();

Person aPerson = (Person) session

.createQuery("select p from Person p left join fetch p.events where p.id = :pid")

.setParameter("pid", personId)

.uniqueResult(); // Eager fetch the collection so we can use it detached

Event anEvent = (Event) session.load(Event.class, eventId);

session.getTransaction().commit();

// End of first unit of work

aPerson.getEvents().add(anEvent); // aPerson (and its collection) is detached

// Begin second unit of work

Session session2 = HibernateUtil.getSessionFactory().getCurrentSession();

session2.beginTransaction();

session2.update(aPerson); // Reattachment of aPerson

session2.getTransaction().commit();

}

调用更新使分离对象再次被绑定到持续一个新单位工作,所以任何修改你的同时分离可以保存到数据库。这包括任何修改

(添加/删除)你对一个集合的实体对象。

这不是多使用在我们的例子中,但它是一个重要的概念,你可以纳入自己的应用程序。完成这个练习通过添加一个新的行动的

主要方法 EventManager 并通过命令行调用。如果你需要的标识一个人,一个事件- save() 方法返回(您可能要修改一些以

前的方法返回该标识符):

else if (args[0].equals("addpersontoevent")) {

Long eventId = mgr.createAndStoreEvent("My Event", new Date());

Long personId = mgr.createAndStorePerson("Foo", "Bar");

mgr.addPersonToEvent(personId, eventId);

System.out.println("Added person " + personId + " to event " + eventId);

}

这是一个例子,两个关联之间同样重要类:两个实体。正如前面所提到的,还有其他的类和类型在一个典型的模型,通常是“不太

重要”。一些你已经看到的,像一个 int 或以。我们称这些类值类型 ,他们的实例靠在一个特定的实体。实例的这些类型

没有自己的身份,也不会共享实体之间。两个人不引用相同的 FirstName 对象,即使他们有相同的第一个名字。值类型不能

只被发现在JDK,但是你也可以写自己从属类比如一个地址或 MonetaryAmount 类。事实上,在一个Hibernate 应用程序

所有的JDK类被认为是值类型。

你也可以设计一个值类型的集合。这是从一个集合的不同概念的引用其他实体,但看起来几乎相同的Java。

1.2.4。值集合

让我们添加一个收集电子邮件地址的人实体。这将呈现为一个 java util集的以实例:

private Set emailAddresses = new HashSet();

public Set getEmailAddresses() {

return emailAddresses;

}

public void setEmailAddresses(Set emailAddresses) {

this.emailAddresses = emailAddresses;

}

映射的集如下:

</set>

区别与早期的映射是使用这个元素这告诉Hibernate的一部分集合不包含引用到另一个实体,但是而一个集合的元素是值类

型,这里特别类型的字符串。小写的名字告诉你的这是一个Hibernate映射类型/转换器。又表属性的集元素决定了表名

称的集合。这个关键元素定义了外键列名字在收集表。这个列属性元素元素定义了列名称邮件地址值实际上会被存

储。

这是更新的模式:

_____________ __________________

| | | | _____________

|_____________| |__________________| | PERSON | | |

| | | | |_____________| | PERSON_EMAIL_ADDR |

| *EVENT_ID | <--> | *EVENT_ID | | | |___________________|

| TITLE | |__________________| | AGE | | *EMAIL_ADDR |

|_____________| | FIRSTNAME | |___________________|

| LASTNAME |

|_____________|

您可以看到,主键的集合表实际上是一个复合键使用这两列。这也意味着,不能有重复的电子邮件地址每个人,这正是我们需要

的做的语义在Java集合。

你现在可以尝试添加到这个集合的元素,就像我们之前做的连接人与事件。它是相同的Java代码中:

private void addEmailToPerson(Long personId, String emailAddress) {

Session session = HibernateUtil.getSessionFactory().getCurrentSession();

session.beginTransaction();

Person aPerson = (Person) session.load(Person.class, personId);

// adding to the emailAddress collection might trigger a lazy load of the collection

aPerson.getEmailAddresses().add(emailAddress);

session.getTransaction().commit();

}

这次我们没有使用取查询初始化集合。监控SQL日志和尝试优化这一渴望获取。

1 2 5。双向关联

接下来你将地图一个双向关联。你会让人之间的关系和事件双方的工作在Java。数据库模式不改变,那么你仍将有多对多的

多重性。

注意

关系数据库是比网络更灵活编程语言,它不需要一个导航方向;数据可以查看和检索在任何可

能的的方式。

首先,添加一组参与者到事件类:

private Set participants = new HashSet();

public Set getParticipants() {

return participants;

}

public void setParticipants(Set participants) {

this.participants = participants;

}

现在地图这一边的协会事件hbm xml 。

<many-to-many column="PERSON_ID" class="Person"/>

</set>

这些都是正常的集映射在两个映射文档。注意,列名称关键和多对多在这两个映射文档交换。最重要的是增加

逆= " true " 属性集元素的事件的集合的映射。

这意味着Hibernate应该采取其他的方面, 人类, 当它需要找出信息之间的联系这两个。这将是更容易了解一旦你看到如何在

两个实体之间的双向链接创建。

1.2.6中。工作双向链接

首先,记住,Hibernate不会影响正常的Java语义。我们如何创建一个联系人和一个事件在单向例子吗? 你添加的一个实例

事件采集事件引用, 的实例人。如果你想让这个链接双向的,你必须做同样的另一方面通过添加人引用的集合事件。这

个过程的“设置双方的联系” 与双向链接是绝对必要的。

许多开发人员程序防守和创建链接管理方法双方设置正确(例如,在人 ):

protected Set getEvents() {

return events;

}

protected void setEvents(Set events) {

this.events = events;

}

public void addToEvent(Event event) {

this.getEvents().add(event);

event.getParticipants().add(this);

}

public void removeFromEvent(Event event) {

this.getEvents().remove(event);

event.getParticipants().remove(this);

}

get和set方法的收集现在被保护。这允许类相同的包和子类还访问方法,但可以防止别人改变直接的集合。重复的步骤集合

另一方面。

那逆映射属性? 为你和为Java,一个双向的链接是一个简单的事双方设置引用正确。冬眠,但是,没有有足够的信息要正确安

排SQL 插入和更新语句(以避免约束违反)。使一侧的协会逆告诉Hibernate考虑它镜另一边的。这是所有的,是必要的

对于Hibernate来解决任何问题时出现的改变一个方向导航模型一个SQL数据库模式。规则很简单:所有的双向关联需要一边

逆。在一对多关联必须多方位的, 和在多对多关联您可以选择任何一方。

1.3。第3部分- EventManager web应用程序

一个Hibernate的web应用程序使用会话和事务几乎像一个独立的应用程序。然而,一些常见的模式是很有用的。你现在可

以写一个 EventManagerServlet 。这个servlet可以列出所有事件存储在数据库,它提供了一个HTML表单来输入新事件。

1.3.1。写作基本servlet

首先,我们需要创建我们的基本处理servlet。因为我们的 servlet只处理HTTP 得到请求,我们只会实现 doGet() 方法:

package org.hibernate.tutorial.web;

// Imports

public class EventManagerServlet extends HttpServlet {

protected void doGet(

HttpServletRequest request,

HttpServletResponse response) throws ServletException, IOException {

SimpleDateFormat dateFormatter = new SimpleDateFormat( "dd.MM.yyyy" );

try {

// Begin unit of work

HibernateUtil.getSessionFactory().getCurrentSession().beginTransaction();

// Process request and render page...

// End unit of work

HibernateUtil.getSessionFactory().getCurrentSession().getTransaction().commit();

}

catch (Exception ex) {

HibernateUtil.getSessionFactory().getCurrentSession().getTransaction().rollback();

if ( ServletException.class.isInstance( ex ) ) {

throw ( ServletException ) ex;

}

else {

throw new ServletException( ex );

}

保存这个servlet作为 src / main / java / org/hibernate/tutorial/web/eventmanagerservlet.java

该模式应用在这里叫使用“按请求会话”模式。当一个请求击中servlet时,一个新的Hibernate 会话是通过第一次调用打

开 getCurrentSession() 在 SessionFactory 。数据库事务是开始。所有数据访问发生在一个事务,无论读或写数据。不使

用自动提交模式在应用程序。

做不使用一个新的Hibernate 会话对于每一个数据库操作。使用一个Hibernate 会话这是作用域为整个请求。使用

getCurrentSession() ,所以, 它是自动绑定到当前的Java线程。

接下来,可能操作处理的请求和响应的HTML 呈现。我们将去那部分很快。

最后,工作单元结束时处理和渲染完成。如果任何问题发生在处理和呈现,将会抛出一个异常和数据库事务回滚。这就完成了

使用“按请求会话”模式模式。而不是事务界定在每个servlet的代码,你也可以写一个servlet过滤器。看到Hibernate网站

和Wiki的更多信息这一模式称为公开会议针对。你需要它作为很快当你考虑渲染你的视图JSP,而不是在一个servlet。

1.3.2。处理和渲染

现在你可以执行请求的处理和渲染的页面。

// Write HTML header

PrintWriter out = response.getWriter();

out.println("<html><head><title>Event Manager</title></head><body>");

// Handle actions

if ( "store".equals(request.getParameter("action")) ) {

String eventTitle = request.getParameter("eventTitle");

String eventDate = request.getParameter("eventDate");

if ( "".equals(eventTitle) || "".equals(eventDate) ) {

out.println("<b><i>Please enter event title and date.</i></b>");

}

else {

createAndStoreEvent(eventTitle, dateFormatter.parse(eventDate));

out.println("<b><i>Added event.</i></b>");

}

// Print page

printEventForm(out);

listEvents(out, dateFormatter);

// Write HTML footer

out.println("</body></html>");

out.flush();

out.close();

这种编码风格,混合了Java和HTML,不会规模在一个更复杂的应用程序;记住,我们只是说明基本概念在本教程中,冬眠代码将

输出一个HTML 页眉和页脚。在这个页面,一个HTML表单事件条目和一个列表的所有事件在数据库被打印。第一个方法是

琐碎的,只有输出HTML:

private void printEventForm(PrintWriter out) {

out.println("<h2>Add new event:</h2>");

out.println("<form>");

out.println("Title: <input name='eventTitle' length='50'/><br/>");

out.println("Date (e.g. 24.12.2009): <input name='eventDate' length='10'/><br/>");

out.println("<input type='submit' name='action' value='store'/>");

out.println("</form>");

}

这个 listEvents() 方法使用Hibernate 会话绑定到当前线程执行查询:

private void listEvents(PrintWriter out, SimpleDateFormat dateFormatter) {

List result = HibernateUtil.getSessionFactory()

.getCurrentSession().createCriteria(Event.class).list();

if (result.size() > 0) {

out.println("<h2>Events in database:</h2>");

out.println("<table border='1'>");

out.println("<tr>");

out.println("<th>Event title</th>");

out.println("<th>Event date</th>");

out.println("</tr>");

Iterator it = result.iterator();

while (it.hasNext()) {

Event event = (Event) it.next();

out.println("<tr>");

out.println("<td>" + event.getTitle() + "</td>");

out.println("<td>" + dateFormatter.format(event.getDate()) + "</td>");

out.println("</tr>");

}

out.println("</table>");

}

最后, 商店行动是被派去的 createAndStoreEvent() 方法,它也使用这个会话当前线程:

protected void createAndStoreEvent(String title, Date theDate) {

Event theEvent = new Event();

theEvent.setTitle(title);

theEvent.setDate(theDate);

HibernateUtil.getSessionFactory()

.getCurrentSession().save(theEvent);

}

servlet现在已经完成。一个请求,servlet将被处理在一个会话和事务。作为早在独立的应用程序,Hibernate可以自动绑

定这些对象当前执行的线程。这给了你更多的自由层你的代码和访问 SessionFactory 在任何一种你喜欢的方式。通常你

会使用更复杂的设计和移动数据访问代码到数据访问对象(DAO模式)。看到Hibernate Wiki更多的例子。

1.3.3。部署和测试

要部署这个应用程序进行测试,我们必须创建一个 Web归档(战争)。首先我们必须定义战争的描述符作为

src / main / webapp / - inf / web . xml

<?xml version="1.0" encoding="UTF-8"?>

<web-app version="2.4"

xmlns="http://java.sun.com/xml/ns/j2ee"

xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd">

剩余206页未读，继续阅读

月色依然

粉丝: 0
资源: 16

Hibernate 4.1中文API指南：入门到高级映射

java SSH Struts2+Spring3+Hibernate4+Maven+EasyUI 源码+视频 百度网盘

hibernate4.2.4 api chm

Hibernate4中文帮助文档(中文教程)

hibernate-jpa-2.1-api 1.0.2

Spring4.1+Hibernate4.3报org.hibernate.cache.spi.RegionFactory或org.hibernate.engine.spi.CacheImplement...

hibernate 有几种查询方式

hibernate购物系统下载

hibernate和mybatis可以整合到一起吗

hibernate 映射文件增删改查

springboot和hibernate整合

unknown collection expression type [org.hibernate.query.criteria.internal.pa

hibernate3 升级

hibernate的使用方法

hibernate6新特性

什么是hibernate，请详细的告诉我，我要如何才能快速上手，请给我几个demo

Struts2和Hibernate5是怎样整合的？

hibernate怎么使用？

hibernate连接mysql数据库

hibernate在spring中怎么配置

java 配置hibernate_java中Hibernate的环境配置

最新资源

java SSH Struts2+Spring3+Hibernate4+Maven+EasyUI 源码+视频百度网盘