init

sl-express-ms-sms-api/.gitignore

@@ -0,0 +1,3 @@
+.idea
+target/
+*.iml

sl-express-ms-sms-api/README.md

@@ -0,0 +1,62 @@
+# sl-express-ms-sms-api使用手册
+
+## 1、说明
+
+为了将短信相关的代码进行统一，所以将发送短信的代码抽取到sl-express-ms-sms-service中，而sl-express-ms-sms-api提供了短信服务的功能。
+
+主要功能：
+
+- 短信（短信验证码，通知短信）发送功能，支持同时发送多个短信验证码，暂时支持文字短信验证码
+
+## 2、使用
+
+### 2.1、导入依赖
+
+~~~xml
+<dependency>
+    <groupId>com.sl-express.ms.sms</groupId>
+    <artifactId>sl-express-ms-sms-api</artifactId>
+    <version>1.1-SNAPSHOT</version>
+</dependency>
+~~~
+
+### 2.2、使用
+
+~~~java
+package com.sl.ms.work.service;
+
+import cn.hutool.core.collection.ListUtil;
+import com.sl.ms.sms.SmsFeign;
+import com.sl.ms.sms.dto.SendResultDTO;
+import com.sl.ms.sms.dto.SmsInfoDTO;
+import com.sl.ms.sms.enums.SmsContentTypeEnum;
+import com.sl.ms.sms.enums.SmsTypeEnum;
+import org.junit.jupiter.api.Test;
+import org.springframework.boot.test.context.SpringBootTest;
+
+import javax.annotation.Resource;
+import java.util.List;
+
+@SpringBootTest
+public class SmsTest {
+
+    @Resource
+    private SmsFeign smsFeign;
+
+    @Test
+    public void testSend(){
+        SmsInfoDTO smsInfoDTO = SmsInfoDTO.builder()
+                .appName("sl-express-ms-work")
+                .smsContent("测试短信")
+                .contentType(SmsContentTypeEnum.WORD_MESSAGE)
+                .smsType(SmsTypeEnum.VERIFY)
+                .mobiles(ListUtil.of("13888888888"))
+                .smsCode("1001")
+                .build();
+        List<SendResultDTO> resultDTOS = this.smsFeign.send(smsInfoDTO);
+        resultDTOS.forEach(System.out::println);
+    }
+
+}
+
+~~~

sl-express-ms-sms-api/pom.xml

@@ -0,0 +1,41 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0"
+         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <modelVersion>4.0.0</modelVersion>
+
+    <parent>
+        <groupId>com.sl-express</groupId>
+        <artifactId>sl-express-parent</artifactId>
+        <version>1.4</version>
+    </parent>
+
+    <groupId>com.sl-express.ms.sms</groupId>
+    <artifactId>sl-express-ms-sms-api</artifactId>
+    <version>1.1-SNAPSHOT</version>
+    <description>短信微服务-Feign接口</description>
+
+    <properties>
+        <maven.compiler.source>11</maven.compiler.source>
+        <maven.compiler.target>11</maven.compiler.target>
+        <sl-express-common.version>1.2-SNAPSHOT</sl-express-common.version>
+    </properties>
+
+    <dependencies>
+        <dependency>
+            <groupId>com.sl-express.common</groupId>
+            <artifactId>sl-express-common</artifactId>
+            <version>${sl-express-common.version}</version>
+        </dependency>
+        <dependency>
+            <groupId>com.sl-express.ms.sms</groupId>
+            <artifactId>sl-express-ms-sms-domain</artifactId>
+            <version>1.1-SNAPSHOT</version>
+        </dependency>
+        <dependency>
+            <groupId>org.springframework.cloud</groupId>
+            <artifactId>spring-cloud-starter-openfeign</artifactId>
+        </dependency>
+    </dependencies>
+
+</project>

sl-express-ms-sms-api/src/main/java/com/sl/ms/sms/SmsFeign.java

@@ -0,0 +1,24 @@
+package com.sl.ms.sms;
+
+import com.sl.ms.sms.dto.SendResultDTO;
+import com.sl.ms.sms.dto.SmsInfoDTO;
+import org.springframework.cloud.openfeign.FeignClient;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import springfox.documentation.annotations.ApiIgnore;
+
+import java.util.List;
+
+@ApiIgnore
+@FeignClient(name = "sl-express-ms-sms", contextId = "Sms", path = "sms")
+public interface SmsFeign {
+
+    /**
+     * 短信发送接口，可以同时发送给多个手机号码，多个手机号用逗号隔开
+     *
+     * @param smsInfoDTO
+     * @return
+     */
+    @PostMapping("send")
+    List<SendResultDTO> send(@RequestBody SmsInfoDTO smsInfoDTO);
+}