houzhongjian
2024-10-16 7da8f196dee8e3c526c009a4bc7f5983ece6bb97
提交 | 用户 | 时间
e7c126 1 package com.iailab.module.system.service.sms;
H 2
3 import com.iailab.framework.common.exception.ServiceException;
4 import com.iailab.module.system.api.sms.dto.code.SmsCodeSendReqDTO;
5 import com.iailab.module.system.api.sms.dto.code.SmsCodeUseReqDTO;
6 import com.iailab.module.system.api.sms.dto.code.SmsCodeValidateReqDTO;
7
8 import javax.validation.Valid;
9
10 /**
11  * 短信验证码 Service 接口
12  *
13  * @author iailab
14  */
15 public interface SmsCodeService {
16
17     /**
18      * 创建短信验证码,并进行发送
19      *
20      * @param reqDTO 发送请求
21      */
22     void sendSmsCode(@Valid SmsCodeSendReqDTO reqDTO);
23
24     /**
25      * 验证短信验证码,并进行使用
26      * 如果正确,则将验证码标记成已使用
27      * 如果错误,则抛出 {@link ServiceException} 异常
28      *
29      * @param reqDTO 使用请求
30      */
31     void useSmsCode(@Valid SmsCodeUseReqDTO reqDTO);
32
33     /**
34      * 检查验证码是否有效
35      *
36      * @param reqDTO 校验请求
37      */
38     void validateSmsCode(@Valid SmsCodeValidateReqDTO reqDTO);
39
40 }