Dinger(叮鸽)

 

What(Dinger是什么)

Dinger是一个以SpringBoot框架为基础开发的消息发送中间件， 对如下移动办公系统的群机器人API做了一层封装，让使用更简单便捷。

• 钉钉
• 企业微信
• 飞书

只需要简单的配置（最简单的发送功能只需要一行代码），即可快速的在springboot项目中将消息发送到指定的钉钉或企业微信群聊中。

• Dinger在线文档

• Dinger QQ交流群： 1002507383

 

---

Why(为什么用Dinger)

• 配置简单，上手容易，无需花费太多精力在群机器人API的使用上；
• 插拔式功能组件，和业务代码解耦；
• 核心功能面向接口编程, 可以据具体业务对功能进行定制化来满足不同的业务需求；
• 支持集中式管理消息，提供xml标签，支持编写动态消息体；
• 基于具体消息编程，消息体可支持XML标签方式配置和注解方式定义；
• 支持钉钉、企业微信、飞书群机器人一键切换使用和混合使用；

 

支持Dinger

★ 欢迎『Github』 或 『Gitee』点下Star让更多码友知道Dinger的存在

❤ Gitee捐赠: 如果觉得Dinger不错, 条件允许的话捐赠杯奶茶犒劳下维护者, 感谢您的支持和鼓励^_^。

 

---

How(如何使用Dinger-快速使用)

一、引入依赖

<dependency>
    <groupId>com.github.answerail</groupId>
    <artifactId>dinger-spring-boot-starter</artifactId>
    <version>${dinger.version}</version>
</dependency>

dinger.version版本号取值 ☞ Github 或 Gitee

 

二、application.yml 配置

使用钉钉群机器人配置

spring:
  dinger:
    project-id: ${spring.application.name}
    dingers:
      # 使用钉钉机器人, 请根据自己机器人配置信息进行修改
      dingtalk:
        tokenId: 87dbeb7bc28894c3ycyl3d12457228ad309966275b5f427cd85f9025ebb520cf
        secret: AEQ74a9039ai01f2ljm017b90ycye9asg6335f97c658ff37ff371ec8120581c7f09

使用企业微信群机器人配置

spring:
  dinger:
    project-id: ${spring.application.name}
    dingers:
      # 使用企业微信机器人, 请根据自己机器人配置信息进行修改
      wetalk:
        token-id: 32865206-7082-46l5-8j39-2m7ycy6d868

使用飞书群机器人配置

spring:
  dinger:
    project-id: ${spring.application.name}
    dingers:
      # 使用飞书机器人, 请根据自己机器人配置信息进行修改
      bytetalk:
        token-id: 20200528-0824-20jm-21hy-5yc556210y15

 

三、代码中使用

@Component
public class AppInit implements InitializingBean {
    @Autowired
    private DingerSender dingerSender;
    @Override
    public void afterPropertiesSet() throws Exception {
        // 发送text类型消息
        dingerSender.send(
                MessageSubType.TEXT,
                DingerRequest.request("Hello World, Hello Dinger")
        );

        // 发送markdown类型消息
        dingerSender.send(
                MessageSubType.MARKDOWN,
                DingerRequest.request("Hello World, Hello Dinger", "启动通知")
        );
    }
}

更多功能请移步 『Github Dinger wiki』 或 『Gitee Dinger wiki』

 

Documentation, Getting Started and Developer Guides

• Dinger在线文档

• Dinger Wiki-Github

• Dinger Wiki-Gitee

 

Upgrade Log

• 版本变更日志-Github

• 版本变更日志-Gitee

 

Feedback

✍ 有任何建议或问题欢迎提Issue~

• Issues-Github

• Issues-Gitee

---

 

网友提问

欢迎大家踊跃投稿 DingerConfigHandler中支持@Autowire注解来注入bean对象 在springboot中配置了参数，但是注入失败了 后续是否会支持文件消息 后续是否会支持文件消息 动态@一个或者多个用户该如何实现？ 消息会同时发送两次 toeknId 在哪里获取 在使用@DingerText注解的发送方式下，如何动态配置phones属性值？ 如何@机器人，根据内容机器人主动回复 wiki2.3章节动态配置机器人，可以同时配置多个钉钉机器人吗？ 要如何配置 是否支持动态指定一个钉钉或者微信机器人配置发送消息，现有配置无法支持从数据库中读取出配置，然后选择发送