三、spring boot开发web应用-使用传统的JDBC
上一节《spring boot第一个web服务》中我们只是简单的展示了spring mvc的功能，并没有涉及到具体的CRUD的操作，也没有涉及到数据持久化的方面。本节中我们将基于传统的JDBC方式讲解web应用中的CRUD操作，具体内容以用户的注册、登录、详情查询、列表查询为场景来展开（注：文章中的例子只为演示spring boot功能而设计，不能做为生产版本，针对生产版本还需做很多思考和优化工作）。
1.表结构
/*==============================================================*/ /* Table: t_user 用户表 */ /*==============================================================*/
create table t_user ( id bigint not null auto_increment comment 'id:主键', name varchar(20) not null comment '姓名', password varchar(20) not null comment '密码', primary key (id) );
2.构建实体类
为了提高代码的可读性，我们这里用到了Lombok,它能自动生成getter、setter、toString()等常见方法。使用它时，需引入依赖
<!--lombok--> <dependency> <groupId>org.projectlombok</groupId> <artifactId>lombok</artifactId> <optional>true</optional> </dependency>
然后使用注解@Data来进行使用
用户实体类User
package com.kinglead.demo.entity; import lombok.AllArgsConstructor; import lombok.Data; import lombok.NoArgsConstructor; import java.io.Serializable; @Data //添加getter、setter方法 @NoArgsConstructor //无参构造函数 @AllArgsConstructor //所以参数构造函数 public class User implements Serializable { private static final long serialVersionUID = -21070736985722463L; /** * id:主键 */ private Long id; /** * 姓名 */ private String name; /** * 密码 */ private String password; }
3.请求Request类
为了方便简单的对表单进行校验，我们引入Validation API依赖，使用相关注解声明校验规则，如@NotNull、@Size等，注解直接加到类的成员变量上即可。
<!--validation表单校验--> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-validation</artifactId> </dependency>
UserVo
package com.kinglead.demo.vo; import lombok.Data; import javax.validation.constraints.NotNull; import javax.validation.constraints.Size; import java.io.Serializable; @Data public class UserVo implements Serializable { private static final long serialVersionUID = -21070736985722463L; /** * 用户名 */ @NotNull(message = "用户名不能为空") @Size(max = 20, message = "用户名长度不能大于20") private String userName; /** * 密码 */ @NotNull(message = "密码不能为空") @Size(max = 20, message = "密码长度不能大于20") private String password; }
4.控制器Controller
用户UserController
package com.kinglead.demo.controller; import com.kinglead.demo.entity.User; import com.kinglead.demo.service.UserService; import com.kinglead.demo.vo.UserVo; import lombok.extern.slf4j.Slf4j; import org.springframework.stereotype.Controller; import org.springframework.validation.BindingResult; import org.springframework.web.bind.annotation.GetMapping; import org.springframework.web.bind.annotation.PostMapping; import org.springframework.web.bind.annotation.RequestMapping; import org.springframework.web.servlet.ModelAndView; import javax.annotation.Resource; import javax.validation.Valid; import java.util.List; import java.util.Map; @Slf4j @Controller @RequestMapping("/user") public class UserController { /**注入UserService**/ @Resource private UserService userService; /** *注册页面 */ @GetMapping("/register") public ModelAndView register(ModelAndView modelAndView){ modelAndView.setViewName("register"); return modelAndView; } /** *注册 */ @PostMapping("/register") public ModelAndView register(ModelAndView modelAndView, @Valid UserVo userVo, BindingResult bindingResult){ //校验参数 if(bindingResult.hasErrors()){ modelAndView.addObject("error",bindingResult.getFieldError().getDefaultMessage()); modelAndView.setViewName("register"); return modelAndView; } //注册 User user = new User(); user.setName(userVo.getUserName()); user.setPassword(userVo.getPassword()); userService.insert(user); //注册成功返回到登录页面 modelAndView.setViewName("login"); return modelAndView; } /** *登录页面 */ @GetMapping("/login") public ModelAndView login(ModelAndView modelAndView){ modelAndView.setViewName("login"); return modelAndView; } /** *登录 */ @PostMapping("/login") public ModelAndView login(ModelAndView modelAndView,@Valid UserVo userVo, BindingResult bindingResult){ //效验入参 if(bindingResult.hasErrors()){ modelAndView.addObject("error",bindingResult.getFieldError().getDefaultMessage()); modelAndView.setViewName("login"); return modelAndView; } //效验用户 User user = new User(); user.setName(userVo.getUserName()); user.setPassword(userVo.getPassword()); User rstUser = userService.queryByNameAndPassword(user); if(null == rstUser){ modelAndView.addObject("error","用户名或密码错误！"); modelAndView.setViewName("login"); } //展示首页 modelAndView.addObject("userName",rstUser.getName()); modelAndView.setViewName("index"); return modelAndView; } /** * 查询用户列表 */ @GetMapping("/userList") public ModelAndView queryAll(ModelAndView modelAndView){ //查询用户列表 List<Map<String, Object>> userList = userService.queryAll(); //返回 modelAndView.addObject("userList", userList); modelAndView.setViewName("userList"); return modelAndView; } }
5.服务接口Service及实现类
UserService
package com.kinglead.demo.service; import com.kinglead.demo.entity.User; import java.util.List; import java.util.Map; public interface UserService { /** * 新增用户 */ User insert(User user); /** * 通过用户名和密码查询用户 */ User queryByNameAndPassword(User user); /** * 查询用户列表 */ List<Map<String, Object>> queryAll(); }
UserServiceImpl
package com.kinglead.demo.service.impl; import com.kinglead.demo.entity.User; import com.kinglead.demo.service.UserService; import org.springframework.jdbc.core.JdbcTemplate; import org.springframework.stereotype.Service; import javax.annotation.Resource; import java.sql.ResultSet; import java.sql.SQLException; import java.util.List; import java.util.Map; @Service public class UserServiceImpl implements UserService { @Resource private JdbcTemplate jdbcTemplate; /** * 新增用户 */ @Override public User insert(User user) { jdbcTemplate.update("insert into t_user(name,password) values(?,?)", user.getName(), user.getPassword()); return user; } /** * 通过用户名和密码查询用户 */ @Override public User queryByNameAndPassword(User user) { return jdbcTemplate.queryForObject("select id, name, password from t_user where name = ? and password = ?", this::mapRowToUser, user.getName(), user.getPassword()); } /** * 查询用户列表 */ @Override public List<Map<String, Object>> queryAll() { return jdbcTemplate.queryForList("select id, name, password from t_user"); } private User mapRowToUser(ResultSet rs, int rowNum) throws SQLException { return new User(rs.getLong("id"), rs.getString("name"), rs.getString("password")); } }
6.用户注册功能详解
从第4点UserController，我们可以看到用于注册的请求有：展示注册页面@GetMapping("/register")和完成注册@PostMapping("/register")，下面我们看看具体的html页面、service实现和JDBC的操作。
register.html
<!DOCTYPE html> <html xmlns:th="http://www.thymeleaf.org"> <head> <meta http-equiv="Content-Type" content="text/html;charset=UTF-8" /> <title>注册</title> </head> <body> <form th:action="@{/user/register}" method="post"> <div> <h2>帐号注册</h2> </div> <div> <!--/*@thymesVar id="error" type=""*/--> <span id="basic-addon0"> </span> <span style="font-size: 12px;color: red" th:text="${error}" aria-describedby="basic-addon0"></span> <br /> </div> <div> <span id="basic-addon1">用户名</span> <input id="user_name" name="name" type="text" placeholder="用户名" aria-describedby="basic-addon1" /> </div> <br /> <div> <span id="basic-addon2">密 码</span> <input id="password" name="password" type="password" placeholder="密 码" aria-describedby="basic-addon2" /> </div> <br /> <div> <button type="submit" style="width:190px;">注 册</button> </div> </form> </body> </html>
注册页面完成后，我们通过浏览器访问：http://localhost:8080/user/register，URL地址映射到@GetMapping("/register")方法
/** *注册页面 */ @GetMapping("/register") public ModelAndView register(ModelAndView modelAndView){ modelAndView.setViewName("register"); return modelAndView; }
返回register.html页面，浏览器展示用户注册页面
在注册页面填写用户名和密码后，点击“注册”按钮。
由于register.html中，from的method=“POST”，所以“注册”按钮会映射到@PostMapping("/register")方法
/** *注册 */ @PostMapping("/register") public ModelAndView register(ModelAndView modelAndView, @Valid UserVo userVo, BindingResult bindingResult){ //校验参数 if(bindingResult.hasErrors()){ modelAndView.addObject("error",bindingResult.getFieldError().getDefaultMessage()); modelAndView.setViewName("register"); return modelAndView; } //注册 User user = new User(); user.setName(userVo.getUserName()); user.setPassword(userVo.getPassword()); userService.insert(user); //注册成功返回到登录页面 modelAndView.setViewName("login"); return modelAndView; }
通过@Valid注解打开了表单校验，所以如果有参数不符合开始声明的校验规则，会参数错误Errors。如果有参数错误，会返回注册页面，并显示错误。如果没有错误，将会调用UserService的insert方法
/** * 新增用户 */ @Override public User insert(User user) { jdbcTemplate.update("insert into t_user(name,password) values(?,?)", user.getName(), user.getPassword()); return user; }
这里就用到了spring封装的JdbcTemplate。要正常使用JDBC和访问数据库还需要做两件事：
1、引入JDBC依赖和mysql连接驱动依赖（这里使用最常用的mysql数据库）
<!--JDBC--> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-jdbc</artifactId> </dependency> <!--mysql驱动--> <dependency> <groupId>mysql</groupId> <artifactId>mysql-connector-java</artifactId> </dependency>
2、配置数据库连接
application.yml
spring:
datasource:
username: root
password: 123456
url: jdbc:mysql://127.0.0.1:3306/spring_boot_topic
driver-class-name: com.mysql.cj.jdbc.Driver
通过jdbcTemplate的update方法即可插入数据。
7.用户登录功能详解
从第4点UserController，我们可以看到用于注册的请求有：展示登录页面@GetMapping("/login")和完成登录@PostMapping("/login")，下面我们看看具体的html页面、service实现和JDBC的操作。
login.html
<!DOCTYPE html> <html xmlns:th="http://www.thymeleaf.org"> <head> <meta http-equiv="Content-Type" content="text/html;charset=UTF-8" /> <title>登录</title> <!--<link rel="stylesheet" type="text/css" href="/css/common.css" />--> </head> <body> <div> <h2>用户登录</h2> </div> <form th:action="@{/user/login}" method="post"> <div> <!--/*@thymesVar id="error" type=""*/--> <span id="basic-addon0"> </span> <span style="font-size: 12px;color: red" th:text="${error}" aria-describedby="basic-addon0"></span> <br /> </div> <div> <span id="basic-addon1">用户名</span> <input id="user_name" name="userName" type="text" placeholder="用户名" aria-describedby="basic-addon1" th:field="*{userName}"/> </div> <br /> <div> <span id="basic-addon2">密 码</span> <input id="password" name="password" type="password" placeholder="密 码" aria-describedby="basic-addon2" th:field="*{password}"/> </div> <br /> <div> <button type="submit" style="width:95px;">登 录</button> <a href="/user/register">注册</a> </div> </form> </body> </html>
我们通过浏览器访问：http://localhost:8080/user/login，进入到登录页面,URL地址映射到@GetMapping("/login")方法
/** *登录页面 */ @GetMapping("/login") public ModelAndView login(ModelAndView modelAndView){ modelAndView.setViewName("login"); return modelAndView; }
返回login.html页面，浏览器展示用户登录页面
在登录页面填写用户名和密码后，点击“登录”按钮。
由于login.html中，from的method=“POST”，所以“注册”按钮会映射到@PostMapping("/login")方法
/**
*登录
*/
@PostMapping("/login")
public ModelAndView login(ModelAndView modelAndView,@Valid UserVo userVo, BindingResult bindingResult){
//效验入参
if(bindingResult.hasErrors()){
modelAndView.addObject("error",bindingResult.getFieldError().getDefaultMessage());
modelAndView.setViewName("login");
return modelAndView;
}
//效验用户
User user = new User();
user.setName(userVo.getUserName());
user.setPassword(userVo.getPassword());
User rstUser = userService.queryByNameAndPassword(user);
if(null == rstUser){
modelAndView.addObject("error","用户名或密码错误！");
modelAndView.setViewName("login");
}
//展示首页
modelAndView.addObject("userName",rstUser.getName());
modelAndView.setViewName("redirect:/user/index");
return modelAndView;
}
通过@Valid注解打开了表单校验，所以如果有参数不符合开始声明的校验规则，会参数错误Errors。如果有参数错误，会返回登录页面，并显示错误。如果没有错误，将会调用UserService的queryByNameAndPassword方法
/** * 通过用户名和密码查询用户 */ @Override public User queryByNameAndPassword(User user) { return jdbcTemplate.queryForObject("select id, name, password from t_user where name = ? and password = ?", this::mapRowToUser, user.getName(), user.getPassword()); } private User mapRowToUser(ResultSet rs, int rowNum) throws SQLException { return new User(rs.getLong("id"), rs.getString("name"), rs.getString("password")); }
通过jdbcTemplate的queryForObject方法即可查询到数据，然后重定向redirect到首页index.html。
/** *首页 */ @GetMapping("/index") public ModelAndView index(ModelAndView modelAndView, HttpServletRequest request){ modelAndView.addObject("userName",request.getParameter("userName")); modelAndView.setViewName("index"); return modelAndView; }
inde.html
<!DOCTYPE html> <html xmlns:th="http://www.thymeleaf.org"> <head> <meta http-equiv="Content-Type" content="text/html;charset=UTF-8" /> <title>登录</title> <!--<link rel="stylesheet" type="text/css" href="/css/common.css" />--> </head> <body> <div> <br /> <span>欢迎你</span> <span style="font-size: 12px;color: black" th:text="${userName}" aria-describedby="basic-addon0"></span> </div> </body> </html>
登录成功界面
8.用户列表查询功能详解
从第4点UserController，我们可以看到用于用户列表查询的请求有：@GetMapping("/userList")，下面我们看看具体的html页面、service实现和JDBC的操作。
userList.html
<!DOCTYPE html> <html xmlns:th="http://www.thymeleaf.org"> <head> <meta http-equiv="Content-Type" content="text/html;charset=UTF-8" /> <title>用户信息</title> <!--<link rel="stylesheet" type="text/css" href="/css/common.css" />--> <style type="text/css"> table { border: 1px solid black; text-align: center; border-collapse: collapse; } table thead th { border: 1px solid black; } table tbody td { border: 1px solid black; } </style> </head> <body> <div> <h2>用户列表</h2> </div> <table cellpadding="0" cellspacing="0"> <thead> <th>序号</th> <th>编码</th> <th>用户名</th> </thead> <tbody> <tr th:each="entries,stat:${userList}" th:style="' color: rgb(17, 119, 0);">> <td th:text="${stat.count}"></td> <td th:text="${entries['id']}"></td> <td th:text="${entries['name']}"></td> <td th:text="${entries['sage']}"></td> </tr> </tbody> </table> </body> </html>
我们通过浏览器访问：http://localhost:8080/user/userList，进入到登录页面,URL地址映射到@GetMapping("/userList")方法
/** * 查询用户列表 */ @GetMapping("/userList") public ModelAndView queryAll(ModelAndView modelAndView){ //查询用户列表 List<Map<String, Object>> userList = userService.queryAll(); //返回 modelAndView.addObject("userList", userList); modelAndView.setViewName("userList"); return modelAndView; }
调用UserService的queryAll方法
/** * 查询用户列表 */ @Override public List<Map<String, Object>> queryAll() { return jdbcTemplate.queryForList("select id, name, password from t_user"); }
通过jdbcTemplate的queryForList方法即可查询到数据，然后返回到userList.html页面上。
总结
Spring对JDBC的支持主要是使用JdbcTemplate，虽然JdbcTemplate将创建连接、创建语句、关闭连接、关闭结果集和sql异常处理等做了很好的封装，但是还有待完善。下一节我们再聊聊更简单的JPA。
源码地址：https://github.com/kinglead2012/myblog
create table t_user( id bigint not null auto_increment comment 'id:主键', name varchar(20) not null comment '姓名', password varchar(20) not null comment '密码', primary key (id));
