01、短信发送

1、短信服务介绍

目前市面上有很多第三方提供的短信服务,这些第三方短信服务会和各个运营商(移动、联通、电信)对接,我们只需要注册成为会员并且按照提供的开发文档进行调用就可以发送短信。需要说明的是,这些短信服务一般都是收费服务

常用短信服务
  • 阿里云
  • 华为云
  • 腾讯云
  • 京东云
  • 梦网
  • 乐信

2、阿里云短信服务

短信服务(Short Message Service)是广大企业客户快速触达手机用户所优选使用的通信能力。调用API或用群发助手,即可发送验证码、通知类和营销类短信;国内验证短信秒级触达,到达率最高可达99%;国际/港澳台短信覆盖200多个国家和地区,安全稳定,广受出海企业选用。

应用场景
  • 验证码
  • 短信通知
  • 推广短信

阿里云短信服务

购买试用产品

购买使用产品

3、短信发送

01.设置短信签名

设置短信签名

02.设置短信模板

设置短信模板

设置AccessKey,选则使用子用户AccessKey

入口

创建用户

创建用户

设置权限

权限

4、代码开发

开发指南:阿里云短信服务

添加依赖

<dependency>
    <groupId>com.aliyun</groupId>
    <artifactId>aliyun-java-sdk-core</artifactId>
    <version>4.5.30</version>
</dependency>
<dependency>
    <groupId>com.aliyun</groupId>
    <artifactId>aliyun-java-sdk-dysmsapi</artifactId>
    <version>2.2.1</version>
</dependency>

工具类SMSUtils

目录:util

package cn.mu00.reggie.util;

import com.aliyuncs.DefaultAcsClient;
import com.aliyuncs.IAcsClient;
import com.aliyuncs.dysmsapi.model.v20170525.SendSmsRequest;
import com.aliyuncs.dysmsapi.model.v20170525.SendSmsResponse;
import com.aliyuncs.exceptions.ClientException;
import com.aliyuncs.profile.DefaultProfile;

/**
 * 短信发送工具类
 */
public class SMSUtils {

    /**
     * 发送短信
     * @param signName 签名
     * @param templateCode 模板
     * @param phoneNumbers 手机号
     * @param param 参数
     */
    public static void sendMessage(String signName, String templateCode,String phoneNumbers,String param){
        DefaultProfile profile = DefaultProfile.getProfile("cn-hangzhou", "", "");
        IAcsClient client = new DefaultAcsClient(profile);

        SendSmsRequest request = new SendSmsRequest();
        request.setSysRegionId("cn-hangzhou");
        request.setPhoneNumbers(phoneNumbers);
        request.setSignName(signName);
        request.setTemplateCode(templateCode);
        request.setTemplateParam("{\"code\":\""+param+"\"}");
        try {
            SendSmsResponse response = client.getAcsResponse(request);
            System.out.println("短信发送成功");
        }catch (ClientException e) {
            e.printStackTrace();
        }
    }
}

02、手机验证码登录

1、需求分析

修改LoginCheckFilter过滤器,放行手机验证码的接口

加入移动端登录过滤

// 定义不需要处理的请求路径
String[] urls = new String[]{
    "/employee/login",
    "/employee/logout",
    "/backend/**",
    "/front/**",
    "/common/**",
    "/user/sendMsg", // 移动端发送短信验证码
    "/user/login" // 移动端登录
};

// 4-2、判断移动端登陆状态,如果已登录,则直接放行
if (request.getSession().getAttribute("user") != null){
    Long userId = (Long) request.getSession().getAttribute("user");
    BaseContext.setCurrentId(userId);
    log.info("用户已登录,用户id为:{}", userId);
    filterChain.doFilter(request, response);
    return;
}

1.没有阿里云短信服务无需修改代码

2.有阿里云短信服务

// src/main/resources/front/api/login.js
// 添加发送短信的接口
function sendMsgApi(data) {
    return $axios({
        'url': '/user/sendMsg',
        'method': 'post',
        data
    })
}
<!-- src/main/resources/front/page/login.html -->
<script>
    // 60行methods
    methods:{
        getCode(){
            this.form.code = ''
            const regex = /^(13[0-9]{9})|(15[0-9]{9})|(17[0-9]{9})|(18[0-9]{9})|(19[0-9]{9})$/;
            if (regex.test(this.form.phone)) {
                this.msgFlag = false
                // 没有短信服务就启用这个
                // this.form.code = (Math.random()*1000000).toFixed(0)
                // 有短信服务启用这个
                sendMsgApi({phone:this.form.phone})
            }else{
                this.msgFlag = true
            }
        }
    }
</script>
发送手机验证码
  • 请求地址:http://localhost:8080/user/sendMsg
  • 请求类型:POST
  • 请求参数:{phone}
用户登录
  • 请求地址:http://localhost:8080/user/login
  • 请求类型:POST
  • 请求参数:{phone,code}

2、代码开发

01.User实体类
package cn.mu00.reggie.entity;

import lombok.Data;
import java.io.Serializable;
/**
 * 用户信息
 */
@Data
public class User implements Serializable {

    private static final long serialVersionUID = 1L;

    private Long id;

    //姓名
    private String name;

    //手机号
    private String phone;

    //性别 0 女 1 男
    private String sex;

    //身份证号
    private String idNumber;

    //头像
    private String avatar;

    //状态 0:禁用,1:正常
    private Integer status;
}
02.UserMapper
package cn.mu00.reggie.mapper;

import cn.mu00.reggie.entity.User;
import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import org.apache.ibatis.annotations.Mapper;

@Mapper
public interface UserMapper extends BaseMapper<User> {
}
03.UserService
package cn.mu00.reggie.service;

import cn.mu00.reggie.entity.User;
import com.baomidou.mybatisplus.extension.service.IService;

public interface UserService extends IService<User> {
}
04.UserServiceImpl
package cn.mu00.reggie.service.impl;

import cn.mu00.reggie.entity.User;
import cn.mu00.reggie.mapper.UserMapper;
import cn.mu00.reggie.service.UserService;
import com.baomidou.mybatisplus.extension.service.impl.ServiceImpl;
import org.springframework.stereotype.Service;

@Service
public class UserServiceImpl extends ServiceImpl<UserMapper, User> implements UserService {
}
05.UserController
package cn.mu00.reggie.controller;

import cn.mu00.reggie.service.UserService;
import lombok.extern.slf4j.Slf4j;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;


@RestController
@RequestMapping("/user")
@Slf4j
public class UserController {
    @Autowired
    private UserService userService;
}
06.ValidateCodeUtils
package cn.mu00.reggie.util;

import java.util.Random;

/**
 * 随机生成验证码工具类
 */
public class ValidateCodeUtils {
    /**
     * 随机生成验证码
     * @param length 长度为4位或者6位
     * @return
     */
    public static Integer generateValidateCode(int length){
        Integer code =null;
        if(length == 4){
            code = new Random().nextInt(9999);//生成随机数,最大为9999
            if(code < 1000){
                code = code + 1000;//保证随机数为4位数字
            }
        }else if(length == 6){
            code = new Random().nextInt(999999);//生成随机数,最大为999999
            if(code < 100000){
                code = code + 100000;//保证随机数为6位数字
            }
        }else{
            throw new RuntimeException("只能生成4位或6位数字验证码");
        }
        return code;
    }

    /**
     * 随机生成指定长度字符串验证码
     * @param length 长度
     * @return
     */
    public static String generateValidateCode4String(int length){
        Random rdm = new Random();
        String hash1 = Integer.toHexString(rdm.nextInt());
        String capstr = hash1.substring(0, length);
        return capstr;
    }
}

07.发送短信验证码

位置:UserController

/**
 * 发送短信验证码
 * @param user
 * @return
 */
@PostMapping("/sendMsg")
public R<String> sendMsg(@RequestBody User user, HttpSession session){

    // 获取手机号
    String phone = user.getPhone();

    if (StringUtils.isNotEmpty(phone)){
        // 生成随机4为验证码
        String code = ValidateCodeUtils.generateValidateCode(4).toString();
        log.info("code={}", code);

        // 调用阿里云提供的短信服务API完成短信发送,为了不浪费钱,注释了,功能不影响
        // SMSUtils.sendMessage("小沐沐吖","SMS_248910220",phone,code);

        // 需要将生成的验证码保存到session
        session.setAttribute(phone, code);
        return R.success("手机验证码短信发送成功!");
    }

    return R.error("短信发送失败");
}

08.用户登录

位置:UserController

/**
 * 移动端用户登录
 * @param user
 * @param session
 * @return
 */
@PostMapping("/login")
public R<User> login(@RequestBody Map map, HttpSession session){
    log.info(map.toString());

    // 获取手机号
    String phone = map.get("phone").toString();

    // 获取验证码
    String code = map.get("code").toString();

    // 从session中获取保存的验证码
    String codeInSession = (String) session.getAttribute(phone);

    // 进行验证码校验
    if (codeInSession != null && codeInSession.equals(code)){
        // 比对成功,登录成功
        // 判断手机号是否存在(新用户)
        LambdaQueryWrapper<User> queryWrapper = new LambdaQueryWrapper<>();
        queryWrapper.eq(User::getPhone, phone);
        User user = userService.getOne(queryWrapper);
        if (user == null){
            // 若不存在则添加用户数据
            user = new User();
            user.setPhone(phone);
            userService.save(user);
        }
        session.setAttribute("user", user.getId());
        return R.success(user);
    }
    return R.error("登录成功");
}

03、退出登录

1、需求分析

  • 请求地址:http://localhost:8080/user/loginout
  • 请求类型:POST

2、代码实现

位置:UserController
/**
 * 用户退出
 * @param session
 * @return
 */
@PostMapping("/loginout")
public R<String> logout(HttpSession session){
    // 清理Session中保存的当前用户的id
    session.removeAttribute("user");
    return R.success("退出成功");
}
最后修改:2022 年 08 月 16 日
如果觉得我的文章对你有用,请随意赞赏