sms4j v3.3.4

sms4j — делает отправку SMS более простой

ВведениеВ повседневном процессе разработки отправка SMS часто используется (особенно в небольших и средних компаниях). В конце концов, не каждая компания обладает мощью Alibaba или Tencent, и не каждая имеет внутренние процедуры отправки SMS, как у банков или компаний связи. Третьи сторонние сервисы отправки SMS являются наиболее распространенным решением. Однако на рынке существует множество поставщиков услуг отправки SMS, каждый из которых имеет свои собственные методы и стандарты. Каждый раз при использовании этих сервисов требуется время для изучения документации и написания соответствующих инструментов, что приводит к неоправданному расходу времени и усилий. Цель этого инструмента — унифицировать стандарты инструментов отправки SMS для различных поставщиков, а также сделать смену поставщика SMS простой задачей, требующей лишь изменения конфигурационного файла YAML.

Если наш проект помог вам или вам понравился, пожалуйста, помогите нам нажать кнопку "star" с вашей щедрой рукой. gitee github gitcode#### Официальная документация

JavaDoc документация## Список поддерживаемых провайдеров

• Эмей Сяоньунгун (внутренние SMS)
• Алибаба Облако (внутренние SMS)
• Тенгцун Облако (внутренние SMS)
• Хуавей Облако (внутренние SMS)
• Диандун Облако (внутренние SMS)
• Юньтонгсюнь Облако (внутренние SMS)
• Юйней Сяоньунгун (SMS)
• Тяньйи Облако (SMS)
• Чицун Облако (SMS)
• Юйси SMS
• Юньпьян SMS
• Цзутун SMS
• Лянлу SMS
• Диньчун SMS
• Чуанлан SMS
• Джигуан SMS
• Будинь Облако (SMS)
• Китайская мобильная сеть (облачные SMS)
• Луосимао SMS
• Субмейл SMS
• Данми Технологии SMS## Интеграция в SpringBoot окружение

1. Введение зависимости через Maven

   <dependency>
    <groupId>org.dromara.sms4j</groupId>
    <artifactId>sms4j-spring-boot-starter</artifactId>
    <version>последняя версия</version>
   </dependency>
   ```2. Настройка конфигурационного файла   ```yaml
    sms:
       config-type: yaml
       blends:
           customIdentifier1:
             # accessKey для Aliyun
             accessKeyId: ваш accessKey
             # accessKeySecret для Aliyun
             accessKeySecret: ваш accessKeySecret
             # подпись для SMS
             signature: тестовая подпись
             # ID шаблона для отправки SMS с фиксированным шаблоном
             templateId: SMS_215125134
             # имя шаблона для вышеупомянутого шаблона
             templateName: код
             # URL запроса по умолчанию dysmsapi. aliyuncs. com, если нет специальных изменений, настройка не требуется
             requestUrl: dysmsapi. aliyuncs. com
           customIdentifier2:
             # appKey для SMS Huawei
             appKey: 5N6fvXXXX920HaWhVXXXXXX7fYa
             # appSecret для SMS Huawei
             app-secret: Wujt7EYzZTBXXXXXXEhSP6XXXX
             # подпись для SMS
             signature: тестовая подпись для SMS Huawei
             # номер отправителя
             sender: 8823040504797
             # ID шаблона, если используется метод отправки с пользовательским шаблоном, настройка не требуется
             template-id: acXXXXXXXXc274b2a8263479b954c1ab5
             # URL обратного вызова Huawei, если не требуется, настройка не требуется или может быть пустой
             statusCallBack:
             # URL запроса для приложения Huawei
             url: https://XXXXX. cn-north-4. XXXXXXXX. com:443
           customIdentifier3:
             # SMS Zhtong
             # имя пользователя для управления пользователями Zhtong, username обязательно; пароль пользователя, не используемый для входа, проверьте на странице управления: https://mix2. zthysms. com/login
             accessKeyId: tusxxxxxxXXX
             # пароль пользователя для управления пользователями Zhtong, обязательно;
             accessKeySecret: UbXXXxxx

           signature: описание для SMS Shanghai QianXXXX
  ```3. Использование методов

```java
@RestController
@RequestMapping("/test/")
public class DemoController {
```    // Тест отправки фиксированного шаблона SMS
  @RequestMapping("/")
  public void send() {
       //АлиБаба отправляет SMS на этот номер телефона
      SmsFactory.getSmsBlend("Собственный идентификатор 1").sendMessage("18888888888", "123456");
      //Huawei отправляет SMS на этот номер телефона
      SmsFactory.getSmsBlend("Собственный идентификатор 2").sendMessage("16666666666", "000000");
  }
}

Подробное описание конфигурации

Конфигурация пула потоков

Каждый поставщик поддерживает асинхронную отправку SMS по-своему, некоторые даже не поддерживают её. Чтобы обеспечить единообразие асинхронной отправки SMS, мы настроили пул потоков для выполнения задач асинхронной отправки SMS. По умолчанию конфигурация пула потоков выглядит следующим образом:

sms:
  # Размер основного пула потоков
  corePoolSize: 10
  # Максимальное количество потоков
  maxPoolSize: 30
  # Размер очереди
  queueCapacity: 50
  # Время активности
  keepAliveSeconds: 60
  # Префикс имени потока
  threadNamePrefix: sms-executor-
  # Установка стратегии закрытия пула потоков, чтобы при закрытии пула потоков ожидать завершения всех задач перед закрытием других Bean
  shutdownStrategy: true

Вышеуказанная конфигурация пула потоков является по умолчанию. Если необходимо, можно настроить её в соответствии со своими требованиями в файле yml.## Участие в проекте

1.  Fork этого репозитория
2.  Создать ветку Feat_xxx
3.  Отправить код
4.  Создать Pull Request в ветку dev-3.0.x

Правила участия

• Мы принципиально приветствуем любые вклады в проект sms4j
• Вклады должны быть сопровождены полными комментариями, соответствующими стандартам JavaDoc для классов, методов, переменных, параметров и значений возврата
• При добавлении нового поставщика SMS необходимо также добавить документацию для этого поставщика в формате MD
• Добавленные методы не должны нарушать существующую структуру и совместимость
• Если мы закрываем ваш запрос issues или PR, пожалуйста, проверьте ответ, мы объясним причины в ответе