不知道你有没有过这种经历:一个后台管理系统,实体类十几个,每个实体都要写一套增删改查。刚开始还能耐着性子复制粘贴改改表名和字段,写多了真想摔键盘。我见过太多项目里 UserDao、OrderDao、ProductDao 里面的代码长得几乎一模一样,区别只有 SQL 语句里的表名和占位符参数不一样。其实这个场景非常适合用 JDBC 封装一个通用的 BaseDao 数据库访问层,把重复的 CRUD 逻辑收敛到一个父类里,子类只负责提供实体类型,剩下的增删改查、批量操作、分页查询全部复用。这篇文章就把我实际项目中沉淀下来的一套 BaseDao 封装思路完整分享出来,代码可以直接拷贝到自己项目里改改用,同时也会把我在封装过程中踩过的坑逐个讲清楚。
1. 为什么我劝你先别急着上框架,而是自己动手封装一个BaseDao
1.1 原始JDBC开发的核心痛点
咱们先回到最原始的 JDBC 写法,你大概率写过类似的代码:
java复制public User findById(Long id) {
Connection conn = null;
PreparedStatement ps = null;
ResultSet rs = null;
User user = null;
try {
Class.forName("com.mysql.cj.jdbc.Driver");
conn = DriverManager.getConnection(URL, USERNAME, PASSWORD);
String sql = "SELECT id, username, password, nickname, email, create_time FROM user WHERE id = ?";
ps = conn.prepareStatement(sql);
ps.setLong(1, id);
rs = ps.executeQuery();
if (rs.next()) {
user = new User();
user.setId(rs.getLong("id"));
user.setUsername(rs.getString("username"));
user.setPassword(rs.getString("password"));
user.setNickname(rs.getString("nickname"));
user.setEmail(rs.getString("email"));
user.setCreateTime(rs.getTimestamp("create_time"));
}
} catch (Exception e) {
e.printStackTrace();
} finally {
if (rs != null) {
try { rs.close(); } catch (SQLException e) { e.printStackTrace(); }
}
if (ps != null) {
try { ps.close(); } catch (SQLException e) { e.printStackTrace(); }
}
if (conn != null) {
try { conn.close(); } catch (SQLException e) { e.printStackTrace(); }
}
}
return user;
}
这段代码的问题很明显:第一,Connection、PreparedStatement、ResultSet 三件套的获取和关闭代码是重复的,每写一个方法就要复制一遍;第二,从 ResultSet 往实体对象里塞值的过程完全是体力活,字段少还好,字段一多,行数直接爆炸;第三,整个方法被 try-catch-finally 包得严严实实,实际业务逻辑只有那四五行,剩下全是模板代码。
一个实体写 7 个方法,10 个实体就是 70 个方法,而且绝大多数方法结构完全一样。这时候你就意识到,该做一次通用封装了。这也是 MyBatis、Hibernate 这类框架存在的意义——把 JDBC 的样板代码收敛掉。但在我们还没有引入重量级框架,或者项目里就是想保持轻量 JDBC 操作的时候,自己写一个 BaseDao 就是性价比最高的选择。
提示:BaseDao 的核心价值不是替代 MyBatis,而是在不引入复杂框架的前提下,把 Java 操作数据库的重复劳动降到最低。它特别适合小项目、工具类项目、临时脚本,以及想彻底搞清楚 ORM 底层原理的学习场景。
1.2 BaseDao要解决什么问题,不解决什么问题
动手写代码之前,先把边界划清楚。
BaseDao 要解决的,是那些统一规则之下的操作——单表 CRUD、根据主键查询、条件查询、批量插入、分页查询。这类操作占日常开发的大头,而且逻辑高度一致,非常适合抽象。它不解决的,是多表关联查询、复杂子查询、动态条件组合特别多的场景。你说一个 SQL 要 join 五张表,这种查询强行让框架去套壳,写出来的东西反而比手写 SQL 还难受,还不如直接在子类里加一个独立方法,保留原生 SQL 能力。
我的建议是:BaseDao 负责 80% 的通用 CRUD,剩下那 20% 的复杂查询,子类直接声明方法,在方法里手写 SQL,把 BaseDao 暴露出来的 getConnection() 方法直接用起来就行。这样既享受了封装带来的便利,又不会被封装限制住。
所以整个封装的设计原则其实是两条:
- 通用能力全部收敛到父类,子类尽量保持干净;
- 特殊需求不硬套,保留直接拿到连接操作 SQL 的口子。
带着这两条原则往下走,接下来看看核心的泛型和反射部分。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 泛型与反射:让BaseDao自己知道在操作哪张表
2.1 泛型如何拿到真实的实体类型
BaseDao<T> 是一个泛型抽象类,子类继承它的时候会写明具体实体类型,比如:
java复制public class UserDao extends BaseDao<User> {
}
问题来了:父类在运行时怎么知道 T 到底是什么?因为 Java 泛型在编译后会被擦除,你不能直接 T.class,所以需要通过反射去解析父类的泛型签名,代码长这样:
java复制@SuppressWarnings("unchecked")
protected BaseDao() {
Type superclass = getClass().getGenericSuperclass();
if (superclass instanceof ParameterizedType) {
ParameterizedType type = (ParameterizedType) superclass;
this.entityClass = (Class<T>) type.getActualTypeArguments()[0];
} else {
throw new RuntimeException("BaseDao必须指定泛型类型");
}
}
这里的逻辑是:UserDao 继承 BaseDao<User> 的时候,Java 会把 User 这个类型以 ParameterizedType 的形式记录在类元数据里,子类实例化时在构造方法里通过 getGenericSuperclass() 就能把这个信息解析出来。拿到 entityClass 之后,后面所有的反射操作都有据可依了。
有一个细节需要注意:如果我们的层级是 UserDao extends BaseDao<User>,这段代码直接运行没问题。但如果你中间多加了一层,比如 BaseDao<User> extends AbstractDao,那 getGenericSuperclass() 拿到的泛型信息就变成 BaseDao<User> 传给 AbstractDao 的签名,仍然可以解析。真正会出问题的是那种绕了几层、泛型信息丢失的情况,所以封装的时候最好在构造方法里加一层校验,解析不到就快速失败。
