Java 中注解怎么实现实体类字段与数据库列映射-java教程-PHP中文网

核心是通过自定义@column注解+反射机制，在运行时读取字段的列名、主键、空值等元数据，动态生成sql或驱动orm操作，支持脱离字段名限制的灵活映射。

java 中注解怎么实现实体类字段与数据库列映射

Java 中注解实现字段与数据库列映射，核心是通过自定义注解 + 反射机制，在运行时读取注解信息，将实体类字段名、类型、约束等转换为 SQL 列定义或 ORM 操作依据。主流框架（如 MyBatis、JPA/Hibernate）已封装好这套逻辑，但理解底层原理有助于调试和扩展。

一、定义列映射注解

用 @Retention(RetentionPolicy.RUNTIME) 和 @Target(ElementType.FIELD) 声明一个可被反射读取的字段级注解：

@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.FIELD)
public @interface Column {
    String value() default "";           // 列名，如 "user_name"
    boolean primaryKey() default false;  // 是否主键
    boolean nullable() default true;     // 是否允许 NULL
    String type() default "";            // 数据库类型，如 "VARCHAR(50)"
}

二、在实体类中使用注解

直接标注在字段上，显式声明映射关系：

public class User {
    @Column(value = "id", primaryKey = true)
    private Long id;

    @Column(value = "user_name", nullable = false, type = "VARCHAR(100)")
    private String name;

    @Column("email")
    private String email;
}

这样就脱离了“字段名必须等于列名”的限制，支持驼峰转下划线、别名映射等常见需求。

deep-java-review

Java项目代码review工具。分析Git变更+完整调用链路上下文，推断业务需求，进行多维度评分和分类汇总，生成完整PRD文档。包含细粒度Java代码审查清单（Null安全、异常处理、Streams、并发、equals/hashCode、资源管理、API设计、性能、MyBatis/ORM、事务边界、SQL/DD...

下载

三、用反射解析注解生成建表语句

编写工具方法，遍历字段，提取 @Column 信息并拼接 SQL：

获取类所有字段：clazz.getDeclaredFields()
对每个字段调用 field.getAnnotation(Column.class)
根据注解属性拼接列定义，例如：id BIGINT PRIMARY KEY 或 user_name VARCHAR(100) NOT NULL
跳过无注解字段（或按约定默认映射），避免遗漏或误映射

四、配合 ORM 框架使用更高效

不建议从零手写完整 ORM，而是复用成熟方案：

JPA：用 @Column(name = "xxx")、@Id、@GeneratedValue 等标准注解，Hibernate 自动完成映射与 SQL 生成
MyBatis Plus：支持 @TableId、@TableName、@TableField，配合全局策略（如开启驼峰转下划线）自动识别
若需扩展，可实现 MetaObjectHandler（MP）或 AttributeConverter（JPA），在注解基础上增强逻辑