springboot 集成 osgi springboot 集成钉钉

文章目录

• 一、全局异常处理

• 1、自定义业务异常类
• 2、全局异常处理类

• 二、配置钉钉机器人

• 1、创建钉钉机器人

• 三、整合钉钉机器人

• 1、引入jar包
• 2、发送信息的工具类
• 3、测试
• 4、常见报错

• 四、所用到的工具类

一、全局异常处理

1、自定义业务异常类

某些时候,由于业务逻辑需要抛出自定义异常，这个时候就需要自定义业务异常类。
定义CommonException,使他继承于RuntimeException.

说明：因为某些业务需要进行业务回滚。但spring的事务只针对RuntimeException的进行回滚操作。所以需要回滚就要继承RuntimeException。

public class CommonException extends RuntimeException {

    private Integer errCode;

    private String errMsg;

    public Integer getErrCode() {
        return errCode;
    }

    public void setErrCode(Integer errCode) {
        this.errCode = errCode;
    }

    public String getErrMsg() {
        return errMsg;
    }

    public void setErrMsg(String errMsg) {
        this.errMsg = errMsg;
    }

    public CommonException(Integer errCode, String errMsg) {
        this.errCode = errCode;
        this.errMsg = errMsg;
    }

    public CommonException(String errMsg, Throwable e) {
        super(errMsg);
        this.errMsg = errMsg;
    }
}

2、全局异常处理类

import com.adleading.daJinMember.common.constant.CodeMsg;
import com.adleading.daJinMember.common.constant.Result;
import com.adleading.daJinMember.common.utils.GlobalUtils;
import com.taobao.api.ApiException;
import lombok.extern.slf4j.Slf4j;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.http.HttpStatus;
import org.springframework.http.converter.HttpMessageNotReadableException;
import org.springframework.stereotype.Component;
import org.springframework.web.bind.annotation.ControllerAdvice;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.ResponseBody;
import org.springframework.web.bind.annotation.ResponseStatus;

@ControllerAdvice
@Component
@Slf4j
public class CommonExceptionHandler {

    @Autowired
    private GlobalUtils globalUtils;

    @ExceptionHandler
    @ResponseBody
    @ResponseStatus(HttpStatus.OK)
    public Result handle(Exception exception) throws ApiException {
        if (exception instanceof CommonException) {
            log.error(exception.getMessage(), exception);
            CommonException e = (CommonException) exception;
            log.error("捕获到异常,异常代码为{},异常信息为{}", e.getErrCode(), e.getErrMsg());
            //发送异常信息到钉钉机器人
            globalUtils.globalMsg(exception);
            return Result.error(new CodeMsg(Integer.valueOf(e.getErrCode()), e.getErrMsg()));
        } else if (exception instanceof HttpMessageNotReadableException) {
            log.error("前台传入JSON格式错误");
            //发送异常信息到钉钉机器人
            globalUtils.globalMsg(exception);
            return Result.error(CodeMsg.JSON_ERR);
        } else {
            //发送异常信息到钉钉机器人
            globalUtils.globalMsg(exception);
            log.error("捕获到异常错误");
            return Result.error(CodeMsg.FILES);
        }
    }
}

注意：这里用到的一些工具类，会在文章的结尾处贴出来。

二、配置钉钉机器人

这里给大家简单说了一下如何创建钉钉机器人，如果想深入了解的，点击传送门到官方文档处。

1、创建钉钉机器人

• 点击左下角更多选择机器人管理



• 然后选择自定义

• 添加机器人

1、输入机器人名字并选择要发送消息的群
2、完成必要的安全设置（至少选择一种，博主这里选择了打 √ 的两个）
3、当选择了自定义关键词的时候，在发送报警信息的时候一定要带上关键词。(后面代码演示会指出)

• 完成设置后，复制出机器人的Webhook地址，可用于向这个群发送消息，格式如下：

https://oapi.dingtalk.com/robot/send?access_token=XXXXXX

三、整合钉钉机器人

1、引入jar包

<dependency>
    <groupId>com.aliyun</groupId>
    <artifactId>alibaba-dingtalk-service-sdk</artifactId>
    <version>1.0.1</version>
</dependency>

2、发送信息的工具类

当前自定义机器人支持文本 (text)、链接 (link)、markdown(markdown)、ActionCard、FeedCard消息类型。这里就只演示文本 (text)消息类型。

3、测试

1. Controller层

@Resource
    private TestService testService;

    @GetMapping("/test")
    public Result Test() {
        testService.test();
        return new Result(CodeMsg.SUCCESS);
    }

2.Service层

@Service
public class TestServiceImpl implements TestService {


    @Override
    public void test() {
        int i = 1 / 0;
    }
}

3. 测试结果如下
   
   

4、常见报错

// 消息内容中不包含任何关键词
{
  "errcode":310000,
  "errmsg":"keywords not in content"
}

// timestamp 无效
{
  "errcode":310000,
  "errmsg":"invalid timestamp"
}

// 签名不匹配
{
  "errcode":310000,
  "errmsg":"sign not match"
}

// IP地址不在白名单
{
  "errcode":310000,
  "errmsg":"ip X.X.X.X not in whitelist"
}

四、所用到的工具类

• CodeMsg类

public class CodeMsg {
    private int code;
    private String msg;

    public CodeMsg(int code, String msg) {
        this.code = code;
        this.msg = msg;
    }

    public CodeMsg() {
    }

    public int getCode() {
        return code;
    }

    public void setCode(int code) {
        this.code = code;
    }

    public String getMsg() {
        return msg;
    }

    public void setMsg(String msg) {
        this.msg = msg;
    }

    public static CodeMsg SUCCESS = new CodeMsg(200, "success");

    public static CodeMsg FILES = new CodeMsg(300, "未知错误");
    public static CodeMsg JSON_ERR = new CodeMsg(300, "JSON格式错误");

}

• Result类

@ApiModel(value = "响应结果")
public class Result<T> {

    @ApiModelProperty(position = 0, value = "状态码", required = true, example = "200200")
    private int code;

    @ApiModelProperty(position = 1, value = "响应信息", required = true, example = "success")
    private String msg;

    @ApiModelProperty(position = 2, value = "响应数据", required = true)
    private T data;

    public int getCode() {
        return code;
    }

    public void setCode(int code) {
        this.code = code;
    }

    public String getMsg() {
        return msg;
    }

    public void setMsg(String msg) {
        this.msg = msg;
    }

    public T getData() {
        return data;
    }

    public void setData(T data) {
        this.data = data;
    }

    /**
     *      *  成功时候的调用
     *      *
     */
    public static <T> Result<T> success(T data) {
        return new Result<T>(data);
    }

    /**
     *      *  失败时候的调用
     *      *
     */
    public static <T> Result<T> error(CodeMsg codeMsg) {
        return new Result<T>(codeMsg);
    }


    /**
     *      * 成功的构造函数
     *      * @param data
     *     
     */
    private Result(T data) {
        this.code = 000000;//默认000000是成功
        this.msg = "SUCCESS";
        this.data = data;
    }

    public Result(int code, String msg) {
        this.code = code;
        this.msg = msg;
    }

    public Result(int code, String msg, T data) {
        this.code = code;
        this.msg = msg;
        this.data = data;
    }

    public Result(CodeMsg codeMsg, T data) {
        this.code = codeMsg.getCode();
        this.msg = codeMsg.getMsg();
        this.data = data;
    }

    /**
     *      * 失败的构造函数
     *      * @param code
     *      * @param msg
     *     
     */
    public Result(CodeMsg codeMsg) {
        if (codeMsg != null) {
            this.code = codeMsg.getCode();
            this.msg = codeMsg.getMsg();
        }
    }
}

• GlobalUtils类

@Component
public class GlobalUtils {

    @Autowired
    private DingTalkUtils dingTalkUtils;

    public void globalMsg(Exception exception) throws ApiException {
        StringWriter sw = new StringWriter();
        PrintWriter pw = new PrintWriter(sw, true);
        exception.printStackTrace(pw);
        String stackTraceString = sw.getBuffer().toString();
        dingTalkUtils.sendMsg(stackTraceString);
    }
}