数据库对象实例化流程模板 + 常见错误

目录一. 数据库建表二. 创建实体类2.1 字段类型与数据库类型对应关系2.2 常用注解2.3 示例三. 创建 Mapper 接口四. 创建 Mapper XML 映射文件五. 配置application.yml六. 编写测试用例在Java项目中操作数据库要先将数据库对象实例化其流程通常为数据库建表——创建实体类PO/DO——创建 Mapper 接口——创建 Mapper XML 映射文件——配置application.yml——编写测试用例一. 数据库建表这点没什么好说的根据业务需求设计并创建数据库表明确字段类型、主键、索引等约束。二. 创建实体类实体类POPersistent Object / DOData Object是数据库表在 Java 代码中的映射一个表对应一个实体类数据库字段对应实体类中的属性表中的一行数据对应实体类的一个对象。有两个注意的点一个是字段类型与数据库类型对应一个是常用的注解。2.1 字段类型与数据库类型对应关系以下是字段类型与数据库类型对应关系的表格常用的都在这里但还是要根据业务规则有所调整数据库类型MySQLJava 类型推荐说明BIGINTLong范围大-922 亿922 亿适合主键、大数值INTInteger范围适中-21 亿21 亿适合普通数值TINYINTByte或Integer-Byte节省内存范围 -128~127适合状态码0/1/2-Integer兼容性更好无需考虑范围VARCHAR(n)String字符串适合名称、描述、ID 等文本TEXT/LONGTEXTString长文本适合大段内容DATETIME/TIMESTAMPLocalDateTime- 线程安全、API 简洁、无时区问题- 替代旧版Date线程不安全、API 繁琐DATELocalDate仅日期年月日TIMELocalDate仅时间时分秒DECIMAL(m,n)BigDecimal高精度数值适合金额、价格避免Double/Float精度丢失BIT(1)/BOOLEANBoolean布尔值true/false注意事项金额字段绝对不用Double/Float必须用BigDecimal否则会出现0.1 0.2 0.30000000000000004的精度问题主键用Long即使数据库是INT也建议用 Long避免后续数据量超过INT范围-21 亿21 亿字段可空性数据库字段允许NULL时Java 类型用包装类如Integer、Long不用基本类型如int、long因为基本类型不能存NULL2.2 常用注解1. Lombok 注解必用简化代码Lombok 可以自动生成 getter/setter/toString/ 构造方法等无需手动写。注解作用示例Data自动生成getter、setter、toString、equals、hashCode直接加在类上NoArgsConstructor自动生成无参构造方法必须加MyBatis/Spring 实例化对象时需要AllArgsConstructor自动生成全参构造方法可选方便创建对象时赋值Builder支持链式调用创建对象可选代码更优雅2. ORM 映射注解根据框架选择如果是Spring Data JPA框架则需要加以下注解注解作用示例Entity标识这是一个 JPA 实体类加在类上Table(name 表名)指定实体类对应的数据库表名Table(name group_buy_activity)Id标识主键字段加在主键字段上GeneratedValue(strategy GenerationType.IDENTITY)主键自增策略对应数据库AUTO_INCREMENT加在Id下方Column(name 数据库字段名)显式指定字段映射可选默认自动下划线转驼峰Column(name activity_id)如果用的是MyBatis实体类不需要 ORM 注解只需通过 XML 里的resultMap映射字段即可2.3 示例package cn.qimingxing.infrastructure.dao.po; import lombok.AllArgsConstructor; import lombok.Builder; import lombok.Data; import lombok.NoArgsConstructor; import java.time.LocalDateTime; /** * 拼团活动实体类对应数据库表group_buy_activity */ Data // 自动生成 getter/setter/toString/equals/hashCode Builder // 支持链式调用创建对象 AllArgsConstructor // 自动生成全参构造方法 NoArgsConstructor // 自动生成无参构造方法必须加 public class GroupBuyActivity { /** 自增ID对应数据库id */ private Long id; /** 活动ID对应数据库activity_id */ private Long activityId; /** 来源对应数据库source */ private String source; /** 渠道对应数据库channel */ private String channel; /** 商品ID对应数据库goods_id */ private String goodsId; /** 折扣ID对应数据库discount_id */ private String discountId; /** 拼团方式0自动成团、1达成目标拼团对应数据库group_type */ private Integer groupType; /** 拼团次数限制对应数据库take_limit_count */ private Integer takeLimitCount; /** 拼团目标对应数据库target */ private Integer target; /** 拼团时长分钟对应数据库valid_time */ private Integer validTime; /** 活动状态0创建、1生效、2过期、3废弃对应数据库status */ private Integer status; /** 活动开始时间对应数据库start_time */ private LocalDateTime startTime; // 推荐用 LocalDateTime替代 Date /** 活动结束时间对应数据库end_time */ private LocalDateTime endTime; /** 人群标签规则标识对应数据库tag_id */ private String tagId; /** 人群标签规则范围对应数据库tag_scope */ private String tagScope; /** 创建时间对应数据库create_time */ private LocalDateTime createTime; /** 更新时间对应数据库update_time */ private LocalDateTime updateTime; }// 用 Builder 链式调用创建对象代码更优雅 GroupBuyActivity activity GroupBuyActivity.builder() .activityId(1001L) .source(APP) .channel(WECHAT) .goodsId(G001) .discountId(D001) .groupType(0) .takeLimitCount(1) .target(3) .validTime(15) .status(1) .startTime(LocalDateTime.now()) .endTime(LocalDateTime.now().plusDays(7)) .build();三.创建 Mapper 接口这一步主要是定义操作数据库的方法注意方法的返回值一般需要用到上一步定义的实体类要注意两点添加Mapper注解让 Spring 扫描并注册为 Bean若接口不在启动类子包下需在启动类添加MapperScan(包路径)四.创建 Mapper XML 映射文件这里有标准模板?xml version1.0 encodingUTF-8? !DOCTYPE mapper PUBLIC -//mybatis.org//DTD Mapper 3.0//EN http://mybatis.org/dtd/mybatis-3-mapper.dtd !-- 1. namespace必须是 Dao 接口的全类名点分隔不带 .java -- mapper namespacecn.qimingxing.infrastructure.dao.IGroupBuyActivityDao !-- 2. 结果映射数据库字段 - 实体类字段 -- resultMap idBaseResultMap typecn.qimingxing.infrastructure.dao.po.GroupBuyActivity !-- 主键字段 -- id columnid propertyid/ !-- 普通字段 -- result columnactivity_id propertyactivityId/ result columnsource propertysource/ result columnchannel propertychannel/ result columngoods_id propertygoodsId/ result columncreate_time propertycreateTime/ /resultMap !-- 4. 查询语句 -- select idqueryGroupBuyActivityList resultMapBaseResultMap select * from 表名 /select /mappermapper namespacecn.qimingxing.infrastructure.dao.IGroupBuyActivityDaonamespace 绑定 Dao 接口MyBatis 根据这个路径找到对应的接口。注意必须是 Dao 接口的全类名必须用. 分隔不能用 /不能带 .java 后缀resultMap idBaseResultMap typecn.qimingxing.infrastructure.dao.po.GroupBuyActivity id columnid propertyid/ result columnactivity_id propertyactivityId/ /resultMap作用把数据库下划线字段自动映射成Java 驼峰字段属性解释id给这个映射规则起个名字随便起但要唯一type对应的实体类全类名必须正确不能带 .java内部标签id主键字段result普通字段两个关键属性columnxxx→数据库字段名propertyxxx→实体类字段名!-- 4. 查询语句 -- select idqueryGroupBuyActivityList resultMapBaseResultMap select * from 表名 /select✔ 属性解释id必须和 Dao 接口方法名完全一样resultMap使用上面定义的映射规则resultType直接写实体类二选一不要同时写五.配置application.yml通用模板# # 1. Spring Boot 基础配置 # spring: # 应用名称随便起方便识别 application: name: your-application-name # # 2. 数据库连接配置核心必须改占位符 # datasource: # 数据库 URL格式 jdbc:mysql://IP:端口/数据库名?参数 url: jdbc:mysql://localhost:3306/your_database_name?useUnicodetruecharacterEncodingutf8autoReconnecttrueuseSSLfalseserverTimezoneAsia/Shanghai # 数据库账号替换为你的账号 username: your_database_username # 数据库密码替换为你的密码 password: your_database_password # MySQL 8 驱动固定写法不用改MySQL 5.x 用 com.mysql.jdbc.Driver driver-class-name: com.mysql.cj.jdbc.Driver # # 3. HikariCP 连接池配置Spring Boot 默认优化性能通用推荐值 # hikari: # 连接池名称随便起 pool-name: HikariCP-Pool # 最小空闲连接数推荐 5-15 minimum-idle: 10 # 最大连接数推荐 10-50根据服务器配置调整 maximum-pool-size: 20 # 空闲连接存活时间毫秒默认 60000010分钟 idle-timeout: 300000 # 连接最长生命周期毫秒默认 180000030分钟 max-lifetime: 1800000 # 连接超时时间毫秒默认 3000030秒 connection-timeout: 30000 # 连接有效性检测 SQLMySQL 固定写 SELECT 1Oracle 写 SELECT 1 FROM DUAL connection-test-query: SELECT 1 # # 4. MyBatis 核心配置最关键 # mybatis: # 【必配】指定 Mapper XML 文件的位置classpath: 对应 src/main/resources 目录 mapper-locations: classpath:mapper/*.xml # 【推荐配】指定实体类所在包替换为你的实体类包路径简化 XML 中 resultType 的写法 type-aliases-package: com.example.project.po # 【推荐配】MyBatis 全局配置 configuration: # 【核心推荐】自动下划线转驼峰开启后数据库 activity_id 自动映射到实体类 activityId不用写 resultMap map-underscore-to-camel-case: true # 【调试用】打印 SQL 语句到控制台方便看 SQL 有没有执行、参数对不对生产环境可关闭 log-impl: org.apache.ibatis.logging.stdout.StdOutImpl # 开启二级缓存可选提升性能 cache-enabled: true # 开启延迟加载可选提升性能 lazy-loading-enabled: true # # 5. 服务端口配置 # server: # 服务端口默认 8080可改成任意未被占用的端口 port: 8080 # # 6. 日志配置可选方便调试 # logging: level: # 配置 Mapper 接口所在包的日志级别为 DEBUG打印更详细的 SQL 信息 com.example.project.dao: debug # 全局日志级别INFO/WARN/ERROR root: info # 日志文件路径可选生产环境建议配置 file: name: logs/your-application-name.log这一点要注意配置数据库的四个主要字段配置项含义url数据库连接地址username数据库账号password数据库密码driver-class-name数据库驱动MyBatis配置主要作用是告诉 MyBatis去哪里找 Mapper XML 文件、怎么映射字段、要不要打印 SQL。如果提前配置好XML文件地址那么这一步可以提前做。六. 编写测试用例这点没啥好说的用Resource或Autowired注入第三步编写的Mapper接口调用里面的方法进行测试即可。