Hibernate hbm.xml文件怎么配置 Hibernate映射文件编写教程

hbm.xml 是 Hibernate 早期用于 ORM 映射的 XML 文件，定义类与表、属性与字段、主键策略及关联关系；结构以 为根，含 、、 等元素，需在配置中注册加载。

hbm.xml 是 Hibernate 早期版本中用于定义对象关系映射（ORM）的 XML 配置文件，虽然现在主流用注解（@Entity、@Id 等）或 JPA 标准方式，但老项目、遗留系统或特定场景下仍需维护或编写 hbm.xml 文件。它的核心作用是告诉 Hibernate：Java 类怎么对应数据库表，属性怎么映射字段，主键怎么生成，关联关系如何处理。

基础结构：一个最简 hbm.xml 文件长什么样

每个 hbm.xml 文件通常对应一个实体类，以 <hibernate-mapping></hibernate-mapping> 为根元素。下面是一个典型的 User.hbm.xml 示例：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE hibernate-mapping PUBLIC
    "-//Hibernate/Hibernate Mapping DTD 3.0//EN"
    "http://www.hibernate.org/dtd/hibernate-mapping-3.0.dtd">

<hibernate-mapping package="com.example.model">
    <class name="User" table="t_user">
        <id name="id" column="id">
            <generator class="native"/>
        </id>
        <property name="username" column="username" type="string"/>
        <property name="email" column="email" type="string"/>
    </class>
</hibernate-mapping>

说明：
– package 属性可省略，但设上后，name="User" 就不用写全限定名；
– <id></id> 定义主键，<generator></generator> 指定 ID 生成策略（如 native、increment、uuid、assigned）；
– <property></property> 映射普通属性，默认类型由 Hibernate 推断，显式写 type 更安全（如 integer、timestamp、text）。

常用映射细节：字段类型、空值、长度与唯一性

实际开发中，光靠 name 和 column 不够，还需控制数据库行为和 Java 层约束：

• 指定 SQL 类型和长度：用 type（Hibernate 类型）+ length + not-null，例如：
  <property name="phone" column="phone" type="string" length="15" not-null="true"></property>
• 映射时间字段：推荐用 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 中声明集合：

必剪Studio

Bilibili发布的免费AI数字分身定制和视频创作工具

183

查看详情

<set name="orders" cascade="save-update" inverse="true">
    <key column="user_id"/>
    <one-to-many class="Order"/>
</set>

在 Order.hbm.xml 中声明外键引用：

<many-to-one name="user" class="User" column="user_id" not-null="true"/>

关键点：
– cascade 控制级联操作（如 save-update 表示保存 User 时自动保存其 orders）；
– inverse="true" 表示“这一端不负责维护关联”，即由 many-to-one 端（Order）来更新外键，避免重复 SQL；
– <key></key> 指定外键列名，必须和 many-to-one 的 column 一致；
– 如果 Order 类里没有 user 属性，就只能单向映射（仅在 User 里配 <set></set>），但不推荐，易出错。

注册与加载：让 Hibernate 找到你的 hbm.xml

光写好文件还不够，得让 SessionFactory 加载它。常见方式有两种：

• 在 hibernate.cfg.xml 中逐个声明：
  <mapping resource="com/example/model/User.hbm.xml"></mapping>
<mapping resource="com/example/model/Order.hbm.xml"></mapping>
• 使用 Spring 配置（如 applicationContext.xml）：
  

  <property name="mappingResources"><br>
      <list><br>
        <value>com/example/model/User.hbm.xml</value><br>
        <value>com/example/model/Order.hbm.xml</value><br>
      </list><br>
    </property>

  登录后复制

注意路径要和 classpath 下的实际位置一致（一般放在 src/main/resources 对应包路径下），且文件名建议与类名一致，避免混淆。

基本上就这些。hbm.xml 不复杂但容易忽略细节——比如 generator 写错导致 ID 为空、inverse 设反引发外键更新失败、type 类型不匹配造成查询异常。写完建议配合日志（show_sql=true）看生成的 SQL 是否符合预期，再结合单元测试验证增删改查逻辑。

以上就是Hibernate hbm.xml文件怎么配置 Hibernate映射文件编写教程的详细内容，更多请关注php中文网其它相关文章！