点击上方"IT牧场",选择"设为星标"
技术干货每日送达!
我们常常会遇到向钉钉群中发送消息的需求,所以我开源了一个钉钉群消息助手。
瓦力
瓦力是一个轻量级的钉钉群消息发送助手,通过瓦力你只需要配置一个发送消息的模板(支持多个地址,且可以在运行时动态修改),即可快速实现钉钉群消息的发送功能。
项目地址:
http://github.com/all4you/walle
特性
模板管理: 群消息模板管理,目前支持 TEXT、MARKDOWN、LINK 三种类型群消息
多群匹配: 同一个模板支持同时发送至多个钉钉群,且支持条件表达式进行群路由
JWT凭证管理: 通过 JWT 进行用户凭证的管理
开放接口: 对外暴露 REST 接口供用户触发群消息
扩展点: 面向接口设计,用户可自行实现各个扩展点
快速开始
首先我们需要先部署项目。
项目部署成功之后,接着创建账号和模板。
账号和模板都创建好之后,就可以进行接口调用了。
部署项目
下载项目
clone http://github.com/all4you/walle
打包项目
cd walle
打包时跳过测试:
mvn clean --DskipTests package
打好的包在这个目录:
./walle-core/target/walle-core-0.0.1.jar
启动项目
打包好之后可以直接通过命令行启动:
java -jar ./walle-core/target/walle-core-0.0.1.jar
或者也可以直接通过 mvn 指令启动项目:
cd walle-core
数据库资源
创建相应的数据库,并将表结构创建好。
具体的脚本在: walle/walle-core/src/resources/sql/tables.sql
需要注意的是,创建的数据库账号密码要和 application.properties 文件中保持一致。
前端资源
该项目对应的前端页面是通过 vue 实现的,对应的前端项目是 walle-web
修改页面之后需要将最新的资源打包后拷贝到 walle 的资源目录
1.打包
# 构建生产环境
2.资源拷贝
打包好的资源在 dist/ 目录下,将该目录下的所有文件都拷贝到 walle 的资源目录下:
rm -rf ~/walle/walle-core/src/main/resources/static/*
cp -R dist/* ~/walle/walle-core/src/main/resources/static/