hbm.xml映射文件的基础规范与文档结构
Hibernate的hbm.xml映射配置是早期版本中实现对象关系映射的核心方式，通过XML文件描述实体类和数据库表、实体属性和表字段之间的对应关系，不需要额外的注解即可完成ORM映射配置。这种配置方式在旧版Java企业级开发中应用非常广泛，开发者可以通过编写结构化的XML来描述持久化对象与关系型数据库之间的绑定规则。
一个标准的hbm.xml映射文件必须遵循Hibernate官方定义的DTD约束，这意味着在文件开头需要声明XML版本、编码格式以及对应的文档类型定义。DTD约束保证了映射文件中的元素和属性符合Hibernate解析器的预期，避免因为标签拼写或结构错误导致启动时加载失败。所有的具体映射配置都必须放置在根标签<hibernate-mapping>内部，该根标签还可以配置一些全局属性，例如是否使用默认值、自动导入等，但最基本的用法就是作为其他映射标签的容器。
在实际工程中，每一个实体类通常对应一个独立的hbm.xml文件，文件命名习惯为“实体类名.hbm.xml”，并放在与实体类相同的包路径下，便于在Hibernate主配置文件中通过resource路径引入。下面展示一个最基础的文档骨架，其中仅包含根标签与注释占位，具体类和字段的映射会在后续小节中逐步填充。
<?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>
<!-- 具体的类与表映射配置写在这里 -->
</hibernate-mapping>
需要注意的是，XML声明中的encoding通常设置为UTF-8，这样可以兼容中文注释与大部分字符集。如果项目中数据库使用特定字符集，仍需保证映射文件本身能被正确读取。此外，DTD的引用地址可以是本地或远程的，但在内网环境中建议将DTD文件本地化以避免网络依赖。
实体类、主键及普通属性的映射要点
在hbm.xml中使用<class>标签建立实体类与数据库表之间的关联。该标签的name属性填写实体类的全限定名，table属性填写对应的表名，还可以选择性地通过catalog指定数据库名或通过schema指定模式名。当实体类名与表名具有一定对应规律时，清晰配置这些属性有助于后期维护，也能让其他开发者快速理解对象与库的绑定关系。
主键的配置通过<id>标签完成，这是每一个持久化类映射中必不可少的部分。<id>标签需要指明属性名、列名和类型，并通过内嵌的<generator>标签设置主键生成策略。不同的生成策略适应不同的数据库与业务场景，例如native会根据底层数据库能力选择自增或序列，assigned要求程序手动赋值，uuid可生成字符串类型唯一标识，sequence则常用于Oracle等支持序列的数据库。
<hibernate-mapping>
<class name="com.ipipp.entity.User" table="t_user" catalog="test_db">
<!-- 主键配置，使用数据库自增策略 -->
<id name="id" column="user_id" type="java.lang.Integer">
<generator class="native"/>
</id>
<!-- 普通属性映射示例 -->
<property name="username" column="user_name" type="java.lang.String" length="50" not-null="true"/>
<property name="password" column="user_pwd" type="java.lang.String" length="32"/>
<property name="age" column="user_age" type="java.lang.Integer"/>
<property name="createTime" column="create_time" type="java.util.Date"/>
</class>
</hibernate-mapping>
对于实体中的普通字段，使用<property>标签进行描述。常用属性包括name代表Java属性名，column代表表字段名，type可以使用Java全类名或Hibernate映射类型，length用于限制字符串长度，not-null用于控制是否允许为空。合理设置not-null和length可以在映射层面对数据合法性做初步约束，虽然最终约束仍由数据库保证，但能让Hibernate在持久化前做基础校验。
在编写属性映射时，类型填写尤其关键。如果type写成Java类型，如java.lang.String，Hibernate会自动映射到对应的SQL类型；如果写Hibernate类型如string，同样可以被正确解析。建议团队内部统一风格，避免同一个文件中混用多种写法造成阅读困难。
关联关系映射与完整配置示例
除了基础字段，实体之间往往存在一对多、多对一等关联关系，hbm.xml同样提供了专门的标签来描述这些关系。以用户和订单的场景为例，用户实体中包含一个订单集合，可以使用<set>配合<key>和<one-to-many>来表达一对多关系；而订单实体中引用用户对象，则通过<many-to-one>标签配置。inverse属性的设置决定了关联关系由哪一方维护，通常在一对多中将集合端设为inverse="true"，由多的一方来维护外键，以减少多余的更新语句。
<class name="com.ipipp.entity.User" table="t_user">
<id name="id" column="user_id" type="java.lang.Integer">
<generator class="native"/>
</id>
<property name="username" column="user_name" type="java.lang.String"/>
<!-- 一对多关联，由订单方维护外键 -->
<set name="orders" table="t_order" inverse="true">
<key column="user_id"/>
<one-to-many class="com.ipipp.entity.Order"/>
</set>
</class>
在订单实体侧，多对一的配置相对直接，只需指定属性名、外键列以及关联的实体类。这样双向配置之后，Hibernate就能在加载用户时按需获取订单集合，或在加载订单时直接拿到关联的用户对象。下面给出订单实体的多对一映射片段，注意column值应与用户端<key>中的column保持一致，否则会导致关联失效。
<class name="com.ipipp.entity.Order" table="t_order">
<id name="id" column="order_id" type="java.lang.Integer">
<generator class="native"/>
</id>
<property name="orderNo" column="order_no" type="java.lang.String"/>
<!-- 多对一关联，指向用户表外键 -->
<many-to-one name="user" column="user_id" class="com.ipipp.entity.User"/>
</class>
当所有映射片段编写完成后，可以将它们组合为完整的hbm.xml文件，并在Hibernate主配置文件hibernate.cfg.xml中通过<mapping>标签引入。只有被显式引入的映射文件才会被SessionFactory加载，否则实体无法参与持久化操作。以下示例展示了一个包含常用字段的用户映射文件，以及主配置中引入该文件的方式。
<?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>
<class name="com.ipipp.entity.User" table="t_user" catalog="test_db">
<id name="id" column="user_id" type="java.lang.Integer">
<generator class="native"/>
</id>
<property name="username" column="user_name" type="java.lang.String" length="50" not-null="true"/>
<property name="password" column="user_pwd" type="java.lang.String" length="32"/>
<property name="age" column="user_age" type="java.lang.Integer"/>
<property name="email" column="user_email" type="java.lang.String" length="100"/>
<property name="createTime" column="create_time" type="java.util.Date"/>
</class>
</hibernate-mapping>
<hibernate-configuration>
<session-factory>
<!-- 其他数据库与事务配置 -->
<mapping resource="com/ipipp/entity/User.hbm.xml"/>
</session-factory>
</hibernate-configuration>
从整体来看，旧版Hibernate的hbm.xml写法虽然相较注解显得繁琐，但具备配置集中、与代码解耦的优势。在维护遗留系统时，理解<class>、<id>、<property>以及关联标签的语义，能够帮助开发者快速定位对象与表之间的绑定问题。建议在修改映射文件后，优先通过单元测试验证实体增删改查，并观察生成的SQL是否符合预期，从而确保XML配置在实际运行中发挥作用。