dingtalk-spring-boot-starter

SpringBoot集成钉钉机器人实现消息通知中间件

License

License

Categories

Categories

Spring Boot Container Microservices
GroupId

GroupId

com.github.answerail
ArtifactId

ArtifactId

dingtalk-spring-boot-starter
Last Version

Last Version

3.1.2-RELEASE
Release Date

Release Date

Type

Type

jar
Description

Description

dingtalk-spring-boot-starter
SpringBoot集成钉钉机器人实现消息通知中间件
Project URL

Project URL

https://github.com/AnswerAIL/dingtalk-spring-boot-starter
Source Code Management

Source Code Management

https://github.com/AnswerAIL/dingtalk-spring-boot-starter/tree/master

Download dingtalk-spring-boot-starter

How to add to project

<!-- https://jarcasting.com/artifacts/com.github.answerail/dingtalk-spring-boot-starter/ -->
<dependency>
    <groupId>com.github.answerail</groupId>
    <artifactId>dingtalk-spring-boot-starter</artifactId>
    <version>3.1.2-RELEASE</version>
</dependency>
// https://jarcasting.com/artifacts/com.github.answerail/dingtalk-spring-boot-starter/
implementation 'com.github.answerail:dingtalk-spring-boot-starter:3.1.2-RELEASE'
// https://jarcasting.com/artifacts/com.github.answerail/dingtalk-spring-boot-starter/
implementation ("com.github.answerail:dingtalk-spring-boot-starter:3.1.2-RELEASE")
'com.github.answerail:dingtalk-spring-boot-starter:jar:3.1.2-RELEASE'
<dependency org="com.github.answerail" name="dingtalk-spring-boot-starter" rev="3.1.2-RELEASE">
  <artifact name="dingtalk-spring-boot-starter" type="jar" />
</dependency>
@Grapes(
@Grab(group='com.github.answerail', module='dingtalk-spring-boot-starter', version='3.1.2-RELEASE')
)
libraryDependencies += "com.github.answerail" % "dingtalk-spring-boot-starter" % "3.1.2-RELEASE"
[com.github.answerail/dingtalk-spring-boot-starter "3.1.2-RELEASE"]

Dependencies

compile (1)

Group / Artifact Type Version
com.squareup.okhttp3 : okhttp jar 4.9.0

provided (5)

Group / Artifact Type Version
org.projectlombok : lombok jar 1.18.10
org.springframework.boot : spring-boot-configuration-processor Optional jar 2.1.5.RELEASE
org.springframework.boot : spring-boot-autoconfigure jar 2.1.5.RELEASE
com.fasterxml.jackson.core : jackson-databind jar 2.11.3
org.slf4j : slf4j-api jar 1.7.30

Project Modules

There are no modules declared in this project.

Dinger(叮鸽) GitHub license

Dinger Logo

Maven Central GitHub stars Gitee stars JDK SpringBoot

 

What(Dinger是什么)

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

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

 

Why(为什么用Dinger)

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

 

如果觉得项目对您的工作有帮助的话, 欢迎GithubGitee加星关注哈~

 

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

引入依赖

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

dinger.version版本号取值

配置文件配置

使用钉钉群机器人配置

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

代码中使用

@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 OR Gitee Dinger wiki

 

Documentation, Getting Started and Developer Guides

 

Upgrade Log

 

Feedback

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


 

Versions

Version
3.1.2-RELEASE
3.1.1-RELEASE
3.1.0-RELEASE
3.0.1-SP1
3.0.0-RELEASE
3.0.0-SP1
2.0.6-RELEASE
2.0.5-RELEASE
2.0.4-RELEASE
2.0.3-RELEASE
2.0.3-beta3
2.0.3-beta2
2.0.3-beta1
2.0.2-RELEASE
2.0.1-RELEASE
2.0.0-RELEASE
1.0.5-RELEASE
1.0.4-RELEASE
1.0.3-RELEASE
1.0.2-RELEASE
1.0.1-RELEASE