尚融宝15-集成阿里云短信服务

痛定思痛。 2023-10-11 21:15 23阅读 0赞

**目录**

一、前言

二、测试短信发送

1、查找使用示例

2、测试短信发送 编辑

三、使用RAM子用户

1、进入子用户管理页面

2、添加用户

3、获取子用户key

4、设置用户权限

四、短信使用场景和流程

五、创建短信微服务

1、创建项目

2、自定义配置

3、发送短信

--------------------

## 一、前言 ##

在阿里云的短信服务上面申请签名和模板（这里签名我之前做瑞吉外卖申请过了，所以直接使用瑞吉外卖，类型都是选择验证码）之后，如果我们直接测试短信发送会提示余额不足[阿里云-为了无法计算的价值 (aliyun.com)![icon-default.png?t=N2N8][icon-default.png_t_N2N8]https://www.aliyun.com/][-_ _aliyun.com_icon-default.png_t_N2N8_icon-default.png_t_N2N8_https_www.aliyun.com]

所以我们可以到试用版阿里云上开通一下免费使用三个月的短信服务，可用数量为1000

[阿里云免费试用 (aliyun.com)![icon-default.png?t=N2N8][icon-default.png_t_N2N8]https://free.aliyun.com/][_aliyun.com_icon-default.png_t_N2N8_icon-default.png_t_N2N8_https_free.aliyun.com]![3959206c1e194a2fa8a711a85d8f8a71.png][]

## 二、测试短信发送 ##

### 1、查找使用示例 ###

![a065b3b62931450a9130657100b07a07.png][]

### 2、测试短信发送 ![11fd4f31402840808738df215c1b383f.png][] ###

![8f1e0409f2e0483298a55f2a1fdca355.png][]

然后你填的手机号就会接收到验证码消息了

## 三、使用RAM子用户 ##

### 1、进入子用户管理页面 ###

![327d252d0db049b29944f1bfedd30367.png][]

![40a3ef2721f04df0b9c05259d1541042.png][]

### 2、添加用户 ###

我们需要使用用户的密钥来连接阿里云平台，所以新建一个子用户

![5a49b185086749a2a4629f5b4774c317.png][]

### 3、获取子用户key ###

创建完成后要记下AccessKeyId, AccessKeySecret，因为刷新页面后这些密钥就会消失不再显示

### 4、设置用户权限 ###

授权：AliyunDysmsFullAccess![2cc53fb75f804385b05e68555718ad7f.png][]

## 四、短信使用场景和流程 ##

用户注册账号需要向手机发送验证码

![546819b0f8e8424e8d12eea1fa62d52e.jpeg][]

短信发送验证码流程

![9c024762e2be4c9b99a9ba95d6954e60.png][]

## 五、创建短信微服务 ##

### 1、创建项目 ###

service-sms

pom.xml导入依赖

<dependencies>
    
        <dependency>
            <groupId>com.atguigu</groupId>
            <artifactId>service-base</artifactId>
            <version>0.0.1-SNAPSHOT</version>
        </dependency>
    
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
    
        
        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
        </dependency>
    
        
        <dependency>
            <groupId>com.aliyun</groupId>
            <artifactId>aliyun-java-sdk-core</artifactId>
        </dependency>
    
    </dependencies>

resources目录下创建文件application.yaml

server:
      port: 8120 # 服务端口
    
    spring:
      profiles:
        active: dev # 环境设置
      application:
        name: service-sms # 服务名
    
      #spring:
      redis:
        host: 192.168.100.100
        port: 6379
        database: 0
        password: 123456 #默认为空
        timeout: 3000ms #最大等待时间，超时则抛出异常，否则请求一直等待
        lettuce:
          pool:
            max-active: 20  #最大连接数，负值表示没有限制，默认8
            max-wait: -1    #最大阻塞等待时间，负值表示没限制，默认-1
            max-idle: 8     #最大空闲连接，默认8
            min-idle: 0     #最小空闲连接，默认0
    
    #阿里云短信
    aliyun:
      sms:
        region-id: cn-hangzhou
        key-id: 你的keyid
        key-secret: 你的keysecret
        template-code: 你的短信模板code
        sign-name: 你的短信模板签名

logback-spring.xml

<?xml version="1.0" encoding="UTF-8"?>
    <configuration>
    
        <contextName>atguiguSrb</contextName>
    
        
        <property name="log.path" value="D:/idealworkspace/shangrb/srb_log/sms" />
    
        
        
        
        
        
        
        <property name="CONSOLE_LOG_PATTERN"
                  value="%yellow(%date{yyyy-MM-dd HH:mm:ss}) %highlight([%-5level]) %green(%logger) %msg%n"/>
    
        
        <property name="FILE_LOG_PATTERN"
                  value="%date{yyyy-MM-dd HH:mm:ss} [%-5level] %thread %file:%line %logger %msg%n" />
    
        
        <property name="ENCODING"
                  value="UTF-8" />
    
        
        <appender name="CONSOLE" class="ch.qos.logback.core.ConsoleAppender">
            <encoder>
                <pattern>${CONSOLE_LOG_PATTERN}</pattern>
                <charset>${ENCODING}</charset>
            </encoder>
        </appender>
    
        
        <appender name="FILE" class="ch.qos.logback.core.FileAppender">
            <file>${log.path}/log.log</file>
            <append>true</append>
            <encoder>
                <pattern>${FILE_LOG_PATTERN}</pattern>
                <charset>${ENCODING}</charset>
            </encoder>
        </appender>
    
        <appender name="ROLLING_FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
    
            
            <file>${log.path}/log-rolling.log</file>
            <encoder>
                <pattern>${FILE_LOG_PATTERN}</pattern>
                <charset>${ENCODING}</charset>
            </encoder>
    
    
            
            <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
                
                <fileNamePattern>${log.path}/info/log-rolling-%d{yyyy-MM-dd}.%i.log</fileNamePattern>
                
                <maxHistory>15</maxHistory>
    
                <timeBasedFileNamingAndTriggeringPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedFNATP">
                    <maxFileSize>1KB</maxFileSize>
                </timeBasedFileNamingAndTriggeringPolicy>
            </rollingPolicy>
    
        </appender>
    
    
        
        
        
        
    
        
        <springProfile name="dev,test">
            <logger name="com.atguigu" level="INFO">
                <appender-ref ref="CONSOLE" />
                <appender-ref ref="ROLLING_FILE" />
            </logger>
        </springProfile>
    
        
        <springProfile name="prod">
            <logger name="com.atguigu" level="ERROR">
                <appender-ref ref="CONSOLE" />
                <appender-ref ref="ROLLING_FILE" />
            </logger>
        </springProfile>
    </configuration>

创建启动类

@SpringBootApplication
    @ComponentScan({"com.atguigu.srb", "com.atguigu.common"})
    public class ServiceSmsApplication {
        
        public static void main(String[] args) {
            SpringApplication.run(ServiceSmsApplication.class, args);
        }
    }

### 2、自定义配置 ###

创建常量读取工具类：SmsProperties.java

@Setter
    @Getter //idea2020.2.3版配置文件自动提示需要这个
    @Component
    //注意prefix要写到最后一个 "." 符号之前
    //调用setter为成员赋值
    @ConfigurationProperties(prefix = "aliyun.sms")
    public class SmsProperties implements InitializingBean {
    
        private String regionId;
        private String keyId;
        private String keySecret;
        private String templateCode;
        private String signName;
    
        public static String REGION_Id;
        public static String KEY_ID;
        public static String KEY_SECRET;
        public static String TEMPLATE_CODE;
        public static String SIGN_NAME;
    
        //当私有成员被赋值后，此方法自动被调用，从而初始化常量
        @Override
        public void afterPropertiesSet() throws Exception {
            REGION_Id = regionId;
            KEY_ID = keyId;
            KEY_SECRET = keySecret;
            TEMPLATE_CODE = templateCode;
            SIGN_NAME = signName;
        }
    }

创建测试类 UtilsTests，测试配置信息是否能正常获取

@SpringBootTest
    @RunWith(SpringRunner.class)
    public class UtilsTests {
    
        @Test
        public void testProperties(){
            System.out.println(SmsProperties.KEY_ID);
            System.out.println(SmsProperties.KEY_SECRET);
            System.out.println(SmsProperties.REGION_Id);
        }
    }

### 3、发送短信 ###

接口：创建 SmsService

public interface SmsService {
    
        void send(String mobile, String templateCode, Map<String,Object> param);
    }

实现：创建 SmsServiceImpl

@Service
    @Slf4j
    public class SmsServiceImpl implements SmsService {
    
        @Override
        public void send(String mobile, String templateCode, Map<String,Object> param) {
    
            //创建远程连接客户端对象
            DefaultProfile profile = DefaultProfile.getProfile(
                    SmsProperties.REGION_Id,
                    SmsProperties.KEY_ID,
                    SmsProperties.KEY_SECRET);
            IAcsClient client = new DefaultAcsClient(profile);
    
            //创建远程连接的请求参数
            CommonRequest request = new CommonRequest();
            request.setSysMethod(MethodType.POST);
            request.setSysDomain("dysmsapi.aliyuncs.com");
            request.setSysVersion("2017-05-25");
            request.setSysAction("SendSms");
            request.putQueryParameter("RegionId", SmsProperties.REGION_Id);
            request.putQueryParameter("PhoneNumbers", mobile);
            request.putQueryParameter("SignName", SmsProperties.SIGN_NAME);
            request.putQueryParameter("TemplateCode", templateCode);
    
            Gson gson = new Gson();
            String json = gson.toJson(param);
            request.putQueryParameter("TemplateParam", json);
    
            try {
                //使用客户端对象携带请求对象发送请求并得到响应结果
                CommonResponse response = client.getCommonResponse(request);
                boolean success = response.getHttpResponse().isSuccess();
                //ALIYUN_RESPONSE_FAIL(-501, "阿里云响应失败"),
                Assert.isTrue(success, ResponseEnum.ALIYUN_RESPONSE_FAIL);
    
                String data = response.getData();
                HashMap<String, String> resultMap = gson.fromJson(data, HashMap.class);
                String code = resultMap.get("Code");
                String message = resultMap.get("Message");
                log.info("阿里云短信发送响应结果：");
                log.info("code：" + code);
                log.info("message：" + message);
    
                //ALIYUN_SMS_LIMIT_CONTROL_ERROR(-502, "短信发送过于频繁"),//业务限流
                Assert.notEquals("isv.BUSINESS_LIMIT_CONTROL", code, ResponseEnum.ALIYUN_SMS_LIMIT_CONTROL_ERROR);
                //ALIYUN_SMS_ERROR(-503, "短信发送失败"),//其他失败
                Assert.equals("OK", code, ResponseEnum.ALIYUN_SMS_ERROR);
    
            } catch (ServerException e) {
                log.error("阿里云短信发送SDK调用失败：");
                log.error("ErrorCode=" + e.getErrCode());
                log.error("ErrorMessage=" + e.getErrMsg());
                throw new BusinessException(ResponseEnum.ALIYUN_SMS_ERROR , e);
            } catch (ClientException e) {
                log.error("阿里云短信发送SDK调用失败：");
                log.error("ErrorCode=" + e.getErrCode());
                log.error("ErrorMessage=" + e.getErrMsg());
                throw new BusinessException(ResponseEnum.ALIYUN_SMS_ERROR , e);
            }
        }
    }

guigu-common中创建util包，引入工具类：

RandomUtils.java：生成四位或六位的验证码

RegexValidateUtils.java：常用正则表达式验证，这里提供了手机号码验证

创建controller.api包，创建类ApiSmsController

@RestController
    @RequestMapping("/api/sms")
    @Api(tags = "短信管理")
    @CrossOrigin //跨域
    @Slf4j
    public class ApiSmsController {
    
        @Resource
        private SmsService smsService;
    
        @Resource
        private RedisTemplate redisTemplate;
    
        @ApiOperation("获取验证码")
        @GetMapping("/send/{mobile}")
        public R send(
                @ApiParam(value = "手机号", required = true)
                @PathVariable String mobile){
    
            //MOBILE_NULL_ERROR(-202, "手机号不能为空"),
            Assert.notEmpty(mobile, ResponseEnum.MOBILE_NULL_ERROR);
            //MOBILE_ERROR(-203, "手机号不正确"),
            Assert.isTrue(RegexValidateUtils.checkCellphone(mobile), ResponseEnum.MOBILE_ERROR);
    
            //生成验证码
            String code = RandomUtils.getFourBitRandom();
            //组装短信模板参数
            Map<String,Object> param = new HashMap<>();
            param.put("code", code);
            //发送短信
            smsService.send(mobile, SmsProperties.TEMPLATE_CODE, param);
    
            //将验证码存入redis
            redisTemplate.opsForValue().set("srb:sms:code:" + mobile, code, 5, TimeUnit.MINUTES);
    
            return R.ok().message("短信发送成功");
        }
    }

[icon-default.png_t_N2N8]: https://csdnimg.cn/release/blog_editor_html/release2.2.4/ckeditor/plugins/CsdnLink/icons/icon-default.png?t=N2N8
[-_ _aliyun.com_icon-default.png_t_N2N8_icon-default.png_t_N2N8_https_www.aliyun.com]: https://www.aliyun.com/
[_aliyun.com_icon-default.png_t_N2N8_icon-default.png_t_N2N8_https_free.aliyun.com]: https://free.aliyun.com/
[3959206c1e194a2fa8a711a85d8f8a71.png]: https://img-blog.csdnimg.cn/3959206c1e194a2fa8a711a85d8f8a71.png
[a065b3b62931450a9130657100b07a07.png]: https://img-blog.csdnimg.cn/a065b3b62931450a9130657100b07a07.png
[11fd4f31402840808738df215c1b383f.png]: https://img-blog.csdnimg.cn/11fd4f31402840808738df215c1b383f.png
[8f1e0409f2e0483298a55f2a1fdca355.png]: https://img-blog.csdnimg.cn/8f1e0409f2e0483298a55f2a1fdca355.png
[327d252d0db049b29944f1bfedd30367.png]: https://img-blog.csdnimg.cn/327d252d0db049b29944f1bfedd30367.png
[40a3ef2721f04df0b9c05259d1541042.png]: https://img-blog.csdnimg.cn/40a3ef2721f04df0b9c05259d1541042.png
[5a49b185086749a2a4629f5b4774c317.png]: https://img-blog.csdnimg.cn/5a49b185086749a2a4629f5b4774c317.png
[2cc53fb75f804385b05e68555718ad7f.png]: https://img-blog.csdnimg.cn/2cc53fb75f804385b05e68555718ad7f.png
[546819b0f8e8424e8d12eea1fa62d52e.jpeg]: https://img-blog.csdnimg.cn/546819b0f8e8424e8d12eea1fa62d52e.jpeg
[9c024762e2be4c9b99a9ba95d6954e60.png]: https://img-blog.csdnimg.cn/9c024762e2be4c9b99a9ba95d6954e60.png