Skip to content

AnswerAIL/dingtalk-spring-boot-starter

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 

Repository files navigation

Dinger(叮鸽) GitHub license

Dinger Logo

Maven Central GitHub stars Gitee stars JDK SpringBoot

 

What(Dinger是什么)

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

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

 


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版本号取值GithubGitee

 

二、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

 

Upgrade Log

 

Feedback

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