# ex

**Repository Path**: xiaoting09/ex

## Basic Information

- **Project Name**: ex
- **Description**: java WEB异常处理框架,客户端只需要简单配置一下filter,即可接入,功能点1、异常发生时异步发送报警邮箱  钉钉消息2、简单的异常发生数据统计
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: http://ex.xiaoting.link/
- **GVP Project**: No

## Statistics

- **Stars**: 70
- **Forks**: 15
- **Created**: 2017-10-19
- **Last Updated**: 2025-06-26

## Categories & Tags

**Categories**: webframework

**Tags**: None

## README

## ex
java WEB异常处理框架,客户端只需要简单配置一下filter,即可接入,无任何依赖

主要功能点

1、异常发生时异步发送报警邮箱,钉钉

2、简单的异常发生数据统计


## 测试地址：http://ex.xiaoting.link/

## 如果有兴趣的朋友可以按照以下步骤进行打包(需要安装gradle环境)：

1.进入ex-spring-client、ex-web-client、ex-core目录，执行
```
   gradle clean install
```
  进入 ex-web项目下执行
```
    gradle clean build -x test
```

2.在命令行输入java -jar ex-web-1.0.0-SNAPSHOT.jar 数据库IP 数据库用户名 密码  


3.
```
gradle:  
compile group: 'com.xiao.ex', name: 'ex-spring-client', version: '1.0.0-SNAPSHOT'

maven:
<dependency>
  <groupId>com.xiao.ex</groupId>
  <artifactId>ex-spring-client</artifactId>
  <version>1.0.0-SNAPSHOT</version>
</dependency>
```


并按照下面的步骤配置Filter(如果不想自己运行web模块,可以配置到Demo里面IP地址)





## 普通的Web项目接入步骤

1.修改ex-web模块中的application.properties中的数据库配置 rmi.registry.port(注册端口),rmi.service.port(通讯端口)号配置

2.发送的邮件服务器配置可以在ex-web模块修改application.properties中修改,也可以在平台上的配置消息模块中修改对应的key名分别是mail.host, mail.port, mail.username, mail.password

3.将ex-web模块打成jar包单独执行,也可以打成war包放在容器中

4.在web.xml文件中配置filter,初始化参数也可以在config.properties中配置key名相同



## Filter 配置:

    包名:com.xiao.ex.filter.ExFilter,
     init-param中配置:
     rmi.host(ex-web模块的服务器ip地址)，
     rmi.port(注册端口),
     http.port 服务器地址 (与rmi.host,rmi.port二选一)
     time(单位是毫秒,异常间隔上传时间，其中host和port是必传值,time默认十分钟上报一次异常,

## 普通的Web项目接入Demo:

```
    <filter>
        <filter-name>exFilter</filter-name>
        <filter-class>com.xiao.ex.filter.ExFilter</filter-class>
        <init-param>
            <param-name>rmi.host</param-name>
            <param-value>119.23.239.186</param-value>
        </init-param>
        <init-param>
            <param-name>rmi.port</param-name>
            <param-value>8886</param-value>
        </init-param>
        <init-param>
            <param-name>time</param-name>
            <param-value>1000</param-value>
        </init-param>
    </filter>
    <filter-mapping>
        <filter-name>exFilter</filter-name>
        <url-pattern>/*</url-pattern>
    </filter-mapping>

```
## SpringBoot接入步骤

1.修改ex-web模块中的application.properties中的数据库配置 rmi.registry.port(注册端口),rmi.service.port(通讯端口)号配置

2.发送的邮件服务器配置可以在修改ex-web模块application.properties中修改,也可以在平台上的配置消息模块中修改对应的key名分别是mail.host, mail.port, mail.username, mail.password

3.将ex-web模块打成jar包单独执行,也可以打成war包放在容器中

4.引入ex-spring-client.jar包，并声明AExceptionHandler bean,在application.properties中写入rmi.port(web模块的注册端口),rmi.host(web模块的IP地址),rmi.time(上报时间单位毫秒)



## SpringBoot接入Demo:
```
    @Bean
    public AExceptionHandler masterTransactionManager() {
        return new AExceptionHandler();
    }

```


## Spring 接入步骤

1.修改ex-web模块中的application.properties中的数据库配置 rmi.registry.port(注册端口),rmi.service.port(通讯端口)号配置

2.发送的邮件服务器配置可以在修改ex-web模块application.properties中修改,也可以在平台上的配置消息模块中修改对应的key名分别是mail.host, mail.port, mail.username, mail.password

3.将ex-web模块打成jar包单独执行,也可以打成war包放在容器中

4.引入ex-spring-client.jar包，并声明MyExceptionHandler bean,在application.properties中写入rmi.port(web模块的注册端口),rmi.host(web模块的IP地址),rmi.time(上报时间单位毫秒)



## Spring  接入Demo:
```
   <bean class="com.xiao.ex.handler.AExceptionHandler">
       <property name="rmiHost" value="119.23.239.186"/>
       <property name="port" value="8886"/>
       <property name="time" value="6000"/>
   </bean>
```

如有问题请联系我QQ:1360379096

谢谢
```
@如果没有你
```
给我提供的意见

如果你喜欢本项目，请点击右上角的 Star，这样就可以将本项目放入您的收藏。

如果你非常喜欢，请点击右上角的 Fork，这样就可以直接将本项目直接复制到您的名下。

如果您有问题需要反馈，请点击 github 上的 issues 提交您的问题。

如果您改进了代码，并且愿意将它合并到本项目中，你可以使用 github 的 pull requests 功能来提交您的修改。