17370845950

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" 就不用写全限定名；
– 定义主键， 指定 ID 生成策略（如 native、increment、uuid、assigned）；
– 映射普通属性，默认类型由 Hibernate 推断，显式写 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 是否符合预期，再结合单元测试验证增删改查逻辑。