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：是否唯一约束

例如：

Java调试

通过 JDWP 实现 Java 远程调试：连接远程 JVM、设置断点、单步执行代码、查看变量值、获取调用栈。适用于需要调试远程 Java 应用、排查运行时状态、追踪代码执行流程的场景。 术语注解 JDWP：Java Debug Wire Protocol，Java 调试有线协议（Java 远程调试底层通信协议） remote JVM：远程 Java 虚拟机 step through code：代码单步调试（步入 / 步过 / 步出调试） inspect variables：变量查看 / 变量检视 stac

下载

4. 关联关系映射

真实业务中，对象之间存在多种关联，hbm.xml 支持以下几种关键映射方式。

一对一（）

• 常用于主键关联或外键关联
• 属性 property-ref 可指定引用的属性

一对多 / 多对一（, + ）

• 定义“多”端持有外键
• 包裹 表示“一”端的集合
• 常用 cascade 属性实现级联操作（如 save-update, delete）

多对多（ + ）

• 通过中间表建立关系
• 使用 或 table 指定中间表

5. 其他重要配置元素

除了基本映射，hbm.xml 还支持更复杂的配置选项。

• ：嵌入式对象映射（如 Address 嵌入 User）
• ：动态 Map 映射，适合灵活字段
• 和 ：继承映射（单表、连接表、每类一表）
• 和 ：预定义 HQL 或原生 SQL

这些高级特性使得 hbm.xml 在复杂场景下依然具备强大表达能力。

基本上就这些。虽然现代开发更倾向使用注解简化配置，但 hbm.xml 提供了完全解耦的映射方式，适合需要集中管理或动态加载映射的系统。掌握其结构和语义，能帮助你更好地理解 Hibernate 的运行逻辑，也便于在特定场景下做出合理技术选择。