hbm.xml 是 Hibernate 早期用于 ORM 映射的 XML 文件，定义类与表、属性与字段、主键策略及关联关系；结构以 为根，含 、、 等元素，需在配置中注册加载。
hbm.xml 是 Hibernate 早期版本中用于定义对象关系映射（ORM）的 XML 配置文件，虽然现在主流用注解（@Entity、@Id 等）或 JPA 标准方式，但老项目、遗留系统或特定场景下仍需维护或编写 hbm.xml 文件。它的核心作用是告诉 Hibernate：Java 类怎么对应数据库表，属性怎么映射字段，主键怎么生成，关联关系如何处理。
基础结构：一个最简 hbm.xml 文件长什么样
每个 hbm.xml 文件通常对应一个实体类，以 User.hbm.xml 示例：
说明：
– package 属性可省略，但设上后，name="User" 就不用写全限定名；
– native、increment、uuid、assigned）；
– type 更安全（如 integer、timestamp、text）。
常用映射细节：字段类型、空值、长度与唯一性
实际开发中，光靠 name 和 column 不够，还需控制数据库行为和 Java 层约束：
-
指定 SQL 类型和长度：用
type（Hibernate 类型）+length+not-null，例如： -
映射时间字段：推荐用
type="timestamp"（对应 java.util.Date 或 LocalDateTime，需配合方言支持）；
若只存日期，可用type="date"；只存时间用type="time"。 -
大文本字段（如 CLOB）：写
type="text"，Hibernate 会自动映射为String并适配数据库的长文本类型（如 MySQL 的 TEXT、Oracle 的 CLOB）。 -
布尔值映射：用
type="boolean"，底层按TINYINT(1)或CHAR(1)存（取决于方言），也可用type="yes_no"或type="true_false"控制存储值。
配置关联关系：一对多、多对一怎么写
关联是 hbm.xml 的重点也是难点。以“用户（User）→ 订单（Order）”的一对多为例：
在 User.hbm.xml 中声明集合：
在 Order.hbm.xml 中声明外键引用：
关键点：
– cascade 控制级联操作（如 save-update 表示保存 User 时自动保存其 orders）；
– inverse="true" 表示“这一端不负责维护关联”，即由 many-to-one 端（Order）来更新外键，避免重复 SQL；
– many-to-one 的 column 一致；
– 如果 Order 类里没有 user 属性，就只能单向映射（仅在 User 里配
注册与加载：让 Hibernate 找到你的 hbm.xml
光写好文件还不够，得让 SessionFactory 加载它。常见方式有两种：
-
在 hibernate.cfg.xml 中逐个声明：
-
使用 Spring 配置（如 applicationContext.xml）：
com/example/model/User.hbm.xml
com/example/model/Order.hbm.xml
注意路径要和 classpath 下的实际位置一致（一般放在 src/main/resources 对应包路径下），且文件名建议与类名一致，避免混淆。
基本上就这些。hbm.xml 不复杂但容易忽略细节——比如 generator 写错导致 ID 为空、inverse 设反引发外键更新失败、type 类型不匹配造成查询异常。写完建议配合日志（show_sql=true）看生成的 SQL 是否符合预期，再结合单元测试验证增删改查逻辑。
