异常教程

JSP 连接数据库（手把手讲解）

更新时间:

💡一则或许对你有用的小广告

欢迎加入小哈的星球 ，你将获得：专属的项目实战 / 1v1 提问 / Java 学习路线 / 学习打卡 / 每月赠书 / 社群讨论

  • 新项目:《从零手撸：仿小红书（微服务架构）》 正在持续爆肝中，基于 Spring Cloud Alibaba + Spring Boot 3.x + JDK 17...，点击查看项目介绍 ;
  • 《从零手撸：前后端分离博客项目（全栈开发）》 2 期已完结，演示链接： http://116.62.199.48/ ;

截止目前， 星球 内专栏累计输出 82w+ 字，讲解图 3441+ 张，还在持续爆肝中.. 后续还会上新更多项目，目标是将 Java 领域典型的项目都整一波，如秒杀系统, 在线商城, IM 即时通讯，权限管理，Spring Cloud Alibaba 微服务等等，已有 2900+ 小伙伴加入学习 ，欢迎点击围观

前言：为什么需要学习 JSP 连接数据库？

在 Web 开发领域，JSP（JavaServer Pages）是一种广泛应用于动态网页开发的技术。它允许开发者在 HTML 页面中嵌入 Java 代码，实现数据动态渲染。而数据库作为数据存储的核心，与 JSP 的结合是构建完整 Web 应用的关键。无论是用户登录验证、商品信息展示，还是订单数据的持久化存储，都离不开 JSP 与数据库的高效通信。

本文将从零开始，系统讲解如何通过 JSP 连接数据库。内容覆盖技术原理、代码实现、优化技巧以及常见问题，适合编程初学者和中级开发者逐步掌握这一技能。

一、JSP 的基本概念与工作原理

1.1 JSP 的核心特性

JSP 是一种基于 Java 的服务器端技术，其核心特性包括：

  • 动态内容生成：通过嵌入的 Java 代码实时生成页面内容。
  • 组件复用：支持使用 JavaBean 和自定义标签实现代码复用。
  • 无缝集成：与 Java Servlet、JavaBeans 等技术协同工作，构建完整的 MVC 架构。

1.2 JSP 的执行流程

JSP 文件的执行过程可以简化为以下步骤：

  1. 编译阶段：服务器将 JSP 文件转换为 Servlet 代码。
  2. 编译 Servlet：将生成的 Java 代码编译为字节码。
  3. 执行阶段：Servlet 处理请求并生成响应内容。

比喻：这类似于快递公司的分拣流程，JSP 文件就像待分拣的包裹，经过“拆包（编译）”和“分类（生成 Servlet）”后，最终由工作人员（Servlet）完成配送。

二、数据库基础知识与连接逻辑

2.1 数据库的核心概念

数据库管理系统（DBMS）是存储和管理数据的软件，常见的有 MySQL、Oracle、PostgreSQL 等。其核心功能包括：

  • 数据存储：将数据以结构化形式保存。
  • 查询优化：通过 SQL 语言快速检索数据。
  • 事务管理：确保数据操作的原子性和一致性。

2.2 JSP 连接数据库的核心步骤

连接数据库的过程可以类比为快递员从仓库取货的过程：

  1. 加载驱动（Driver）：如同快递员确认仓库地址。
  2. 建立连接（Connection）：如同进入仓库并获取权限。
  3. 执行 SQL 语句（Statement/PreparedStatement）：如同在仓库中查找或存放包裹。
  4. 处理结果（ResultSet）：如同清点包裹并装车。
  5. 关闭资源（Close）：如同离开仓库并锁门。

三、实战：JSP 连接数据库的完整流程

3.1 环境准备与依赖配置

3.1.1 开发环境要求

  • Java JDK：版本 8 或更高。
  • Web 服务器：Tomcat 9 或更高版本。
  • 数据库：MySQL 8.0（需下载驱动 jar 包）。

3.1.2 配置数据库驱动

将 MySQL 的 JDBC 驱动包 mysql-connector-java-8.0.x.jar 复制到 Tomcat 的 lib 目录中，或通过 Maven 依赖管理：

<dependency>
    <groupId>mysql</groupId>
    <artifactId>mysql-connector-java</artifactId>
    <version>8.0.29</version>
</dependency>

3.2 编写 JSP 代码实现数据库连接

3.2.1 第一步：加载数据库驱动

<%@ page import="java.sql.*" %>
<%
    // 加载 MySQL 驱动类
    Class.forName("com.mysql.cj.jdbc.Driver");
%>

关键点：Class.forName() 会触发静态代码块，初始化驱动类对象，相当于“唤醒数据库服务”。

3.2.2 第二步：建立数据库连接

// 配置数据库连接参数
String url = "jdbc:mysql://localhost:3306/mydb?useSSL=false";
String user = "root";
String password = "your_password";

// 建立连接
Connection conn = DriverManager.getConnection(url, user, password);

参数解释：

  • url：数据库地址，包含协议（jdbc:mysql）、主机名（localhost）、端口（3306）、数据库名（mydb）及可选参数（如 useSSL=false）。
  • user 和 password：数据库账号凭证。

3.2.3 第三步：执行 SQL 查询

// 创建 Statement 对象
Statement stmt = conn.createStatement();

// 执行查询
String sql = "SELECT * FROM users";
ResultSet rs = stmt.executeQuery(sql);

3.2.4 第四步：处理查询结果

// 遍历结果集
while (rs.next()) {
    out.println("ID: " + rs.getInt("id"));
    out.println("Name: " + rs.getString("name"));
    out.println("---------------------");
}

3.2.5 第五步：关闭资源

// 关闭资源，防止内存泄漏
rs.close();
stmt.close();
conn.close();

3.3 完整代码示例：查询用户列表

<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>
<%@ page import="java.sql.*" %>
<html>
<head><title>JSP 连接数据库示例</title></head>
<body>
    <h1>用户列表</h1>
    <%
        try {
            // 加载驱动
            Class.forName("com.mysql.cj.jdbc.Driver");
            
            // 连接数据库
            String url = "jdbc:mysql://localhost:3306/mydb?useSSL=false";
            String user = "root";
            String password = "your_password";
            Connection conn = DriverManager.getConnection(url, user, password);

            // 执行查询
            Statement stmt = conn.createStatement();
            String sql = "SELECT * FROM users";
            ResultSet rs = stmt.executeQuery(sql);

            // 输出结果
            while (rs.next()) {
                out.println("<p>ID: " + rs.getInt("id") + "</p>");
                out.println("<p>Name: " + rs.getString("name") + "</p>");
                out.println("<hr>");
            }

            // 关闭资源
            rs.close();
            stmt.close();
            conn.close();
        } catch (Exception e) {
            out.println("错误：" + e.getMessage());
        }
    %>
</body>
</html>

四、优化与高级技巧

4.1 使用 PreparedStatement 防止 SQL 注入

// 预编译 SQL 语句
String sql = "INSERT INTO users (name, email) VALUES (?, ?)";
PreparedStatement pstmt = conn.prepareStatement(sql);

// 设置参数
pstmt.setString(1, "张三");
pstmt.setString(2, "zhangsan@example.com");

// 执行操作
int rowsAffected = pstmt.executeUpdate();

4.2 连接池技术提升性能

通过连接池（如 HikariCP）复用数据库连接，避免频繁创建和销毁连接：

// 配置连接池（在 web.xml 中）
<Resource name="jdbc/mydb" auth="Container"
    type="javax.sql.DataSource"
    factory="org.apache.tomcat.jdbc.pool.DataSourceFactory"
    driverClassName="com.mysql.cj.jdbc.Driver"
    url="jdbc:mysql://localhost:3306/mydb"
    username="root" password="your_password"
    maxTotal="10" maxIdle="5"/>

4.3 事务管理确保数据一致性

// 开启事务
conn.setAutoCommit(false);

try {
    // 执行多个 SQL 操作
    stmt.executeUpdate("UPDATE accounts SET balance = balance - 100 WHERE id = 1");
    stmt.executeUpdate("UPDATE accounts SET balance = balance + 100 WHERE id = 2");
    
    // 提交事务
    conn.commit();
} catch (SQLException e) {
    // 回滚事务
    conn.rollback();
} finally {
    conn.setAutoCommit(true);
}

五、常见问题与解决方案

5.1 常见错误及排查方法

错误类型现象描述解决方案
ClassNotFound报错 java.lang.ClassNotFoundException: com.mysql.cj.jdbc.Driver检查驱动 jar 包是否正确放置，或确认依赖配置
Connection Refused提示 Communications link failure验证数据库地址、端口、账号密码是否正确
SQL Syntax Error出现 You have an error in your SQL syntax检查 SQL 语句的语法，如引号、关键字拼写

5.2 性能优化建议

  • 减少全表扫描：使用索引加速查询。
  • 避免 N+1 查询：通过 JOIN 合并多次查询。
  • 关闭未使用的资源：确保在 finally 块中关闭 Connection、Statement 等对象。

六、总结与展望

通过本文的讲解，读者应已掌握 JSP 连接数据库的核心步骤、代码实现及优化方法。从基础的 JDBC 操作到高级的事务管理和连接池应用，这些知识为构建稳定、高效的 Web 应用奠定了基础。

未来，随着 Java EE 和 Spring 框架的演进，开发者可以进一步探索 Spring JDBC、Hibernate 等 ORM 框架，实现更高层次的数据库操作自动化。但无论技术如何发展，理解 JSP 连接数据库的基本原理始终是 Web 开发的基石。

希望本文能帮助读者在实践中快速上手这一技术，并为后续的复杂项目打下坚实基础！

最新发布

查看更多文章