此笔记位置已失效,请从目录继续阅读。
全书导读
这本2009年中文版沿音乐收藏示例,从Java对象与数据库表的映射开始,逐步增加关联、查询、自定义类型,再集成构建工具、Spring和Web框架。每章在既有项目上扩展,阅读时需把映射、生成产物、会话、事务及请求边界分别理解。具体操作限定于原书Hibernate 3.2等历史版本,不据旧接口说明推断当前兼容性。
全书主线
对象模型需要跨进程保存,但它的身份、引用与生命周期并不天然等同于表和外键。映射把两种表示连接起来,会话管理交互中的对象状态,事务决定一组数据库操作的提交边界。后续的关联、查询及框架集成都在扩展这些基本责任,而不是让一个工具自动包办全部正确性。
前置说明
本书要解决的是Java程序停止以后,怎样仍能保留并重新取回对象所代表的信息。Hibernate是对象关系映射工具:程序使用对象及引用,数据库使用表、行和键,映射规定两者怎样对应。前言说明这套能力可以在普通Java程序中使用,并不要求先建立EJB容器。作者以逐步扩大的音乐收藏项目教学,各章快照是可独立核对的环境基线;它们之间的配置变化本身也是学习内容。
O’Reilly Media,Inc.介绍
出版社介绍说明本书的技术出版背景与开发者作者群。营销评价和市场地位是当时的出版说明,不作为Hibernate行为或性能的技术证据。
译者序
译者从手写JDBC与SQL的重复劳动引出ORM持久层,再介绍全书从数据映射走向工具集成的路线。Hibernate依赖JDBC驱动和具体数据库,不能将序中“没有兼容性问题”的宣传式表述解释为任意组合无条件兼容;其独立持久层身份也不要求部署在EJB容器。
持久化服务不依附EJB容器进一步说明相关机制、操作条件与边界。
原书依据 · 1 处
前言
前言将Hibernate定位为普通Java对象与关系数据库之间的映射服务,减少SQL嵌入和JDBC结果装配劳动。作者早期工具先把SQL模板外置并具名访问,再添加对象映射指令,说明查询组织与对象装配是不同层次。Hibernate可独立使用,也可配合EJB;书中的JPA名称与时代背景应按历史语境理解,不把产品选择写成通用结论。
SQL模板与对象映射分工不同进一步说明相关机制、操作条件与边界。
原书依据 · 1 处
本书怎么使用
本书以开发者笔记和渐进示例组织学习,不是完整API参考。前几章建立可运行基础后,读者可按任务跳转,但仍须认识每章例子依赖前章模型和配置,不能把局部片段当成独立项目。
本书排版字体约定
字体约定区分术语、代码标识符、命令输入与输出,阅读时应辨认字面文本和需要替换的内容,避免把输出直接当作待执行命令。
本书网站
示例按章节保存状态快照,包含前面章节积累及当前新增内容。复现某一章时应选择对应完整快照,而不是从所有目录各取最新同名文件,混成未定义组合。
章节快照保存完整示例状态进一步说明相关机制、操作条件与边界。
原书依据 · 1 处
如何联系我们
联系说明提供当时的勘误、示例及技术反馈渠道。这里只记录出版支持入口,不发送联系信息,也不据旧地址判断今天的服务状态。
致谢
致谢交代三位作者及技术审阅者的协作,确认Spring、Maven和Stripes示例来自多人贡献;Stripes示例另外说明Apache许可文件位置。感谢与个人经历不作为技术论证,引用到的书籍作为延伸线索登记。
第一部分 Hibernate快速入门
第一部分先建立Hibernate 3的独立运行环境,再依次加入映射、对象操作及Java标注。第二部分才把它接到其他组件;示例以特定工具版本为前提,附录E专门讨论软件持续更新造成的差异。
第1章 安装和设置
运行一个Hibernate示例,需要的不只是Hibernate的JAR。构建工具要知道依赖的具体坐标及版本,Java进程要有包含驱动、映射和配置文件的类路径,数据库则需要明确存储位置。Ant描述要执行的任务,Maven Ant Tasks负责解析依赖;两者协作,并不意味着它们共享一切运行配置。本章先把这些前提安排好,为后续映射和查询建立可重复启动的基线。
第1章 安装和设置
先安装Ant并配置ANT_HOME和bin路径,让构建、测试、运行与打包具有统一入口。本书主要以Ant组织示例,借Maven Ant Tasks解决依赖下载;完整Maven路线留到第12章,不能把二者误当成同一个工具。Ant 1.7等名称是书中环境线索,不是当前安装建议。
构建入口与依赖下载分开配置进一步说明相关机制、操作条件与边界。
原书依据 · 1 处
检查Java版本
用java -version及ant -version核对实际运行环境,而不是只看安装过哪些软件。示例以Java 5以上及当时的Ant为前提,命令行可作为IDE以外的统一构建入口;关于GNU Java和发行版的评论仅为当时实测背景,不推广成今天的兼容性结论。
先核对实际使用的工具版本进一步说明相关机制、操作条件与边界。
原书依据 · 1 处
获得Maven Tasks for Ant
Maven Ant Tasks让Ant脚本声明并获取依赖,安装可选公共lib目录或在构建中用typedef引用antlib。原书为减小示例配置选择前者;全局安装方便多个构建,但也形成环境依赖。
依赖任务安装范围须明确进一步说明相关机制、操作条件与边界。
安装Maven Tasks for Ant
公共Ant安装目录无权限时,可以把任务JAR放入用户级.ant/lib,并通过ant -diagnostics检查它是否真正进入运行类路径。文件已复制与任务可加载是不同事实。
依赖任务安装范围须明确进一步说明相关机制、操作条件与边界。
使用HSQLDB数据库引擎
HSQLDB是纯Java关系数据库,提供JDBC驱动,支持嵌入和服务器运行以及内存和磁盘表。它简化本书的独立示例,不表示数据只能放内存,也不代表将来换库无需检查SQL方言;原书可由依赖任务获取对应版本。
嵌入式数据库降低示例依赖进一步说明相关机制、操作条件与边界。
原书依据 · 1 处
获得Hibernate Core
Hibernate Core负责对象关系映射运行时,Hibernate Tools提供代码和映射等开发工具。工具不是运行应用的必需组件,两者版本号也未必相同,应按兼容矩阵配套;下载页面的推荐和产品版本均为成书时状态。
运行时与开发工具分别配套进一步说明相关机制、操作条件与边界。
原书依据 · 1 处
建立项目层次结构 · 连续片段1
项目以src、classes、data分开源码、编译资源和数据库文件,手写类与生成数据类再分包。Ant构建通过命名属性集中目录,Maven任务声明依赖,再把应用输出与依赖类路径组合起来。db目标启动HSQLDB管理器,是验证工具链和数据库入口的最小完整性检查,不是应用全部功能测试。
项目目录分开源码产物与数据进一步说明相关机制、操作条件与边界。
用最小任务验证完整类路径进一步说明相关机制、操作条件与边界。
建立项目层次结构 · 连续片段2
依赖坐标先定位版本,再由pathId汇总类路径;编译和运行使用同一依赖集合。Ant目标是一组有序任务,java fork另启虚拟机承载数据库GUI。数据库首次打开会创建文件,示例无密码只为本地练习,不能据此外推网络部署配置;仓库永久可用也只是书中预期,非本轮承诺。
依赖坐标标识版本化产物进一步说明相关机制、操作条件与边界。
独立虚拟机承载外部工具进一步说明相关机制、操作条件与边界。
建立项目层次结构 · 连续片段3
下载日志表明直接与传递依赖已被获取,随后db目标打开管理器;确认连接到data/music,再正常退出并查看生成文件。properties、script与log分别保存设置、SQL表示数据及恢复相关日志。BUILD SUCCESSFUL及Total time是该演示的结果,不能当成整个应用的正确性或性能证明。
数据库文件分别承担状态与恢复进一步说明相关机制、操作条件与边界。
用最小任务验证完整类路径进一步说明相关机制、操作条件与边界。
建立项目层次结构 · 连续片段4
exclusion排除旧JTA依赖后显式加入Geronimo JTA API。Maven先查本地仓库,再按POM遍历传递依赖,多个项目可共用缓存;print-classpath帮助查看真实解析结果。故障排查应区分脚本、安装路径、项目布局与网络下载。
传递依赖由元数据递归解析进一步说明相关机制、操作条件与边界。
原书依据 · 1 处
第2章 映射简介
对象关系映射首先是一份对应关系:某个类保存在哪张表,属性使用哪些列,哪个值能标识同一个持久对象。本书先从映射XML出发生成Java类和数据库模式,而不是要求程序员分别手写三套重复结构。主键生成负责数据身份,源码生成负责Java文件,两者名字相似但职责不同。模式导出用于本章可丢弃的样例库,不能直接当成保留既有数据的迁移工具。
第2章 映射简介 · 连续片段1
ORM把对象信息写入关系表,再从记录装配对象;数据库不是唯一可能的保存介质,原书聚焦关系数据库。可从已有库、已有类或全新映射起步,本书选择中间映射文档生成两端。class、id、property决定运行时映射,meta主要供工具生成注释,二者不可混同。
对象关系映射要解决的问题进一步说明相关机制、操作条件与边界。
映射起点由既有资产决定进一步说明相关机制、操作条件与边界。
映射与生成元信息职责不同进一步说明相关机制、操作条件与边界。
第2章 映射简介 · 连续片段2
id映射将对象身份对应数据列,示例采用无业务含义的代理整数键并限制手工改ID;generator的native策略由数据库提供生成方式,与Java代码生成不是一回事。属性类型、可空约束及文档元信息再分别声明。
代理键的设计原则进一步说明相关机制、操作条件与边界。
主键生成与源码生成分开进一步说明相关机制、操作条件与边界。
生成Java类 · 连续片段1
Ant taskdef把Hibernate Tools接入构建,codegen目标遍历.hbm.xml并调用hbm2java生成源文件。输出仍需核对包、类型、构造器与访问权限是否符合映射;Log4j未配置警告不等于映射生成失败。示例有calss等排版拼写错误,复现时须按真实配置核对。
从映射生成数据类进一步说明相关机制、操作条件与边界。
原书依据 · 1 处
生成Java类 · 连续片段2
生成类的包、字段、JavaDoc、构造器与protected主键setter分别来自映射及meta。生成器下次运行可能覆盖手改,应把自写逻辑与生成产物隔离。这里使用JavaBean属性访问和反射,不应把本例的getter/setter要求扩展成所有Hibernate映射方式一律如此。
生成代码不应手工修改进一步说明相关机制、操作条件与边界。
属性访问约定须匹配映射方式进一步说明相关机制、操作条件与边界。
编制数据库Schema · 连续片段1
方言封装不同数据库的SQL差异,驱动、连接URL与账号建立实际连接;properties放类路径根是默认查找约定。prepare把资源复制到classes,再由schema读取映射生成DDL。示例明确drop=yes会先删旧表,不能用于有数据环境的无损迁移;嵌入数据库结束时的关闭也须配套。
驱动连接与SQL方言各有职责进一步说明相关机制、操作条件与边界。
导出模式不等于无损迁移进一步说明相关机制、操作条件与边界。
运行资源也属于构建产物进一步说明相关机制、操作条件与边界。
编制数据库Schema · 连续片段2
日志配置把schema工具的DDL、SQL与连接资源信息显露出来,示例输出显示删除后创建TRACK及内建连接池的非生产提示。日志有助核对实际数据库、方言与执行语句;调试级别与参数日志需按诊断范围设置,不能仅看BUILD SUCCESSFUL忽略破坏性操作。
日志按待验证机制选范围进一步说明相关机制、操作条件与边界。
原书依据 · 1 处
编制数据库Schema · 连续片段3
初次构建存在引导顺序:Ant启动时解析路径,classes尚不存在时,单次运行中的prepare未必让已解析路径立即重算,因此示例先单独prepare再schema。表创建后仍要检查真实数据库。ID策略还可自定义,hi/lo与UUID在这里只提名,不能凭名字补写算法。
首次构建先完成类路径引导进一步说明相关机制、操作条件与边界。
原书依据 · 1 处
第3章 驾驭Hibernate
SessionFactory代表配置好的持久化环境,创建成本较高,可以由多个工作单元共享;Session则跟踪一次交互中所使用的对象,不能作为多线程共享状态。对象尚未被会话管理时是瞬时对象,关联到会话以后受其跟踪,脱离会话后仍可能保留数据库身份。事务另行决定哪些数据库操作一起提交或回滚。理解这三个责任后,保存、查询和删除就不再只是背诵方法名:需要同时确认对象状态、会话是否有效、事务怎样结束。
第3章 驾驭Hibernate · 连续片段1
XML配置集中描述方言、JDBC、连接池、会话上下文、缓存和映射资源,再让代码生成与DDL任务引用同一配置。示例为了诊断关闭JDBC批处理,并打印SQL;关闭二级缓存不等于绕过持久化上下文或每次属性变化立刻发SQL,刷新与提交要结合后文会话事务解释。
集中配置统一映射入口进一步说明相关机制、操作条件与边界。
诊断配置与性能配置分别取舍进一步说明相关机制、操作条件与边界。
第3章 驾驭Hibernate · 连续片段2
构建任务转而读取hibernate.cfg.xml中的连接与映射信息,不再自己扫描和重复组织映射文件集。本段完成上一片段的配置改造,与后续Java代码共用同一入口。
集中配置统一映射入口进一步说明相关机制、操作条件与边界。
创建持久化对象 · 连续片段1
Configuration读取配置并创建代价较高、可共享的SessionFactory;工厂提供非线程安全的Session,后者承载有限交互范围内的对象状态跟踪。工厂可按不同数据库环境分别配置,不是应用绝对只能一个。save把新对象交给上下文管理;变化何时真正提交须看事务,不能把关闭会话当成提交。
工厂共享会话隔离进一步说明相关机制、操作条件与边界。
对象状态与会话关联相区分进一步说明相关机制、操作条件与边界。
创建持久化对象 · 连续片段2
脱管对象在内存中仍有数据与身份,但不再自动同步;后续保存需重新关联,并考虑并发修改与版本约束。事务代码在成功时commit、失败时rollback、finally关闭Session,工厂则在应用结束时关闭。Ant的depends先执行资源准备和编译,再运行示例,而非只依赖IDE缓存。
脱管更新仍需并发完整性约束进一步说明相关机制、操作条件与边界。
事务结局与资源清理分开进一步说明相关机制、操作条件与边界。
对象状态与会话关联相区分进一步说明相关机制、操作条件与边界。
创建持久化对象 · 连续片段3
日志展示配置、方言、工厂初始化、INSERT、主键获取及最终关闭,再通过管理器查询真实三行数据。所列日志的batch size与前文关闭批处理配置不一致,因此只把它作演示输出,不冒称已经验证某值生效。原书强调持久化工作使用明确事务,控制台自动提交的便利不应直接搬成应用多步操作的事务设计。
示例输出也要核对配置一致性进一步说明相关机制、操作条件与边界。
创建持久化对象 · 连续片段4
数据库脚本尾部三条INSERT对应已创建曲目,默认账号与模式信息只适合隔离演示。对象关联在下一章继续扩展;这里没有新增独立操作,主要是用真实数据库状态核对之前保存结果。
示例输出也要核对配置一致性进一步说明相关机制、操作条件与边界。
检索持久化对象 · 连续片段1
HQL按映射类和属性查询,返回整实体时可省select;参数通过占位符和类型绑定传入,而非拼进语句文本。查询仍需有效Session及清理,示例的只读路径省略显式事务,不应推广为多次查询自然具有一致快照。原例字符串拼接还需保留from与where间空格。
HQL按对象属性而非列名查询进一步说明相关机制、操作条件与边界。
原书依据 · 1 处
检索持久化对象 · 连续片段2
清空演示表的schema会删表重建,单条删除可把对象交给Session.delete,批量删除则用HQL executeUpdate;所有实际修改仍需事务提交。对象在Java中仍有引用和记录是否被删除不同,不能以引用存在判断数据库行仍在。
删除记录不等于销毁对象引用进一步说明相关机制、操作条件与边界。
原书依据 · 1 处
建立查询的更好方法
命名参数用名称表达意图、按类型设值,避免位置计数;命名查询把文本移到映射文档,再由getNamedQuery取得,XML特殊字符可用CDATA处理。二者可组合但职责不同,原书关于性能提升只是特定可能性,不能说命名天然使查询更快。条件及示例查询在后文展开。
命名参数与命名查询的价值进一步说明相关机制、操作条件与边界。
原书依据 · 1 处
第4章 集合与关联
一首曲目可对应多个艺人,一个艺人也可对应多首曲目,因此表之间用连接表保存组合,对象之间用集合表达导航。集合选Set还是List等形式,会影响重复与顺序语义。双向导航只有一份数据库关系,映射必须明确哪一端负责写回;Java内存中两端引用仍需正确维护。本章随后以保存、反向查询和无成员场景检查这套对应关系,并补充不具实体身份的字符串值集合。
第4章 集合与关联 · 连续片段1
集合可表达艺人与曲目的多对多关系,连接表的一行对应一对身份,不必额外暴露为业务对象。Set与可重复的bag语义不同;列的唯一性、索引和代码生成meta也各有职责,不能把索引等同唯一约束。两个方向的集合须指向同一连接表,下一片段再指定哪端负责关系写回。
连接表表达多对多关系进一步说明相关机制、操作条件与边界。
集合类型先决定重复语义进一步说明相关机制、操作条件与边界。
第4章 集合与关联 · 连续片段2
双方共享TRACK_ARTISTS表时,inverse端不负责自动写回链接,非inverse端的集合变更才驱动更新,但内存中的两侧仍需应用维护。生成器jdk5=true加入参数化Set,减少强转及未检查警告;缺映射资源则先核对首次prepare与类路径,不必误改映射本身。
双向关联需要一个权威端进一步说明相关机制、操作条件与边界。
生成集合类型也需启用泛型进一步说明相关机制、操作条件与边界。
第4章 集合与关联 · 连续片段3
更新后的DDL展示实体表、连接表、联合主键、索引及外键。DROP不存在约束的异常在特定示例可不阻止后续创建,但不能把所有异常都忽略。对象模型通过集合维护关系,Hibernate按映射管理连接表,不需要每个应用调用点手写表操作;这不表示多对多只能用关系库表达。
连接表表达多对多关系进一步说明相关机制、操作条件与边界。
集合的持久化 · 连续片段1
示例先按名称查询艺人,不存在时根据create参数决定是否建立并显式save,再以集合操作把曲目与艺人关联。uniqueResult只容许零或一个结果;大小写归一查询与数据库唯一约束可能具有不同的等价规则,先查后建也不能单独保障并发唯一性。
查询单一结果须明确唯一规则进一步说明相关机制、操作条件与边界。
原书依据 · 1 处
集合的持久化 · 连续片段2
示例为每首曲目初始化空艺人集合,允许零个或多个关联;提交后通过实体表和连接表检查持久化结果。schema ctest会先清空重建数据,只能在可丢弃的演示环境使用。
连接表表达多对多关系进一步说明相关机制、操作条件与边界。
集合的检索
查询曲目后遍历Artist集合格式化姓名;无艺人的曲目返回空Set,遍历逻辑无需增加null特判。示例为观察输出关闭show_sql,此设置只影响SQL显示,不改变关联加载机制。
用空集合代替null进一步说明相关机制、操作条件与边界。
原书依据 · 1 处
使用双向关联 · 连续片段1
反向查询在新会话中读取Artist.tracks,用以验证连接表可支持双向导航。inverse标识决定关联写回责任,不保证自动同步已在内存中的两端集合。界面演示用invokeLater等待文本更新,并在finally关闭每次查询的Session。
双向导航不等于内存自动同步进一步说明相关机制、操作条件与边界。
使用双向关联 · 连续片段2
qtest2沿用compile依赖和项目classpath启动QueryTest2,图4-3展示反向关联查询结果;构建目标只是前一阅读单元界面验证的启动入口。
双向导航不等于内存自动同步进一步说明相关机制、操作条件与边界。
使用简单集合
简单字符串集合用element映射到独立表,key链接所属曲目,无须把每条评论建成独立实体。同步修改映射、生成类和构造调用后,插入并重新查询评论验证结果。COMMENT在Oracle是保留字,跨数据库要检查标识符。
值集合也需要持久化存储进一步说明相关机制、操作条件与边界。
原书依据 · 1 处
第5章 更复杂的关联
专辑中的曲目不只是一组引用:它还有唱片编号、位置和播放顺序。这些信息属于曲目在该专辑中的使用,而非共享曲目本身,所以本章引入AlbumTrack组件。组件没有独立持久化身份,但可以具有自己的Java类和集合表。与此同时,关联的加载时机、操作传播和对象存续是不同问题:延迟加载决定何时取数,cascade决定操作沿关联传播,列表移除则未必意味着删除共享实体。
第5章 更复杂的关联
延迟关联通过代理或持久化集合把取数推迟至访问时;关闭会话后访问未初始化关联会失败。应围绕实际工作单元安排加载和会话边界,不能用贯穿用户等待的事务掩盖问题。原书本段把会话等同单个事务,与第3章同一Session可跨事务的讨论不一致,笔记明确区分。
延迟加载与会话边界的矛盾进一步说明相关机制、操作条件与边界。
原书依据 · 1 处
有序集合
List持久化额外保存位置列,因为专辑中的曲目顺序是独立于曲目属性的信息。若顺序可从现有值推导,可采用Java排序或数据库order-by而非额外维护位置。
持久顺序需要独立的数据进一步说明相关机制、操作条件与边界。
原书依据 · 1 处
扩充集合中的关联 · 连续片段1
专辑与曲目的关系携带唱片编号和唱片内位置,故不能只保存两端ID;AlbumTrack用composite-element表达无独立持久化身份的关联组成部分,并通过many-to-one引用可共享的Track实体。
实体与组件的区别进一步说明相关机制、操作条件与边界。
关联有属性时需显式建模进一步说明相关机制、操作条件与边界。
扩充集合中的关联 · 连续片段2
工具从复合元素映射生成AlbumTrack类而不产生id,模式则把组件属性放在ALBUM_TRACKS集合表。外键命名为目标主键名是书中便于识别的约定,不是正确性的必要条件。重建演示模式可能遇到约束删除次序问题,删除数据库文件仅限可丢弃样例。
生成结果要跨三层核对进一步说明相关机制、操作条件与边界。
扩充集合中的关联 · 连续片段3
独立Track允许单曲存在并在多个专辑共享;AlbumTrack行由Album及列表位置定位。示例显式保存Track再把新组件加入Album列表,atest目标编译并启动演示。
关联有属性时需显式建模进一步说明相关机制、操作条件与边界。
扩充集合中的关联 · 连续片段4
依次运行ctest和atest建立曲目及专辑,qtest核对原有查询仍能读取新增曲目,再检查ALBUM_TRACKS核对顺序及关联属性。日志包含后续章节才解释的Volume与sourceMedia字段,不能据此声称本章已配置这些类型。
生成结果要跨三层核对进一步说明相关机制、操作条件与边界。
关联的生命周期
从Album列表移除组件会删除集合行并调整位置,但不会自然删除所引用的独立Track。cascade传播明确的持久化操作,与inverse写回责任及孤儿删除不同。原文关于many-to-one可配置delete-orphan的泛化有风险,保留为需按版本与关联类型核验的说法,不转成通用操作建议。
级联传播须匹配生命周期进一步说明相关机制、操作条件与边界。
原书依据 · 1 处
自身关联
Artist通过many-to-one自关联将多条别名记录指向同一真实艺人,查询命中后作一次规范化跳转。示例不是任意深度的树遍历,也没有自动防止别名环。Java属性是Artist引用,数据库字段才保存目标标识。
自身关联建模递归结构进一步说明相关机制、操作条件与边界。
原书依据 · 1 处
第6章 自定义值类型
自定义值类型是在业务对象与存储格式之间放置转换器。SourceMedia枚举演示一个值如何转成一列字符串;StereoVolume则把一个左右声道值保存为两列,并让查询可以看到其子属性。转换器不仅负责读写,还必须说明相等性、可变性、复制和缓存表示。不可变枚举可以共享同一实例,可变音量值则要复制状态。最后,生成器需要提前加载适配类,本章据此把构建依赖也纳入正确性范围。
第6章 自定义值类型
自定义类型适用于Java表示与既有数据库表示不一致,或需把复合值映射封装成可复用转换逻辑。UserType与CompositeUserType由外置适配类实现,不要求业务值类承担自身持久化。关于Hibernate无枚举内建支持仅代表作者所述历史环境,后文注解章节仍需区分。
自定义类型隔离存储转换进一步说明相关机制、操作条件与边界。
定义一个持久化的枚举类型
SourceMedia以Java5 enum定义固定选项和人可读说明,持久化支持后加而不改变枚举定义。显示说明与枚举身份分开;后续适配器决定实际存储表示。
自定义类型隔离存储转换进一步说明相关机制、操作条件与边界。
使用自定义的类型映射 · 连续片段1
SourceMediaType实现UserType,将枚举映射为VARCHAR。CompositeUserType的选择依据不是列数本身,而是是否需要在查询中暴露复合值的命名属性。不可变枚举允许共享实例,读写函数处理SQL null,未知枚举名则抛映射异常。
自定义类型须定义双向契约进一步说明相关机制、操作条件与边界。
原书依据 · 1 处
使用自定义的类型映射 · 连续片段2
其余方法实现缓存拆装、相等一致的哈希及merge替换。空值需在相关方法契约下处理;书中hashCode直接解引用,与文字的所有方法都应容忍null不完全一致。映射文件的type指向适配类。枚举适配器可参数化复用,但书中wiki提名不等于验证过的正式发布功能。
枚举存储编码须保持可逆进一步说明相关机制、操作条件与边界。
原书依据 · 1 处
使用持久化的枚举对象 · 连续片段1
映射type填写SourceMediaType,但生成的属性应为returnedClass所声明的SourceMedia。若代码生成时适配类还未编译,工具可能误判;新加usertypes目标提前编译不依赖生成类的适配器,解除构建循环。
代码生成依赖也要显式建模进一步说明相关机制、操作条件与边界。
使用持久化的枚举对象 · 连续片段2
将schema依赖compile、compile依赖codegen、codegen依赖usertypes,确保干净环境仍能构建。取回枚举后用description显示,但数据库仍保存枚举编码;以null曲目检查空值分支。
验证映射须覆盖回读与空值进一步说明相关机制、操作条件与边界。
代码生成依赖也要显式建模进一步说明相关机制、操作条件与边界。
使用持久化的枚举对象 · 连续片段3
专辑对象输出继续展示来源媒介持久化结果;枚举支持缺失的判断是原书当时的技术评价,不代表后续版本。本单元收束同一案例,没有新增独立机制。
验证映射须覆盖回读与空值进一步说明相关机制、操作条件与边界。
建立组合自定义类型 · 连续片段1
StereoVolume把左右声道封装成可变值,setter验证0至100,equals/hashCode按值实现。CompositeUserType暴露left/right命名属性,让多个实体复用一致映射,不必重复每处组件配置。
复合值映射可集中复用进一步说明相关机制、操作条件与边界。
原书依据 · 1 处
建立组合自定义类型 · 连续片段2
命名属性数组、类型数组及按索引读写必须一致。StereoVolume可变,因此deepCopy创建独立值;持久化相等先处理同引用与null再比较内容。读列时任一声道为null即返回null,这是适配器明确选择的信息丢失策略。
可变值需要独立状态副本进一步说明相关机制、操作条件与边界。
复合空值规则须明确进一步说明相关机制、操作条件与边界。
建立组合自定义类型 · 连续片段3
复合类型写入两列,null时同时写空。缓存拆装与merge替换均深复制可变值,避免缓存和工作实例共享可变状态;内部SessionImplementor只是扩展接口提供的上下文,本例未使用其内部功能。
可变值需要独立状态副本进一步说明相关机制、操作条件与边界。
复合空值规则须明确进一步说明相关机制、操作条件与边界。
建立组合自定义类型 · 连续片段4
映射声明适配类并按左右声道次序给出两列,codegen生成StereoVolume类型属性,schema生成两个smallint。创建数据后检查表内左右值并更新AlbumTest构造调用。EnhancedUserType和ParameterizedUserType仅作为扩展接口提名。
复合类型列次序须逐项核对进一步说明相关机制、操作条件与边界。
原书依据 · 1 处
建立组合自定义类型 · 连续片段5
本单元仅为前文Java5 EnumUserType的脚注网址,不包含新的实现内容;链接保留在参考提名登记中。
第7章 映射标注
标注把映射信息写在类和字段附近,XML则让这份规定保持在外部。本章将前面的模型改写为标注,目的不是重新设计全部业务,而是比较映射入口改变后,代码生成、编译和模式导出怎样随之调整。标准JPA标注与Hibernate专有扩展混合使用,必须逐项辨认。原书示例在外键、级联和主键回顾上存在差异,因此理解等价性要核对实际身份、约束及行为,不能只看建表成功或字段名称相同。
第7章 映射标注 · 连续片段1
标注把映射与类定义放在一起,减少外部文件同步成本,也增加源代码与特定映射的耦合。改走标注时应停止覆盖手写实体的codegen,模式生成改为读取已编译标注类,并添加历史版本的标注库。
注解与外部映射文件的取舍进一步说明相关机制、操作条件与边界。
原书依据 · 1 处
第7章 映射标注 · 连续片段2
原生Session配置改用mapping class列出标注实体;compile仅依赖prepare,schema依赖编译。原文对JPA自动发现的说明是本书配置语境,不能推断任何启动方式均可无条件扫描所有类。
切换映射入口须同步构建进一步说明相关机制、操作条件与边界。
原书依据 · 1 处
为模型对象添加标注 · 连续片段1
Artist示例组合Entity、Table、Id、GeneratedValue和关联标注,命名查询可由NamedQuery定义;字段标注选择字段访问方式。Hibernate专用Index与JPA标注须区分。原文说标注后丧失命名查询优点,实际例子仍定义命名查询,失去的是本例外置查询文本的组织形式。
标准映射与扩展能力分开看进一步说明相关机制、操作条件与边界。
为模型对象添加标注 · 连续片段2
Track用Temporal区分同为Date的时间列和日期列,用CollectionOfElements映射值集合,用Enumerated STRING直接映射枚举。这说明第6章无内建枚举支持的说法必须限定其XML案例,不能扩展到所有接口。关联JoinTable的两端列名还需与拥有实体核对,不能仅照抄示例。
同一语言类型可有不同存储语义进一步说明相关机制、操作条件与边界。
原书依据 · 1 处
为模型对象添加标注 · 连续片段3
Embedded与Embeddable声明复合值,AttributeOverrides在使用处指定左右声道列。Album的组件列表依赖当时Hibernate CollectionOfElements和IndexColumn扩展,不能把本书对旧JPA能力限制的评价当成今天的规范限制。
嵌入值可在使用处覆盖列名进一步说明相关机制、操作条件与边界。
标准映射与扩展能力分开看进一步说明相关机制、操作条件与边界。
为模型对象添加标注 · 连续片段4
AlbumTrack仍为组件时,其Track关联虽然标注cascade,作者所用版本的集合路径未实现期望的自动保存,示例恢复显式save。schema日志不能证明映射等价,后续仍需检查约束和行为。
标准映射与扩展能力分开看进一步说明相关机制、操作条件与边界。
为模型对象添加标注 · 连续片段5
运行时改用AnnotationConfiguration,再用ctest、qtest与atest核对结果。BUILD SUCCESSFUL前仍报告hbm2ddl错误,日志将ALBUM_ARTISTS.ARTIST_ID引用到ALBUM,与列名语义不符,不能接受其映射完全等价的笼统结论。
构建成功不代表映射正确进一步说明相关机制、操作条件与边界。
另一种方法
为恢复本例级联路径,作者把AlbumTrack从组件改成实体,增加ID和到Album的只读列映射,Album改为OneToMany cascade。这改变身份和模式,不只是换语法。原文误述旧主键为Album与Track组合,前文实际为Album与列表位置。
为了级联而被迫升级为实体进一步说明相关机制、操作条件与边界。
重复列映射须确定写入责任进一步说明相关机制、操作条件与边界。
第8章 条件查询
Criteria把查询表达为Java对象:先确定查询根类型,再添加限制、排序和投影。限制决定哪些对象入选,投影决定取回什么形态的数据,排序决定结果怎样排列。关联子条件可以筛选根对象,却不自动把根对象的集合裁剪成命中成员。Example则从样例值推导条件,减少部分字符串属性引用,但默认值和空值规则仍需审视。这些表达方式最终都会生成数据库SQL,并不因为使用Java方法就消除查询语义错误。
第8章 条件查询 · 连续片段1
Criteria从持久化类建立查询并添加Restrictions,仍按对象属性名描述条件,最终生成SQL。Java调用结构可由编译器检查,但字符串属性名并不会因此自动成为编译期类型安全。
条件对象表达查询结构进一步说明相关机制、操作条件与边界。
原书依据 · 1 处
第8章 条件查询 · 连续片段2
Order按属性决定升降序,可忽略大小写;多个Order按添加顺序依次打破并列。setFirstResult与setMaxResults控制结果窗口,分页还需足够稳定的完整排序。
分页窗口依赖确定排序进一步说明相关机制、操作条件与边界。
组合式条件查询
多个add默认形成AND,disjunction显式建立OR分组,MatchMode表达字符串模式。原文把ilike说成区分大小写,并把OR说明成两个条件同时满足,均与API命名及实际示例不符,笔记按布尔结构记录并标明差异。
组合查询先确定布尔分组进一步说明相关机制、操作条件与边界。
原书依据 · 1 处
投影和聚合的条件查询 · 连续片段1
投影改变返回形态:单属性为该属性值列表,多属性为按选择次序排列的Object数组。groupProperty与rowCount/max在数据库分组计算,不必加载全部实体后自行统计。
投影改变查询结果契约进一步说明相关机制、操作条件与边界。
投影和聚合的条件查询 · 连续片段2
分组键可以为null,例中null来源媒介也形成统计行。通过as给投影结果命名,再用Order引用别名排序;未显式排序时,不依赖演示输出的偶然顺序。
投影改变查询结果契约进一步说明相关机制、操作条件与边界。
在关联中应用条件查询
关联子Criteria把条件应用在关联实体,但根查询仍返回Track;命中某个Artist不意味着返回Track的artists集合被裁剪为匹配子集。连接可能使根对象重复,DISTINCT_ROOT_ENTITY处理根结果,不能直接等同数据库select distinct的全部语义。
关联过滤不等于裁剪集合进一步说明相关机制、操作条件与边界。
原书依据 · 1 处
示例查询
Example从样例属性生成条件,默认忽略null,可选择排除零、包含空值或排除指定属性,并调整字符串匹配。setter拼写受编译检查,但样例默认值也可能意外进入条件,故要明确选择规则。
样例查询须审视默认值进一步说明相关机制、操作条件与边界。
原书依据 · 1 处
面向属性的Criteria工厂
Property工厂先选择属性,再建立限制、排序或投影,与Restrictions等是不同表达入口。forName依旧使用字符串,未增加字段编译期检查;高级子查询、离线查询等只做进一步阅读提名。
属性工厂改变表达起点进一步说明相关机制、操作条件与边界。
第9章 浅谈HQL
HQL是一种面向映射对象的查询语言,使用类名和属性,而不是直接操作物理表列。它可以取回实体,也可以投影属性、构造报表对象或计算摘要。返回List并不足以说明元素类型,改变select时就要同步调整调用契约。查询还可通过实体参数表达集合成员关系;当必须使用特定数据库函数或迁移既有SQL时,原生查询允许保留数据库能力,但必须明确返回映射并接受方言依赖。
第9章 浅谈HQL · 连续片段1
HQL面向映射类而不是表,类与属性名区分大小写,可用限定名称解决同名冲突。from java.lang.Object演示查询多种映射实体,但结果只具有共同Object接口,不是统一业务模型。
多态查询仍受映射边界约束进一步说明相关机制、操作条件与边界。
第9章 浅谈HQL · 连续片段2
该多态查询可能分解为多条SQL,本书提示此种情况下全结果排序与scroll受到限制;别名可区分同一类的多个查询角色。日志展示实体及其组件,不证明组件也独立成为查询根。
多态查询仍受映射边界约束进一步说明相关机制、操作条件与边界。
选择属性和其他部件
HQL select单属性返回标量,多属性返回按选择次序排列的数组;可用构造表达式生成报表对象。改变命名查询投影时,查询方法即使仍返回List,调用方也必须更新元素契约。
报表投影可建立明确结果对象进一步说明相关机制、操作条件与边界。
原书依据 · 1 处
排序
HQL用order by按对象属性排序,asc与desc控制方向,多属性处理并列;本例将标题倒序输出,与Criteria的Order表达同一排序意图。
分页窗口依赖确定排序进一步说明相关机制、操作条件与边界。
使用聚合值 · 连续片段1
聚合查询返回count/min/max的单行摘要;增加artist参数和elements集合成员条件,把统计限制在特定艺人的曲目内。普通列表的时长过滤与独立摘要查询是两种范围,不能混同。作者无法对时间类型求平均,也说明领域时长的存储表达会限制聚合。
聚合范围须单独核对进一步说明相关机制、操作条件与边界。
数据表示限制可执行的聚合进一步说明相关机制、操作条件与边界。
使用聚合值 · 连续片段2
实体实例可以作为查询参数,Hibernate据其标识及集合映射生成连接判断;返回结果的两首曲目与前面明细的5分钟限制不同,解释了表面上的不一致。
聚合范围须单独核对进一步说明相关机制、操作条件与边界。
编写原生SQL查询
原生SQL可使用数据库专属函数或逐步迁移既有查询,同时通过sql-query声明返回类和别名把结果装配为实体,仍能绑定命名参数。选择原生SQL须接受方言依赖并核对完整结果映射。
原生查询仍需明确结果映射进一步说明相关机制、操作条件与边界。
原书依据 · 1 处
第二部分 与其他工具的集成
第二部分从核心映射和查询转向数据库、IDE、构建和应用框架集成,先前示例工具用于教学基线,不代表所有项目的推荐栈。
第10章 将Hibernate连接到MySQL
把HSQLDB换成外部MySQL,能看出映射与数据库环境之间的分工。对象映射可以复用,驱动、URL、身份、方言与模式管理方式却要对应目标系统。先准备数据库访问条件,再观察实际连接日志、生成模式和回读结果。如果数据库已经存在且共享,就应从现有结构建立映射,而不是执行清空重建。本章的MySQL5命令和驱动名称只作为历史操作参考。
第10章 将Hibernate连接到MySQL
连接外部MySQL前先准备可用实例、目标数据库及应用访问身份,并区分数据库主机与应用客户端来源。书中MySQL5授权语法与示例凭据仅属历史演示,不复制为当前部署命令。
外部数据库先确认访问前提进一步说明相关机制、操作条件与边界。
连接到MySQL
增加MySQL Connector/J依赖,配置匹配的dialect、driver_class、URL及身份,清除HSQLDB专用任务和无用设置。移除禁用批处理的配置不代表已验证所有场景性能,应检查目标驱动的错误反馈和批处理行为。
更换数据库须核对完整配置进一步说明相关机制、操作条件与边界。
尝试一下 · 连续片段1
先prepare确保配置在类路径上,再执行schema;日志核对实际方言、驱动和URL,DDL采用MySQL auto_increment。此处仍先删除旧模式,操作仅适合可丢弃样例。
更换数据库须核对完整配置进一步说明相关机制、操作条件与边界。
尝试一下 · 连续片段2
MySQL生成模式包含集合复合键、自关联外键和目标数据库语法,末尾错误多为首次删除不存在的外键。必须按实际语句分类错误,不可将BUILD SUCCESSFUL当作所有DDL均成功。
构建成功不代表映射正确进一步说明相关机制、操作条件与边界。
查询数据
先检查建表结果,再运行ctest并查询验证数据。连接既有或共享库时应按现有模式建立映射,不重建模式;多个独立配置可建多个SessionFactory,但跨数据库对象复制不由这一配置自动解决。
既有数据库从映射现状开始进一步说明相关机制、操作条件与边界。
原书依据 · 1 处
第11章 Hibernate与Eclipse:Hibernate Tools使用实战
Hibernate Tools把编辑、模型浏览、查询试验和生成任务放进IDE。工具要提供可靠辅助,首先需要它自己的配置与类路径,随后才能连接数据库、识别模型并提供元数据补全。HQL编辑器允许绑定参数、限制结果并同时观察对象和SQL;生成器与映射图则从另一个方向展示同一模型。它们缩短反馈周期,却仍需检查真实约束、输出位置与工具版本,不能把界面可用当成映射已正确。
第11章 Hibernate与Eclipse:Hibernate Tools使用实战 · 连续片段1
Eclipse3.3与WTP2.0环境通过更新站点安装Hibernate Tools。缺依赖时配置Discovery Site并展开节点,再用Select Required选择所需依赖,避免把整站插件全部装入。安装后重启并确认专用编辑器可用。
插件安装先满足依赖闭包进一步说明相关机制、操作条件与边界。
第11章 Hibernate与Eclipse:Hibernate Tools使用实战 · 连续片段2
配置编辑器支持表单与XML源视图,映射编辑器提供Hibernate属性级补全。下一步仍须创建控制台以赋予项目连接和模型上下文,编辑器补全不是数据库正确性验证。
编辑辅助与运行配置分工不同进一步说明相关机制、操作条件与边界。
创建一个Hibernate控制台配置
控制台配置选择Hibernate配置文件并单独添加JDBC驱动JAR,Ant依赖路径不会自动成为IDE控制台classpath。书中用外部MySQL避免单进程嵌入库文件的并发占用;最后把配置关联到项目。
工具进程有自己的类路径进一步说明相关机制、操作条件与边界。
更多的编辑支持
项目关联控制台后可根据数据库元数据补全表列、根据Java模型补全类与属性,F3跳到定义。实际大小写不一致会妨碍元数据匹配,不能把SQL标识符一概当成大小写无关。
元数据补全依赖真实名称匹配进一步说明相关机制、操作条件与边界。
Hibernate Console视图
HQL Editor先选择控制台配置,必要时显式创建SessionFactory;设置参数类型和值,再限制结果数量并运行。结果属性浏览与动态SQL预览帮助同时检查对象结果及生成SQL,Criteria Editor还需正确窗口焦点。
交互查询先绑定正确上下文进一步说明相关机制、操作条件与边界。
代码生成
IDE代码生成选择控制台、输出目录及Domain code导出器,Use Java5 syntax对应Ant jdk5=true。导出器特有参数通过Properties设置,Refresh维护IDE资源视图。完成后检查生成文件及工具版本,而不只看后台状态。
图形生成配置须对应可复现参数进一步说明相关机制、操作条件与边界。
映射图表
HibernateTools3.2最终版可从配置视图的映射类打开Mapping Diagram,拖动元素并跳到源代码或映射。图形视图帮助理解对象与表关系,仍需结合具体映射和生成结果。
映射图连接对象与表结构进一步说明相关机制、操作条件与边界。
第12章 Maven进阶
Maven用POM描述项目身份、依赖和构建规则,再由生命周期阶段触发插件目标。标准目录约定帮助不同插件协作,父POM共享配置,modules聚合一次构建涉及的子项目。Hibernate生成任务的挂载位置由输入依赖决定:生成Java源码应在编译之前,读取标注则要在编译以后。报告和IDE文件也能从POM派生,但实际配置、测试覆盖与发布结果仍需分别核验。
第12章 Maven进阶
Maven以POM、插件与生命周期组织构建,目录约定减少配置。主代码、测试、资源与生成物分离,target为构建输出。作者强烈主张接受默认布局,但约定可配置,不能把观点写成任意偏离必然失败。
构建约定减少重复配置进一步说明相关机制、操作条件与边界。
原书依据 · 1 处
安装Maven
历史Maven2安装示例把发行包解压到版本目录,用稳定符号链接供环境变量和PATH引用。具体环境变量要求与版本有关,安装后应验证实际命令使用的版本及路径。
安装路径与版本选择分开管理进一步说明相关机制、操作条件与边界。
原书依据 · 1 处
项目的构建、测试以及运行 · 连续片段1
mvn test经历先前阶段并执行绑定插件:编译主类、示例绑定的hbm2ddl、编译测试和Surefire。阶段名与插件goal不同,日志可帮助辨识。数据库状态在重复执行间可能残留,clean默认清除构建物不等于清除所有外部数据。
阶段与插件目标不可混同进一步说明相关机制、操作条件与边界。
项目的构建、测试以及运行 · 连续片段2
mvn package走到打包阶段,在测试等先前阶段后执行Jar插件生成项目artifact;输出名由POM项目身份及版本决定,不应混同安装到本地仓库。
阶段与插件目标不可混同进一步说明相关机制、操作条件与边界。
使用Maven生成IDE项目文件
从POM生成IDE配置减少依赖信息多份维护。历史eclipse:eclipse生成.project/.classpath后还要配置M2_REPO,idea:idea生成当时IDE文件;现代集成方式不能由旧命令推断。
项目依赖应有统一描述来源进一步说明相关机制、操作条件与边界。
原书依据 · 1 处
用Maven生成报告
mvn site根据POM与报告插件生成项目网站,JavaDoc、Surefire和JXR分别提供API、测试结果与交叉引用源码。报告只覆盖已执行和已配置的内容,单个测试通过不证明总体质量。
报告呈现证据而不替代验证进一步说明相关机制、操作条件与边界。
原书依据 · 1 处
Maven项目对象模型 · 连续片段1
POM声明坐标、打包、依赖、构建插件和报告插件。示例将hbm2ddl绑定process-classes,并配置Java5编译;build extensions使驱动及日志进入插件可见环境。文字称配置了不删除数据库,但展示XML没有相应参数,不能无证据推断。
构建插件与项目依赖分开配置进一步说明相关机制、操作条件与边界。
Maven项目对象模型 · 连续片段2
子POM通过parent坐标继承共享配置,覆盖自身artifactId并追加标注依赖;顶层POM的modules聚合章节项目。继承和聚合虽在本例并用,职责不同,不应视为子目录即自动继承。
项目继承与模块聚合分工不同进一步说明相关机制、操作条件与边界。
Maven项目对象模型 · 连续片段3
共享POM定制src资源及源码位置、Hibernate插件参数,子项目继承后可覆盖映射入口;exec:java通过mainClass启动示例。此处父POM确有drop=false,不能倒推前面独立POM也展示了相同配置。
插件参数必须落实到生效配置进一步说明相关机制、操作条件与边界。
Maven构建的生命周期
生命周期按阶段顺序执行绑定目标,生成源码需纳入编译根,标注模式生成安排在编译后。package、install、deploy分别形成归档、本地可解析制品和远端发布;网站部署还属独立生命周期,原文将其一并归入deploy过宽。
任务顺序由所需输入决定进一步说明相关机制、操作条件与边界。
打包安装发布是不同结果进一步说明相关机制、操作条件与边界。
使用Maven Hibernate3插件 · 连续片段1
Hibernate3插件不同goal用于配置、模式、映射文档或Java生成;implementation选择XML、标注、JPA配置或JDBC逆向入口。参数有默认值,但文中对默认入口描述受环境影响,宜显式配置并核对日志。hbm2doc命令文本前缀与日志存在hibernate/hibernate3不一致。
生成目标与映射来源分别选择进一步说明相关机制、操作条件与边界。
使用Maven Hibernate3插件 · 连续片段2
hbm2doc输出可从实体或表两个入口浏览同一映射,辅助交叉核对。脚注提供插件配置参数与组件入口文档,不新增实现机制。
生成目标与映射来源分别选择进一步说明相关机制、操作条件与边界。
超越Maven
本章结语强调采用声明式构建前需让团队理解其约定与定制成本,并预告Spring。作者对团队拒绝技术的评价属观点,不作为普遍经验事实或新增知识卡。
第13章 Spring入门:Hibernate与Spring
Spring把对象装配和基础设施管理集中起来。业务入口依赖DAO接口,DAO实现调用Hibernate,容器为它们提供同一持久化环境;事务拦截再为一个工作单元安排提交、回滚及会话使用。这样业务代码可以减少资源处理样板,但这不是责任消失,而是责任转交。调用时必须经过正确的受管对象和配置路径,出了问题仍要追踪底层SQL、映射及驱动行为。
第13章 Spring入门:Hibernate与Spring
Spring IoC将对象创建和依赖装配移交容器,DAO可以被命令行或Web入口复用。本章准备Spring2.5依赖、DAO、事务入口与XML上下文,不把作者当时对Java平台和生态的评价作为当前事实。
依赖装配可从业务对象移出进一步说明相关机制、操作条件与边界。
编写数据访问对象 · 连续片段1
DAO将持久化操作集中到接口,业务调用方可复用同一接口而切换存储实现。ArtistDAO声明保存、删除、按名检索和可选创建,返回值围绕持久化业务结果,不负责调用方流程控制。
DAO模式的核心价值进一步说明相关机制、操作条件与边界。
编写数据访问对象 · 连续片段2
Spring2.5 HibernateTemplate封装常用操作并把HibernateException转成DataAccessException,回调可执行模板未直接暴露的Session操作。merge返回应接住,新返回实例与传入对象不可混为一谈。原文误将Spring异常翻译称为Stripes能力,笔记纠正归属。
合并状态要使用返回对象进一步说明相关机制、操作条件与边界。
模板统一资源与异常处理进一步说明相关机制、操作条件与边界。
编写数据访问对象 · 连续片段3
模板支持命名查询、样例查询、按身份加载、保存及更新;回调把直接Session操作纳入模板异常边界。示例拼接HQL缺少空格及别名,不能照录。load未必立即读取所有字段,merge也不只是按id切换方法。
模板调用仍须核对查询契约进一步说明相关机制、操作条件与边界。
创建应用程序上下文对象 · 连续片段1
ApplicationContext用逻辑bean名连接测试组件、DAO、SessionFactory和事务管理器,注解类列表与连接参数在容器中集中。default-lazy-init针对bean实例化,不等于Hibernate关联延迟加载。
容器延迟与关联延迟分开理解进一步说明相关机制、操作条件与边界。
创建应用程序上下文对象 · 连续片段2
annotation-driven配合事务管理器启用Transactional,Required后处理器验证必需setter是否配置。Hibernate连接与事务属性具有演示环境前提,pool_size0的动机是让HSQLDB连接关闭触发shutdown,不作为生产配置推荐。
配置验证与事务启用各有入口进一步说明相关机制、操作条件与边界。
把所有组件装配在一起 · 连续片段1
Test.run作为通过容器获取的事务入口,HibernateTransactionManager将Session绑定当前线程,使模板DAO参与同一工作单元,延迟集合在边界内可加载。标注本身不独立执行管理逻辑;原文所有异常都回滚的描述过宽,需按回滚规则判断。
声明式事务绑定会话生命周期进一步说明相关机制、操作条件与边界。
把所有组件装配在一起 · 连续片段2
入口对象只依赖DAO,通过bean属性注入;AlbumTest保存后接住返回对象,再添加Track和AlbumTrack,最后保存完整专辑。调用方去掉模板事务代码,是责任转交容器而非事务不再存在。
DAO模式的核心价值进一步说明相关机制、操作条件与边界。
合并状态要使用返回对象进一步说明相关机制、操作条件与边界。
把所有组件装配在一起 · 连续片段3
TestRunner加载类路径中的应用上下文,按命令参数取得Test bean并调用run;Ant目标改为传入bean名。事务入口应使用容器返回对象而不是自行new实现。
通过容器对象进入受管流程进一步说明相关机制、操作条件与边界。
把所有组件装配在一起 · 连续片段4
Spring减少事务和资源样板,但出现映射、flush、驱动问题仍需追踪底层原因。最后的可复用组件与其他框架集成属进一步方向,不把生态评价作当前选型结论。
简化框架会掩盖诊断线索进一步说明相关机制、操作条件与边界。
第14章 画龙点睛:用Stripes集成Spring和Hibernate
最后一章把命令行示例搬进Web请求。Tomcat加载部署资源,Stripes分派事件并把请求参数绑定到ActionBean,Spring提供DAO,Hibernate保存对象。部分表单只表达局部修改,却可能被错误地当作完整实体状态合并,造成未提交的评论集合丢失。作者在绑定前加载原对象来解决该案例;这一修复依赖生命周期顺序,也仍需补齐输入、权限及并发等约束,不能把一个演示拦截器当成通用更新协议。
第14章 画龙点睛:用Stripes集成Spring和Hibernate
Stripes由DispatcherServlet路由请求到ActionBean事件,Filter补充请求处理,ActionBean通过属性接收绑定并返回Resolution,JSP展示结果。框架约定减少配置,不消除各组件职责与生命周期。
请求路由与业务动作分层进一步说明相关机制、操作条件与边界。
准备Tomcat
示例要求已有Tomcat及管理部署身份,在tomcat-users.xml配置后重启。该段只提供旧版角色及演示账号,不把它们复制为真实环境默认配置。
部署前先验证管理入口进一步说明相关机制、操作条件与边界。
创建Web应用程序 · 连续片段1
先建立Servlet2.4 web.xml和最小index.jsp,再以context docBase指向开发目录,reloadable用于开发期重载。Ant部署所需依赖和任务定义与应用运行依赖要分别识别。
先验证最小可部署路径进一步说明相关机制、操作条件与边界。
创建Web应用程序 · 连续片段2
Ant deploy传入管理URL、身份、上下文路径及context文件,OK只证明Tomcat接受请求。随后访问上下文根看到Hello World,才验证最小视图链路,此时尚未接入Stripes或Hibernate。
先验证最小可部署路径进一步说明相关机制、操作条件与边界。
增加Stripes · 连续片段1
运行入口改为Tomcat后,类进入WEB-INF/classes,依赖进入WEB-INF/lib,上下文配置复制到WEB-INF。用构建过滤替换数据库绝对路径,避免容器工作目录不同导致打开错误数据库;web.xml再接入Spring、会话过滤器和Stripes。
运行入口变化须重查资源位置进一步说明相关机制、操作条件与边界。
增加Stripes · 连续片段2
web.xml令ContextLoaderListener初始化Spring,OpenSessionInViewFilter包围请求,StripesFilter覆盖action和jsp,Dispatcher处理action。JSP标签把ActionBean属性与表单字段连接,submit名称选择事件;useActionBean支持直接访问JSP时准备模型。
视图准备与提交事件分开理解进一步说明相关机制、操作条件与边界。
增加Stripes · 连续片段3
ActionBean的list、edit、save返回转发或重定向Resolution,默认事件与请求选择事件须分别识别。绑定生成的album对象可能只有id;编辑流程应重新读取持久化对象。DAO接口需补充list/get供Web入口使用。
绑定对象不等于完整持久化对象进一步说明相关机制、操作条件与边界。
增加Stripes · 连续片段4
SpringBean通过非标准setter名注入DAO以免落入普通Web属性绑定,DAO增加loadAll与按id加载。persist显式flush只同步SQL,不能等同事务提交。文字误写Session.loadAll及list/edit,应以展示的模板调用及list/get接口为准。
注入依赖应避开外部参数绑定进一步说明相关机制、操作条件与边界。
刷新数据库不等于提交事务进一步说明相关机制、操作条件与边界。
处理关联 · 连续片段1
直接合并表单绑定的部分对象可能清空未提交的关联,评论丢失即为实例。作者在BindingAndValidation前装入原对象,再让绑定修改指定属性。LoadBean标注只保存元数据,真正行为由拦截器实现。
部分更新不能冒充完整状态进一步说明相关机制、操作条件与边界。
标注元数据需要执行者解释进一步说明相关机制、操作条件与边界。
处理关联 · 连续片段2
LoadObjectInterceptor在绑定验证前读取事件方法标注,用属性名拼接.id取请求身份,按类型加载对象并放回ActionBean,再proceed。示例以引用不等比较字符串、假定Integer身份且缺失查无结果处理,通用性有限。
拦截预加载须发生在绑定之前进一步说明相关机制、操作条件与边界。
处理关联 · 连续片段3
web.xml按SpringInterceptor、LoadObjectInterceptor、BeforeAfterMethodInterceptor注册,另定义HibernateTemplate供注入。重新编译后重现先加评论再改标题的流程,验证评论保留;同时应检查失败路径,不把幕后扩展视为无边界安全方案。
拦截预加载须发生在绑定之前进一步说明相关机制、操作条件与边界。
附录A Hibernate类型
类型附录先区分具有独立身份的实体与随其保存的值,再按类别列出内建和自定义映射。表格同时包含可用于配置的映射名称和内部实现类型,不能把每一行都直接写成property的type。实际SQL容量与表示还由方言决定;字符串、任意精度数字、序列化后备表示和大对象各有不同取舍。四张图表均已逐张查看,作为定位候选类型的索引,而不是当前版本完整兼容列表。
附录A Hibernate类型
附录从持久化身份区分实体和值:实体保存删除明确发生,值随所属实体状态保存,不独立版本化。相同Java类的持久化身份取决于映射设计,不由类名决定。
实体与组件的区别进一步说明相关机制、操作条件与边界。
基本值类型
基本类型覆盖数字布尔、字符串、时间、精确数字、本地化值、Class、二进制、序列化及LOB,实际SQL类型由方言选择。原文对BigInteger到BIGINT等映射不能取代目标方言精度核验,LOB加载也受具体映射驱动影响。
类型映射须检查容量与访问语义进一步说明相关机制、操作条件与边界。
原书依据 · 1 处
自定义值类型
自定义类型补充重复映射复用思路,枚举适配可参数化。附录接口包名是旧写法,正文第6章给出的org.hibernate.usertype才与本书示例一致。
自定义类型隔离存储转换进一步说明相关机制、操作条件与边界。
“任意”类型映射
any映射以类型判别加标识指向不同实体,单一普通外键难以约束这些异构目标。原文把类型字段称作表名是简化,实际判别取值由映射定义,不必直接保存物理表名。
异构引用会削弱外键约束进一步说明相关机制、操作条件与边界。
原书依据 · 1 处
所有类型
已逐张查看四幅类型表,表内还含抽象类型、集合、实体引用、判别器与版本类型,并非每一行都能直接填写为属性type。按用途和映射入口查找,再核对方言列型;例如表中Long的SQL列写LONG不能无条件推广。
类型总表不全是可用配置名进一步说明相关机制、操作条件与边界。
原书依据 · 1 处
附录B Criteria API
Criteria附录把第8章的表达方式整理成四组工厂:Restrictions决定条件,Projections决定结果字段及聚合,Order决定排序,Property以属性为起点建立这些表达。表格中标量比较、属性间比较、空值和集合约束具有不同操作数要求;计数和去重也要明确针对行还是值。九张图表均已逐张读取,正文以下按操作问题解释其用途。
附录B Criteria API
附录B以Session创建根Criteria,再通过工厂附加条件、投影和排序,为前述API提供速查。后续各表分别记录,不重复建立导言卡。
Criterion工厂
已查看四张Restrictions表,覆盖标量比较、属性间比较、集合成员与大小、空值、布尔组合、大小写匹配及SQL限制。sqlRestriction通过alias占位引用真实表别名,带值重载还须提供匹配Type。
条件速查先分操作数类别进一步说明相关机制、操作条件与边界。
原书依据 · 1 处
Projection工厂
已查看Projections整表,涵盖property/id、projectionList、groupProperty、count与countDistinct、rowCount、max/min/avg/sum、alias以及SQL投影。计数对象、分组与去重位置是不同选择。
计数与去重必须说明对象进一步说明相关机制、操作条件与边界。
原书依据 · 1 处
Order工厂
已查看Order表,仅asc和desc两个静态入口,ignoreCase为实例方法;排序按对象属性配置,补入前述分页与排序卡。
分页窗口依赖确定排序进一步说明相关机制、操作条件与边界。
Property工厂
已查看三张Property表,涵盖比较、集合约束、排序聚合及子属性导航;count返回的投影可再设distinct,SimpleExpression可设ignoreCase。此表未覆盖全部离线查询接口。
属性工厂改变表达起点进一步说明相关机制、操作条件与边界。
附录C Hibernate SQL方言
SQL方言负责把映射和查询翻译成目标数据库支持的形式。附录的两张表按数据库系列、部分版本和引擎列出当时的实现类,用来说明方言并非单纯品牌标签。使用native或sequence主键策略、类型及锁行为时,这一选择尤其需要核对。实际配置须匹配所用Hibernate版本和真实数据库,历史列表不承担当前支持矩阵的作用。
附录C Hibernate SQL方言
已查看两张SQL方言表,覆盖数据库系列、版本及MySQL存储引擎分支;方言影响主键生成、锁及SQL类型。类名列表限于本书版本,选择应匹配实际数据库与框架版本。
方言选择须匹配版本与能力进一步说明相关机制、操作条件与边界。
附录D Spring事务支持
事务附录把边界组合、并发可见性和失败处理拆开:传播决定加入还是建立事务,隔离决定并发下可观察到什么,回滚规则决定哪些异常应撤销工作,超时和只读又是独立属性。标注只保存这些声明,需要受支持的代理或织入方式解释执行。三张表已读取;原文关于非public入口及SERIALIZABLE的简化不直接采纳,按对应版本机制说明限制。
附录D Spring事务支持
已读三张表:事务属性含隔离、传播、只读、回滚规则与超时;传播区分加入、独立、挂起和嵌套;隔离语义取决于数据库。原文非public标注建议与后文检查public矛盾,SERIALIZABLE等同物理排队及普遍不现实的评价也须纠正。
事务隔离级别的现实取舍进一步说明相关机制、操作条件与边界。
声明式事务标注的放置陷阱进一步说明相关机制、操作条件与边界。
事务传播不同于隔离强度进一步说明相关机制、操作条件与边界。
使用JTA事务管理器
跨JDBC与JMS等资源的事务可评估JTA管理器,示例仅展示替换transactionManager bean并引用它。管理器类名不是已经配好分布式事务的证据,参与资源及环境支持仍需具备。
事务管理器须匹配参与资源进一步说明相关机制、操作条件与边界。
原书依据 · 1 处
附录E 参考资源
资源附录为不同深度的问题提供入口:手册回答具体API与配置,深入图书补充背景,源码和测试帮助判定真实行为,发行说明与勘误解释版本变化。参考资源的提名只表示进一步阅读方向,不等于已替读者证明其全部内容。本轮保留书中完整工具版本组合,并为两项源码深读实际核验固定提交及入口,完整实践另行记录。
附录E 参考资源
资源附录引导按学习风格和任务选择渠道;具体手册、图书、源码和版本信息在后续项登记。
在线手册
各工具在线参考手册用于核对具体任务与接口,不用入门图书代替完整版本文档。
图书
书目按Hibernate深入、数据库实践、构建与Spring分别提供延伸阅读,全部登记为提名,不据书名展开未读内容。
源代码
给依赖库关联源码和JavaDoc后,IDE可补全文档及跳转实现。历史Maven Eclipse插件通过downloadSources和downloadJavadocs获取附属工件,需版本一致且仓库实际提供。
阅读依赖实现先固定对应版本进一步说明相关机制、操作条件与边界。
原书依据 · 1 处
处理更新版本的工具包
逐项读完工具版本清单,明确本书Ant1.7、Maven2.0.8、Hibernate3.2.5、Spring2.5、Stripes1.4.3等基线,Tools命令与Eclipse章节使用不同发行版本。升级需查变更和勘误,不承诺老例子直接适配新工具。
复现示例先锁定工具组合进一步说明相关机制、操作条件与边界。
原书依据 · 1 处
重在参与
社区章节提供各项目邮件列表、论坛、博客和贡献渠道,并特别鼓励阅读Stripes源码。历史公司关系、会议与网页链接只作当时资料,不声称当前仍有相同组织和地址。
作者与封面说明
作者简介用于核对共同作者身份,封面说明交代刺猬插画及出处。二者都已完整阅读,但不为技术学习目的拆出个人履历或动物学知识卡。它们同时帮助确认本册结束位置,避免把合集下一本的内容接到本书中。
作者简介
完整阅读James Elliott、Ryan Fowler与Tim O’Brien三位作者简介,与封面及前言署名核对一致。个人履历不转成技术知识卡。
封面介绍
完整阅读刺猬封面说明及图像来源Animate Creation,确认本册到此结束,下一spine已进入另一册。动物资料不属于本书技术取材主线,不展开未核验生物学断言。
跨章综合
全书的关键不是让数据库细节从此消失,而是把它们放到明确的责任位置:对象映射定义身份与结构,会话跟踪状态,事务约束数据库工作的结局,容器与Web框架安排调用和资源边界。一个层次提供的便利不能替另一个层次作承诺。集合能够导航,不代表双端内存引用自动同步;SQL已经刷新,不代表事务已经提交;表单已经绑定,也不代表对象带有完整、可直接覆盖数据库的状态。
沿音乐示例继续扩展时,每次模型变化都要跨对象、映射与数据库三层核对。自定义类型要求读写与复制一致,查询要求范围与返回契约一致,构建要求任务与输入就绪顺序一致。原书的具体版本便于复现,也暴露了示例日志、描述和配置并非总是完全相符;保留这些差异比抽象地宣称框架保证正确更有学习价值。
发散与实践
读者延伸:采用两项实现深读计划,分别追踪刷新如何从状态进入执行动作,以及merge如何复制实体与集合状态。它们回答不同问题,均已核验Hibernate ORM 3.6.10.Final固定提交并完成首轮源码映射,尚未执行完整深读或实验;不将该后续版本冒充原书3.2.5实现。
计划文件:ideas/idea-001-跟踪一次刷新如何生成SQL.md;ideas/idea-002-区分合并状态与部分更新.md。每项包含90分钟快速路线、机制单元、待观察证据及完成判据。