一、阿里云短信服务开通

1.阿里云短信说明

https://dysms.console.aliyun.com/overview

登录访问阿里云短信服务,可以看到大致的操作步骤：

1.申请签名，如：【阿里云短信】

2.申请模板，如：【阿里云通信】您正在使用阿里云短信测试服务，体验验证码是：8888，如非本人操作，请忽略本短信！

3.系统设置，状态报告，审核通知，上行消息接收等

4.发送短信

阿里云提供了验证码的发送测试，我们可以通过测试发送短信到手机上查看效果。

通过下图我们可以看到阿里云发送消息分为国内消息和国际/港澳台消息两个类型，两者都需要单独申请签名模板才能发送。本文已国内消息下发为例，国际消息同理。

APIDemo

2.接入阿里云短信

2.1RAM访问控制添加用户

AccessKey和子用户AccessKey的区别在于AccessKey账户具备所有权限而子用户AccessKey需要手动添加。

这里我选择的是子账户进入之后添加新增用户如下，我们创建这个账户后续通过接口的方式调用阿里短信服务发送短信，所以这里一定要勾选OpenApI通用访问。

添加账户成功之后我们需要给子账户分配权限，授权：AliyunDysmsFullAccess

开通账户之后，一定要记录下AccessKeyId, AccessKeySecret便于后续使用

3.开通短信服务

3.1、开通

3.2、添加签名

3.3、添加模板

3.4、套餐

free.aliyun.com 提供了免费试用的服务，如果只是平时学习测试的化，可以通过该网站申请免费试用

3.5快速学习

4.测试短信发送

https://next.api.aliyun.com/api/Dysmsapi/2017-05-25/SendSms?params=%7B%22RegionId%22%3A%22cn-hangzhou%22%2C%22PhoneNumbers%22%3A%2215023501990%22%2C%22SignName%22%3A%22%22%2C%22TemplateCode%22%3A%22%22%7D&sdkStyle=old

4.1、查找使用示例

4.2、测试短信发送

4.3、查看发送结果

短信服务->业务统计->发送记录查询

二、阿里云短信服务开发

在日常开发中短信服务主要应用于用户验证码获取、已经消息通知等业务。这里已用户通过手机号获取验证码注册账号为例。

验证码获取业务流程

1.基础配置

  
    
        com.aliyun
        aliyun-java-sdk-core
    

1
2
3
4
5
6

#阿里云短信
aliyun:
  sms:
    region-id: cn-hangzhou
    key-id: 你的appId
    key-secret: 你的appkey
    template-code: 你的模板id
    sign-name: 你的签名
1
2
3
4
5
6
7
8

1.这里配置类实现InitializingBean接口实现afterPropertiesSet方法，当Spring容器将regionId、keyId、keySecret等参数赋值之后，程序会调用afterPropertiesSet方法我们可以将配置的值赋值给常量，这样我们就可以通过类名.常量名去获取值了。

2.通过下面的配置我们在application.yml就可以提示我们配置类自己定义的变量，这样我们可以先定义配置类在写application.yml中的配置

配置类

@Data
@Component
@ConfigurationProperties(value = "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;
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27

Idea报告如下错误信息（不影响程序的编译和运行）：

解决方案参考文档：

controller层

    @ApiOperation("获取验证码")
    @GetMapping("/send/{mobile}")
    public R send(@ApiParam(value = "手机号码", required = true)
                  @PathVariable String mobile) {
        //手机号码不能为空
        Assert.notEmpty(mobile, ResponseEnum.MOBILE_NULL_ERROR);
        //手机号码是否合法
        Assert.isTrue(RegexValidateUtils.checkCellphone(mobile), ResponseEnum.MOBILE_ERROR);
        //手机号是否被注册过
        boolean result = coreUserInfoClient.checkMobile(mobile);
        Assert.isTrue(result==false,ResponseEnum.MOBILE_EXIST_ERROR);

        //生成验证码
        Map<String, Object> map = new HashMap<>();
        String code = RandomUtils.getFourBitRandom();
        log.info("验证码:{}",code);
        map.put("code", code);

        //发送阿里云短信验证码
        smsService.send(mobile, SmsProperties.TEMPLATE_CODE,map);
        //发送短信验证码
//        rlySmsService.send(mobile, RLYSmsProperties.TEMPLATE_ID, map);

        //将验证码存入redis中
        redisTemplate.opsForValue().set("srb:mms:code:" + mobile, code);
        return R.ok().message("获取验证码成功").data("code",code);
    }
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27

service层

发送短信的代码基本基本从demo中拷贝出来，我们只需要定义短信模板中的几个变量就可以了。

 @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);
        }
    }
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57

2. 4-6位随机生成工具类

/**
 * 生成四位和六位的随机数字
 */
public class RandomUtils {

	private static final Random random = new Random();

	private static final DecimalFormat fourdf = new DecimalFormat("0000");

	private static final DecimalFormat sixdf = new DecimalFormat("000000");

	public static String getFourBitRandom() {
		return fourdf.format(random.nextInt(10000));
	}

	public static String getSixBitRandom() {
		return sixdf.format(random.nextInt(1000000));
	}

	/**
	 * 给定数组，抽取n个数据
	 * @param list
	 * @param n
	 * @return
	 */
	public static ArrayList getRandom(List list, int n) {

		Random random = new Random();

		HashMap<Object, Object> hashMap = new HashMap<Object, Object>();

		// 生成随机数字并存入HashMap
		for (int i = 0; i < list.size(); i++) {

			int number = random.nextInt(100) + 1;

			hashMap.put(number, i);
		}

		// 从HashMap导入数组
		Object[] robjs = hashMap.values().toArray();

		ArrayList r = new ArrayList();

		// 遍历数组并打印数据
		for (int i = 0; i < n; i++) {
			r.add(list.get((int) robjs[i]));
			System.out.print(list.get((int) robjs[i]) + "\t");
		}
		System.out.print("\n");
		return r;
	}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53