java发送通知——详解调用钉钉机器人

引言

在开发中,有的场景会需要有一些及时的通知。比如,微信退款失败需要通知,微信支付失败需要通知等。

常见的通知有如下几种:

1. 短信通知
通过第三方短信平台,发送消息到手机上。常见的场景为发送短信验证码。
优点:利用短信平台,优点在于能及时让接收者知道消息。
缺点:占用短信平台的资源,只适用于紧急情况下通知,不可出现高并发高秒杀的通知。

一般第三方的短信平台都是走restful接口。博主在这里只想强调一个坑,就是发送短信的内容一定要带上第三方的开头!!如:【范团】。缺少了这个抬头,会被三大运营商拦截的,会造成第三方会返回发送成功,而实际上收不到短信的假象!

 String content = "【范团】您此次的验证码为:" + code + ",请在10分钟内填写。若非本人操作,请忽略本短信。";

2. email通知
通过发动邮件email,通知到对方的邮箱上。常见的场景为注册或成功购买物品后给对方邮箱发送邮件。
优点:可以支持高并发
缺点:通知不够及时,对方不一定第一时间查阅邮件;同时有可能被邮箱服务商当成垃圾邮件进行拦截。

需要发送邮件的,可以参考博主的另外一篇博文:
https://www.jianshu.com/p/0c2ceece3ce6

3.第三方聊天工具通知
通过常见的聊天工具,比如钉钉、微信即时通讯工具进行发送消息。用钉钉发送消息,这是本文主要讲解的内容。

  1. 先找到机器人位置


    图1.群设置
图2.群机器人
图3.添加自定义机器人
  1. 参考钉钉的官网:
    https://open-doc.dingtalk.com/docs/doc.htm?spm=a219a.7629140.0.0.274b4a97rhqvpC&treeId=257&articleId=105735&docType=1

在最下方可以下载java版本的SDK。下载好官方的demo,本质上只需要使用其中的Message和TextMessage即可,利用他们帮我们生成好消息的格式。我们只需要自己实现http请求。博主用到的官方代码如下:

public interface Message {

    /**
     * 返回消息的Json格式字符串
     *
     * @return 消息的Json格式字符串
     */
    String toJsonString();
}

public class TextMessage implements Message {

    private String text;
    private List<String> atMobiles;
    private boolean isAtAll;

    public TextMessage(String text) {
        this.text = text;
    }

    public String getText() {
        return text;
    }

    public void setText(String text) {
        this.text = text;
    }

    public List<String> getAtMobiles() {
        return atMobiles;
    }

    public void setAtMobiles(List<String> atMobiles) {
        this.atMobiles = atMobiles;
    }

    public boolean isAtAll() {
        return isAtAll;
    }

    public void setIsAtAll(boolean isAtAll) {
        this.isAtAll = isAtAll;
    }

    @Override
    public String toJsonString() {
        Map<String, Object> items = new HashMap<String, Object>();
        items.put("msgtype", "text");

        Map<String, String> textContent = new HashMap<String, String>();
        if (StringUtils.isBlank(text)) {
            throw new IllegalArgumentException("text should not be blank");
        }
        textContent.put("content", text);
        items.put("text", textContent);

        Map<String, Object> atItems = new HashMap<String, Object>();
        if (atMobiles != null && !atMobiles.isEmpty()) {
            atItems.put("atMobiles", atMobiles);
        }
        if (isAtAll) {
            atItems.put("isAtAll", isAtAll);
        }
        items.put("at", atItems);

        return JsonUtil.mapToJson(items);
    }
}

调用的时候只要new TextMessage(content) 得到TextMessage 对象,调用其toJsonString方法,并通过http请求带到钉钉机器人的地址即可。


钉钉机器人.png

最后总结下优缺点
优点:能较为及时地送达警告。
缺点:发送有上限。

官方给出关于发送的上限:
消息发送频率限制
每个机器人每分钟最多发送20条。
消息发送太频繁会严重影响群成员的使用体验,大量发消息的场景(譬如系统监控报警)可以将这些信息进行整合,通过markdown消息以摘要的形式发送到群里。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 216,240评论 6 498
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 92,328评论 3 392
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 162,182评论 0 353
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 58,121评论 1 292
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 67,135评论 6 388
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 51,093评论 1 295
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 40,013评论 3 417
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,854评论 0 273
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 45,295评论 1 310
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,513评论 2 332
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,678评论 1 348
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,398评论 5 343
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,989评论 3 325
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,636评论 0 22
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,801评论 1 268
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 47,657评论 2 368
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,558评论 2 352

推荐阅读更多精彩内容