注册功能
注册开发
- controller
- service
- 图形验证码发送
- 邮箱验证码验证
- 密码加密(TODO)
- 账号唯一性检查(TODO)
- 插入数据库
- 新注册用户福利发放(TODO)
- mapper
图形验证码开发
- Kaptcha 框架介绍 谷歌开源的一个可高度配置的实用验证码生成工具
- 验证码的字体/大小/颜色
- 验证码内容的范围(数字,字母,中文汉字!)
- 验证码图片的大小,边框,边框粗细,边框颜色
- 验证码的干扰线
- 验证码的样式(鱼眼样式、3D、普通模糊)
- 聚合工程依赖添加(使用国内baomidou二次封装的springboot整合starter)
<!--kaptcha依赖包-->
<dependency>
<groupId>com.baomidou</groupId>
<artifactId>kaptcha-spring-boot-starter</artifactId>
<version>1.1.0</version>
</dependency>
- 开发配置(任何框架和springboot整合基本都是)
@Configuration
public class CaptchaConfig {
/**
* 验证码配置
* Kaptcha配置类名
*
* @return
*/
@Bean
@Qualifier("captchaProducer")
public DefaultKaptcha kaptcha() {
DefaultKaptcha kaptcha = new DefaultKaptcha();
Properties properties = new Properties();
// properties.setProperty(Constants.KAPTCHA_BORDER, "yes");
// properties.setProperty(Constants.KAPTCHA_BORDER_COLOR, "220,220,220");
// //properties.setProperty(Constants.KAPTCHA_TEXTPRODUCER_FONT_COLOR, "38,29,12");
// properties.setProperty(Constants.KAPTCHA_IMAGE_WIDTH, "147");
// properties.setProperty(Constants.KAPTCHA_IMAGE_HEIGHT, "34");
// properties.setProperty(Constants.KAPTCHA_TEXTPRODUCER_FONT_SIZE, "25");
// //properties.setProperty(Constants.KAPTCHA_SESSION_KEY, "code");
//验证码个数
properties.setProperty(Constants.KAPTCHA_TEXTPRODUCER_CHAR_LENGTH, "4");
// properties.setProperty(Constants.KAPTCHA_TEXTPRODUCER_FONT_NAMES, "Courier");
//字体间隔
properties.setProperty(Constants.KAPTCHA_TEXTPRODUCER_CHAR_SPACE,"8");
//干扰线颜色
// properties.setProperty(Constants.KAPTCHA_NOISE_COLOR, "white");
//干扰实现类
properties.setProperty(Constants.KAPTCHA_NOISE_IMPL, "com.google.code.kaptcha.impl.NoNoise");
//图片样式
properties.setProperty(Constants.KAPTCHA_OBSCURIFICATOR_IMPL, "com.google.code.kaptcha.impl.WaterRipple");
//文字来源
properties.setProperty(Constants.KAPTCHA_TEXTPRODUCER_CHAR_STRING, "0123456789");
Config config = new Config(properties);
kaptcha.setConfig(config);
return kaptcha;
}
}
验证码加入缓存
/**
*临时使用10分钟有效,方便测试
*/
private static final long CAPTCHA_CODE_EXPIRED = 60 * 1000 * 10;
/**
* 获取图形验证码
* @param request
* @param response
*/
@ApiOperation("获取图形验证码")
@GetMapping("captcha")
public void getCaptcha(HttpServletRequest request, HttpServletResponse response){
String cacheKey = getCaptchaKey(request);
String capText = captchaProducer.createText();
//存储 redisTemplate.opsForValue().set(cacheKey,capText,CAPTCHA_CODE_EXPIRED,TimeUnit.MILLISECONDS);
BufferedImage bi = captchaProducer.createImage(capText);
ServletOutputStream out = null;
try {
response.setDateHeader("Expires", 0);
response.setHeader("Cache-Control", "no-store, no-cache, must-revalidate");
response.addHeader("Cache-Control", "create_date-check=0, pre-check=0");
response.setHeader("Pragma", "no-cache");
out = response.getOutputStream();
ImageIO.write(bi, "jpg", out);
out.flush();
out.close();
} catch (IOException e) {
log.error("获取验证码失败:{}",e);
}
}
邮箱验证码验证
邮件发送
- 邮件发送的基本过程与概念
- 邮件服务器 :类似于现实生活中的邮局,它主要负责接收用户投递过来的邮件,并把邮件投递到邮件接收者的电子邮箱中
- 电子邮箱 :用户在邮件服务器上申请的一个账户
- from:xxx@xx.com ----发件人
- to:xxx@xx.com ----收件人
- subject:hello ----主题
- body: 欢迎来到小滴课堂 -----内容体
- 邮件传输协议
- SMTP协议:全称为 Simple Mail Transfer Protocol,简单邮件传输协议。它定义了邮件客户端软件和SMTP邮件服务器之间,以及两台SMTP邮件服务器之间的通信规则
- POP3协议:全称为 Post Office Protocol,邮局协议。它定义了邮件客户端软件和POP3邮件服务器的通信 规则
- IMAP协议:全称为 Internet Message Access Protocol,Internet消息访问协议,它是对POP3协议一种扩展,也是定义了邮件客户端软件和IMAP邮件服务器的通信规则
- 配置文件
#邮箱服务配置
mail:
host: smtp.126.com #发送邮件服务器
username: waitforxy@126.com #发送邮件的邮箱地址
password: CJVYSJOTRXUSSEJE #客户端授权码,不是邮箱密码,网易的是自己设置的
from: waitforxy@126.com # 发送邮件的地址,和上面username一致
properties.mail.smtp.starttls.enable: true
properties.mail.smtp.starttls.required: true
properties.mail.smtp.ssl.enable: true
default-encoding: utf-8
- 用户微服务 service封装
@Service
@Slf4j
public class MailServiceImpl implements MailService {
/**
* Spring Boot 提供了一个发送邮件的简单抽象,直接注入即可使用
*/
@Autowired
private JavaMailSender mailSender;
/**
* 配置文件中的发送邮箱
*/
@Value("${spring.mail.from}")
private String from;
@Override
public void sendSimpleMail(String to, String subject, String content) {
//创建SimpleMailMessage对象
SimpleMailMessage message = new SimpleMailMessage();
//邮件发送人
message.setFrom(from);
//邮件接收人
message.setTo(to);
//邮件主题
message.setSubject(subject);
//邮件内容
message.setText(content);
//发送邮件
mailSender.send(message);
log.info("邮件发成功:{}",message.toString());
}
}
发送邮箱验证码
- controller
/**
* 支持手机号、邮箱发送验证码
* @return
*/
@ApiOperation("发送验证码")
@GetMapping("send_code")
public JsonData sendRegisterCode(@ApiParam("收信人") @RequestParam(value = "to", required = true)String to,
@ApiParam("图形验证码") @RequestParam(value = "captcha", required = true)String captcha,
HttpServletRequest request){
String key = getCaptchaKey(request);
String cacheCaptcha = redisTemplate.opsForValue().get(key);
if(captcha!=null && cacheCaptcha!=null && cacheCaptcha.equalsIgnoreCase(captcha)) {
redisTemplate.delete(key);
JsonData jsonData = notifyService.sendCode(SendCodeEnum.USER_REGISTER,to);
return jsonData;
}else {
return JsonData.buildResult(BizCodeEnum.CODE_CAPTCHA);
}
}
- service
@Override
public JsonData sendCode(SendCodeEnum sendCodeType, String to) {
if(CheckUtil.isEmail(to)){
//邮箱验证码
mailService.sendSimpleMail(to,SUBJECT,String.format(CONTENT,code));
return JsonData.buildSuccess();
}else if(CheckUtil.isPhone(to)){
//短信验证码
}
return JsonData.buildResult(BizCodeEnum.CODE_TO_ERROR);
}
邮箱验证码防刷方案
需求:一定时间内禁止重复发送邮件,大家想下有哪几种实现方式
-
方式一:前端增加校验倒计时,不到60秒按钮不给点击
- 简单
- 不安全,存在绕过的情况
-
方式二:增加Redis存储,发送的时候设置下额外的key,并且60秒后过期
-
非原子操作,存在不一致性
-
增加的额外的key - value存储,浪费空间
-
/** * 前置:判断是否重复发送 * * 1、存储验证码到缓存 * * 2、发送邮箱验证码 * * 后置:存储发送记录 **/
-
-
方式三:基于原先的key拼装时间戳
- 好处:满足了当前节点内的原子性,也满足业务需求
public JsonData sendCode(SendCodeEnum sendCodeEnum, String to) {
String cacheKey = String.format(CacheKey.CHECK_CODE_KEY,sendCodeEnum.name(),to);
String cacheValue = redisTemplate.opsForValue().get(cacheKey);
//如果不为空,则判断是否60秒内重复发送
if(StringUtils.isNotBlank(cacheValue)){
long ttl = Long.parseLong(cacheValue.split("_")[1]);
//当前时间戳-验证码发送时间戳,如果小于60秒,则不给重复发送
if(CommonUtil.getCurrentTimestamp() - ttl < 1000*60){
log.info("重复发送验证码,时间间隔:{} 秒",(CommonUtil.getCurrentTimestamp()-ttl)/1000);
return JsonData.buildResult(BizCodeEnum.CODE_LIMITED);
}
}
//拼接验证码 2322_324243232424324
String code = CommonUtil.getRandomCode(6);
String value = code+"_"+CommonUtil.getCurrentTimestamp();
redisTemplate.opsForValue().set(cacheKey,value,CODE_EXPIRED,TimeUnit.MILLISECONDS);
if(CheckUtil.isEmail(to)){
//邮箱验证码
mailService.sendMail(to,SUBJECT,String.format(CONTENT,code));
return JsonData.buildSuccess();
} else if(CheckUtil.isPhone(to)){
//短信验证码
}
return JsonData.buildResult(BizCodeEnum.CODE_TO_ERROR);
}
阿里云OSS对象存储客户端集成
-
添加阿里云OSS的SDK
-
添加maven依赖
<!-- OSS各个项目单独加依赖,根据需要进行添加--> <dependency> <groupId>com.aliyun.oss</groupId> <artifactId>aliyun-sdk-oss</artifactId> <version>3.10.2</version> </dependency>
-
微服务配置OSS
#阿里云OSS配置
aliyun:
oss:
endpoint: oss-cn-beijing.aliyuncs.com
access-key-id: LTAI4GKz7Z1RRjzMYeHG3FCe
access-key-secret: QilitkUsr0PMJYEK8MAPFdI4cFOLVq
bucketname: xd-test1
- 新建配置类 (配置里面的横杠会,自动转驼峰)
@ConfigurationProperties(prefix = "aliyun.oss")
@Configuration
@Data
public class OSSConfig {
private String endpoint;
private String accessKeyId;
private String accessKeySecret;
private String bucketname;
}
微服务注册头像上传
-
文件上传流程
- 先上传文件,返回url地址,再和普通表单一并提交(推荐这种,更加灵活,失败率低)
- 文件和普通表单一并提交(设计流程比较多,容易超时和失败)
-
注意:默认SpringBoot最大文件上传是1M,大家测试的时候记得关注下
- controller
- @requestPart注解 接收文件以及其他更为复杂的数据类型
- 比如 XXX(@RequestPart("file") MultipartFile file, @RequestPart("userVO") UserVO userVO) 复杂协议
/**
* 上传用户头像
*
* 默认文件大小 1M,超过会报错
*
* @param file
* @return
*/
@ApiOperation("用户头像上传")
@PostMapping(value = "upload")
public JsonData uploadHeaderImg(@ApiParam(value = "文件上传",required = true) @RequestPart("file") MultipartFile file){
String result = fileService.uploadUserHeadImg(file);
return result != null?JsonData.buildSuccess(result):JsonData.buildResult(BizCodeEnum.FILE_UPLOAD_USER_IMG_FAIL);
}
- service
@Service
@Slf4j
public class FileServiceImpl implements FileService {
@Autowired
private OSSConfig ossConfig;
@Override
public String uploadUserHeadImg( MultipartFile file) {
String originalFilename = file.getOriginalFilename();
//获取相关配置
String bucketName = ossConfig.getBucketname();
String endpoint = ossConfig.getEndpoint();
String accessKeyId = ossConfig.getAccessKeyId();
String accessKeySecret = ossConfig.getAccessKeySecret();
//创建oss对象
OSS ossClient = new OSSClientBuilder().build(endpoint, accessKeyId, accessKeySecret);
//JDK8新特性写法,构建路径
LocalDateTime ldt = LocalDateTime.now();
DateTimeFormatter dtf = DateTimeFormatter.ofPattern("yyyy/MM/dd");
String folder = dtf.format(ldt);
String fileName = CommonUtil.generateUUID();
String extension = originalFilename.substring(originalFilename.lastIndexOf("."));
//在oss上创建文件夹test路径
String newFileName = "test/" + folder + "/" + fileName + extension;
try {
PutObjectResult result = ossClient.putObject(bucketName, newFileName, file.getInputStream());
//返回访问路径
if (null != result) {
//https://xd-test1.oss-cn-beijing.aliyuncs.com/test/1.jpg
String imgUrl = "https://"+bucketName+"."+endpoint+"/"+newFileName;
return imgUrl;
}
} catch (Exception e) {
log.error("上传头像失败:{}",e);
} finally {
// 关闭OSS服务
ossClient.shutdown();
}
return null;
}
}
密码加密
- controller
@ApiOperation("用户登录")
@PostMapping("login")
public JsonData login(@ApiParam("用户登录对象") @RequestBody UserLoginRequest userLoginRequest) {
JsonData jsonData = userService.login(userLoginRequest);
return jsonDat;
}
- service
/**
* 用户注册
*
* @param registerRequest
* @return
*/
@Override
public JsonData register(UserRegisterRequest registerRequest) {
boolean checkCode = false;
if (StringUtils.isNotBlank(registerRequest.getMail())) {
checkCode = notifyService.checkCode(SendCodeEnum.USER_REGISTER, registerRequest.getMail(), registerRequest.getCode());
}
if (!checkCode) {
return JsonData.buildResult(BizCodeEnum.CODE_ERROR);
}
UserDO userDO = new UserDO();
BeanUtils.copyProperties(registerRequest, userDO);
userDO.setCreateTime(new Date());
//设置密码 加盐处理
userDO.setSecret("$1$" + CommonUtil.getStringNumRandom(8));
//设置密码
String cryptPwd = Md5Crypt.md5Crypt(registerRequest.getPwd().getBytes(), userDO.getSecret());
userDO.setPwd(cryptPwd);
//检查账号唯一性
if (checkUnique(userDO.getMail())) {
int rows = userMapper.insert(userDO);
log.info("rows:{},注册成功:{}", rows, userDO.toString());
//新用户注册,初始化信息,发福利
userRegisterInitTask(userDO);
return JsonData.buildSuccess();
} else {
return JsonData.buildResult(BizCodeEnum.ACCOUNT_REPEAT);
}
}