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 文件通常对应一个实体类与数据库表的映射关系。其根元素是 <hibernate-mapping></hibernate-mapping>，内部包含一个 <class></class> 元素定义具体的映射规则。
- name：指定实体类的全限定名
- table：指定对应的数据库表名
- catalog 和 schema：可选，用于指定数据库的 catalog 或 schema
2. 主键映射（ 元素）
主键是持久化对象的唯一标识，<id></id> 元素用于定义主键字段的映射。
- name：Java 类中的属性名
- column：对应数据库列名（可省略，默认为属性名）
- type：数据类型，可以是 Hibernate 类型（如 string、long、integer）或 Java 类型全名
- unsaved-value：判断对象是否为新实例的依据（较少手动设置）
主键生成策略由 <generator></generator> 子元素指定，常见值包括：
- native：根据数据库自动选择 identity、sequence 或 hilo
- identity：自增（如 MySQL）
- sequence：序列（如 Oracle）
- assigned：由程序手动赋值
- uuid：生成 UUID 字符串
3. 普通属性映射（）
<property></property> 用于映射非主键的普通字段。
java-api-doc-generator
下载
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
- name：Java 属性名，需有 getter/setter
- column：数据库列名
- type：类型映射，支持基本类型、日期、枚举等
- not-null：是否非空（生成 DDL 时有效）
- length：字符串字段长度限制
- unique：是否唯一约束
例如：
4. 关联关系映射
真实业务中，对象之间存在多种关联，hbm.xml 支持以下几种关键映射方式。
一对一（- 常用于主键关联或外键关联
- 属性
property-ref可指定引用的属性
-
<many-to-one></many-to-one>定义“多”端持有外键 -
<set></set>包裹<one-to-many></one-to-many>表示“一”端的集合 - 常用
cascade属性实现级联操作（如 save-update, delete）
- 通过中间表建立关系
- 使用
<join></join>或table指定中间表
5. 其他重要配置元素
除了基本映射，hbm.xml 还支持更复杂的配置选项。
-
：嵌入式对象映射（如 Address 嵌入 User） -
：动态 Map 映射，适合灵活字段 -
和 ：继承映射（单表、连接表、每类一表） -
和 ：预定义 HQL 或原生 SQL
这些高级特性使得 hbm.xml 在复杂场景下依然具备强大表达能力。
基本上就这些。虽然现代开发更倾向使用注解简化配置，但 hbm.xml 提供了完全解耦的映射方式，适合需要集中管理或动态加载映射的系统。掌握其结构和语义，能帮助你更好地理解 Hibernate 的运行逻辑，也便于在特定场景下做出合理技术选择。
