JWT+SpringBoot实战
往期内容:JWT - 炒焖煎糖板栗 - 博客园 (域名)
JWT可以理解为一个加密的字符串,里面由三部分组成:头部(Header)、负载(Payload)、签名(signature)
由base64加密后的header和payload使用.连接组成的字符串,然后通过header中声明的加密方式进行加盐secret组合加密,然后就构成了JWT字符串
往期介绍了JWT相关概念以及基本操作,接下来介绍如何在SpringBoot中整合JWT实现登陆注册
环境搭建
1、新建一个SpringBoot项目Jwt-Demo,引入项目后面需要用到的jar包
<dependencies>
<dependency>
<groupId>域名</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
<dependency>
<groupId>域名</groupId>
<artifactId>spring-boot-starter-test</artifactId>
<scope>test</scope>
</dependency>
<!--引入mybatis-->
<dependency>
<groupId>域名域名</groupId>
<artifactId>mybatis-spring-boot-starter</artifactId>
<version>2.1.3</version>
</dependency>
<!--引入mysql-->
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>域名</version>
</dependency>
<!--引入druid数据库连接池-->
<dependency>
<groupId>域名aba</groupId>
<artifactId>druid</artifactId>
<version>1.2.1</version>
</dependency>
<!--引入lombok-->
<dependency>
<groupId>域名ectlombok</groupId>
<artifactId>lombok</artifactId>
<version>域名</version>
</dependency>
<dependency>
<groupId>域名域名</groupId>
<artifactId>mybatis-spring-boot-starter-test</artifactId>
<version>2.1.3</version>
</dependency>
<!--引入jwt-->
<dependency>
<groupId>域名0</groupId>
<artifactId>java-jwt</artifactId>
<version>3.4.0</version>
</dependency>
</dependencies>
2、数据库结构
有一个JWT库,里面还有一个User表
3、配置文件域名erties
域名=8989
域名=域名域名dDataSource
域名er-class-name=域名.域名er
域名=jdbc:mysql://localhost:3306/JWT?characterEncoding=utf8&useSSL=false&serverTimezone=UTC&rewriteBatchedStatements=true
域名name=root
域名word=12345678
#mybatis扫描的包
域名-aliases-package=域名
#mapper文件路径
域名er-locations=classpath:/**/*.xml
#开启sql打印日志 域名l后面是mybatis对应的方法接口所在的包
域名.域名=debug
4、Entity包下新建一个User类
import 域名;
@Data
public class User {
private String username;
private String password;
private int id;
}
5、Dao包下新建一个UserDao
@Mapper
public interface UserDao {
User login(User user);
}
6、Service包下新建一个USerService
public interface UserService {
User login(User user);//登录接口
}
7、UseService的实现类UserServiceImp
import 域名Map;
import 域名;
@Service
public class UserServiceImpI implements UserService {
@Autowired
private UserDao userDao;
@Override
public User login(User user) {
User userdb=域名n(user);
if(userdb!=null)
{
Map<String,String> map=new HashMap<>();
域名("name",域名sername());
return userdb;
}
throw new RuntimeException("登录失败");
}
}
8、controller包下新建一个UserController
@RestController
public class UserController {
@Autowired
private UserService userService;
@GetMapping("/user/login")
public Map<String,Object> login(User user)
{
域名("用户名:"+域名sername());
域名("密码:"+域名assword());
Map<String,Object> map=new HashMap<>();
try {
域名n(user);
域名("msg","登录成功");
域名("code","200");
}
catch (Exception ex)
{
域名("msg","登录失败");
}
return map;
}
}
9、在resource文件夹下新建一个Usermapper文件
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE mapper PUBLIC "-//域名//DTD Mapper 3.0//EN" "http://域名/dtd/mybatis-3-域名">
<!--namespace 指的是要配置的全限定类名-->
<mapper namespace="域名域名Dao">
<select id="login" parameterType="域名域名" resultType="域名域名">
select *from user where username=#{username} and password=#{password}
</select>
</mapper>
10、JWT工具类JwtUtils
/**
* JWT工具类
* @author yanglingcong
* @date 2021/12/31 11:24 AM
*/
public class JwtUtils {
//鉴权 相当于私钥保存在服务器上
private static final String secret="##@$%@#S#WS";
/**
* 生成token
* @author yanglingcong
* @date 2021/12/31 11:23 AM
* @param map
* @return String
*/
public static String getToken(Map<String,String> map)
{
Calendar instance=域名nstance();
//默认七天过期
域名(域名,7);
//创建JWT
域名der builder = 域名te();
//payload
域名ach((k,v)->{
域名Claim(k,v);
});
//指定令牌过期时间
域名ExpiresAt(域名ime());
String token=域名(域名256(secret));
return token;
}
/**
* 验证token
* @author yanglingcong
* @date 2021/12/31 11:26 AM
* @param token
*/
public static DecodedJWT verify(String token) {
return 域名ire(域名256(secret)).build().verify(token);
}
}
整个项目概览
测试验证是否能够连通数据库
访问:localhost:8989/user/login?username=ylc&password=123456
引入JWT
@Slf4j
@RestController
public class UserController {
@Autowired
private UserService userService;
@GetMapping("/user/login")
public Map<String,Object> login(User user)
{
域名("用户名:"+域名sername());
域名("密码:"+域名assword());
Map<String,Object> map=new HashMap<>();
try {
域名n(user);
域名("msg","登录成功");
域名("code","200");
Map<String,String> payload=new HashMap<>();
域名("name",域名sername());
String token= 域名oken(payload);
域名("token",token);
}
catch (Exception ex)
{
域名("msg","登录失败");
}
return map;
}
@PostMapping("/test/verity")
public Map<String,String> verityToken(String token)
{
Map<String, String> map=new HashMap<>();
域名("token为"+token);
try {
DecodedJWT verify = 域名fy(token);
域名("msg","验证成功");
域名("state","true");
}
catch (Exception exception)
{
域名("msg","验证失败");
域名tStackTrace();
}
return map;
}
}
登录操作
访问:http://localhost:8989/user/login?username=ylc&password=123456
验证操作
访问:http://localhost:8989/test/verity
但是我们这样写在实际项目中是不合理的,把token生成的代码放在了Controller中,业务逻辑是不能放在Controller层中的。假如很多接口都需要token来进行验证保护,那每一个接口都需要添加这样一段代码,造成代码冗余。
程序优化
如果是web项目使用拦截器进行优化,如果是springcloud项目在网关层进行拦截,下面演示如何使用拦截器拦截
最好还把JWT生成token放在http请求头,这样就不需要把token当成参数传递了
新建一个拦截器JwtInterceptor
/**
* JWT拦截器
* @author yanglingcong
* @date 2021/12/31 12:39 PM
*/
public class JwtInterceptor implements HandlerInterceptor {
@Override
public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
HashMap<String, String> map=new HashMap<>();
//从http请求头获取token
String token = 域名eader("token");
try {
//如果验证成功放行请求
DecodedJWT verify = 域名fy(token);
return true;
}
catch (Exception exception)
{
域名("msg","验证失败:"+exception);
}
String json = new ObjectMapper().writeValueAsString(map);
域名ontentType("application/json:charset=UTF=8");
域名riter().println(json);
return false;
}
}
然后把拦截器注册到过滤器中,新建一个过滤器InterceptConfig
/**
* @author yanglingcong
*/
@Configuration
public class InterceptConfig implements WebMvcConfigurer {
@Override
public void addInterceptors(InterceptorRegistry registry) {
//添加拦截器
域名nterceptor(new JwtInterceptor())
//拦截的路径 需要进行token验证的路径
.addPathPatterns("/test/verity")
//放行的路径
.excludePathPatterns("/user/login");
}
}
登录是不需要拦截的,其他请求如果有需要验证token就放入拦截器的路径
测试验证
在http请求头中放入token,会被拦截器拦截验证token的有效性
总结
这就是SpringBoot整合JWT实际项目一个大概的流程,但是细节方面secret(私钥)肯定每个用户都是不一样的,这里给写死了,而且私钥得保存在一个安全的地方。包括payload部分不能存放敏感的密码信息等等,还可以进行优化。