hbm.xml是Hibernate中Java实体类与数据库表映射的核心配置文件,根元素为,内含定义类与表的对应关系;用于主键映射,支持native、identity、sequence等生成策略;映射普通字段,可设置类型、长度、非空等约束;关联关系通过、、和实现,支持级联操作;还可使用映射嵌入对象,处理继承,预定义HQL或SQL。尽管注解更流行,hbm.xml在集中管理配置和维护旧项目时仍具价值。

在使用 Hibernate 作为 ORM 框架时,hbm.xml 映射文件是连接 Java 实体类与数据库表的核心桥梁。尽管如今注解方式(如 @Entity、@Table)更为流行,理解 hbm.xml 的结构和作用仍有助于深入掌握 Hibernate 的底层机制,尤其在维护旧项目或需要集中管理映射配置时尤为重要。
1. hbm.xml 文件的基本结构
每个 hbm.xml 文件通常对应一个实体类与数据库表的映射关系。其根元素是 ,内部包含一个 元素定义具体的映射规则。
- name:指定实体类的全限定名
- table:指定对应的数据库表名
- catalog 和 schema:可选,用于指定数据库的 catalog 或 schema
2. 主键映射( 元素)
主键是持久化对象的唯一标识, 元素用于定义主键字段的映射。
- name:Java 类中的属性名
- column:对应数据库列名(可省略,默认为属性名)
- type:数据类型,可以是 Hibernate 类型(如 string、long、integer)或 Java 类型全名
- unsaved-value:判断对象是否为新实例的依据(较少手动设置)
主键生成策略由 子元素指定,常见值包括:
- native:根据数据库自动选择 identity、sequence 或 hilo
- identity:自增(如 MySQL)
- sequence:序列(如 Oracle)
- assigned:由程序手动赋值
- uuid:生成 UUID 字符串
3. 普通属性映射()
用于映射非主键的普通字段。
- name:Java 属性名,需有 getter/setter
- column:数据库列名
- type:类型映射,支持基本类型、日期、枚举等
- not-null:是否非空(生成 DDL 时有效)
- length:字符串字段长度限制
- unique:是否唯一约束
例如:
本文档主要讲述的是mybatis语法和介绍;MyBatis 是一个可以自定义SQL、存储过程和高级映射的持久层框架。MyBatis 摒除了大部分的JDBC代码、手工设置参数和结果集重获。MyBatis 只使用简单的XML 和注解来配置和映射基本数据类型、Map 接口和POJO 到数据库记录。相对Hibernate和Apache OJB等“一站式”ORM解决方案而言,Mybatis 是一种“半自动化”的ORM实现。感兴趣的朋友可
4. 关联关系映射
真实业务中,对象之间存在多种关联,hbm.xml 支持以下几种关键映射方式。
一对一(- 常用于主键关联或外键关联
- 属性
property-ref可指定引用的属性
-
定义“多”端持有外键 -
包裹表示“一”端的集合 - 常用
cascade属性实现级联操作(如 save-update, delete)
- 通过中间表建立关系
- 使用
或table指定中间表
5. 其他重要配置元素
除了基本映射,hbm.xml 还支持更复杂的配置选项。
-
:嵌入式对象映射(如 Address 嵌入 User) -
:动态 Map 映射,适合灵活字段 -
和 :继承映射(单表、连接表、每类一表) -
和 :预定义 HQL 或原生 SQL
这些高级特性使得 hbm.xml 在复杂场景下依然具备强大表达能力。
基本上就这些。虽然现代开发更倾向使用注解简化配置,但 hbm.xml 提供了完全解耦的映射方式,适合需要集中管理或动态加载映射的系统。掌握其结构和语义,能帮助你更好地理解 Hibernate 的运行逻辑,也便于在特定场景下做出合理技术选择。









