📄 信息推送功能使用

概述

RemoteMessageService 是一个基于 Feign 的远程调用接口，用于实现远程消息的发送功能，包括发送短信、邮件以及自定义钩子消息。此服务主要通过 RESTful API 的形式与其他微服务进行交互。 该接口提供了以下几种消息发送功能：

-1. 发送短信
-2. 发送邮件
-3. 发送钩子（webhook）消息

定义业务编码

bizCode 是一个用于标识消息发送渠道的唯一编码，用于区分不同的消息发送渠道。在发送消息时，需要指定对应的 bizCode，以便消息服务能够正确识别消息发送渠道。

基础工具 > 信息推送 > 短信 | 邮件 | Hook 定义对应的渠道和编码

使用示例

1. 发送短信示例

@Autowired
private RemoteMessageService remoteMessageService;

public void sendSmsExample() {
    MessageSmsDTO smsDTO = MessageSmsDTO.builder()
            .mobile("13800138000")
            .biz("业务编码")
            .param("code", "123456")
            .build();
    R result = remoteMessageService.sendSms(smsDTO);
}

2. 发送邮件示例

import java.util.List;

@Autowired
private RemoteMessageService remoteMessageService;

public void sendEmailExample() {
    // 发送普通文本邮件
    MessageEmailDTO emailDTO = new MessageEmailDTO();
    emailDTO.getMailAddress().add("user@example.com");
    emailDTO.setTitle("欢迎邮件");
    emailDTO.setBody("欢迎您加入我们的平台！");
    emailDTO.setBizCode("业务编码");

    // 发送 HTML 邮件
    MessageEmailDTO emailDTO = new MessageEmailDTO();
    emailDTO.getMailAddress().add("user@example.com");
    emailDTO.setTitle("活动通知");
    emailDTO.setHtml("<p>尊敬的用户，您的优惠码是：<strong>{{code}}</strong></p>");
    emailDTO.getHtmlValues().put("code", "123456");
    emailDTO.setBizCode("业务编码");

    // 发送带附件的邮件
    MessageEmailDTO emailDTO = new MessageEmailDTO();
    emailDTO.getMailAddress().add("user@example.com");
    emailDTO.setTitle("项目报告");
    emailDTO.setBody("请查收附件中的项目报告。");
    emailDTO.getAttachmentList().add("对应【文件上传功能】 fileName");
    emailDTO.setBizCode("业务编码");
    
    R result = remoteMessageService.sendEmail(emailDTO);
}

3. 发送钩子消息示例

public void sendHookExample() {
    MessageHookDTO hookDTO = new MessageHookDTO();
    hookDTO.setBizCode("业务编码");
    hookDTO.setMessageContent("服务器 CPU 使用率超过 90%");
    hookDTO.setMessageType("text"); // text 或 markdown /link
    R result = remoteMessageService.sendHook(hookDTO);
}