Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/justlive1/earth-snow
基础服务，包括常用工具、异常处理等
https://github.com/justlive1/earth-snow
base framework spring vertx
Last synced: about 2 months ago
JSON representation
基础服务，包括常用工具、异常处理等
- Host: GitHub
- URL: https://github.com/justlive1/earth-snow
- Owner: justlive1
- License: apache-2.0
- Created: 2018-03-29T04:48:54.000Z (almost 7 years ago)
- Default Branch: master
- Last Pushed: 2018-08-31T03:12:54.000Z (over 6 years ago)
- Last Synced: 2024-10-18T10:18:21.132Z (2 months ago)
- Topics: base, framework, spring, vertx
- Language: Java
- Homepage:
- Size: 237 KB
- Stars: 3
- Watchers: 2
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 基础服务
## 介绍
- snow-common-base J2SE基础
- snow-common-web J2EE基础
- snow-common-web-vertx Vertx Web扩展
- snow-common-spring-rabbit spring-rabbit封装
- 依赖方式
```
vip.justlive
snow-common-base
${snow.version}
vip.justlive
snow-common-web
${snow.version}
vip.justlive
snow-common-web-vertx
${snow.version}
vip.justlive
snow-common-spring-rabbit
${snow.version}
```
## 特性
* 基于properties配置进行项目定制
* 极简xml
* 自动装载 依赖jar配置properties无需额外配置
## 开发
snow-common-base
公共常量
异常处理封装
工具类
snow-common-web
web异常处理封装
webmvc基本组件配置提供
用户相关工具类
公共对外rest接口提供
snow-common-web-vertx
扩展Route增加注解实现
snow-common-spring-rabbit
spring-rabbit的封装
## 使用
### Response返回
RestController返回使用vip.justlive.common.base.domain.Response进行包装
```
# 成功返回 成功编码 00000
Response.success(T t);
# 错误返回 默认错误码 99999
Response.error(String msg);
# 自定义错误编码
Response.error(String code, String msg);
```
### 异常处理
代码中需要throw异常时需要使用vip.justlive.common.base.exception.Exceptions进行包装，抛出CodedException
注意：
- 异常尽量不要try catch
- WebExceptionHandler统一处理了异常
```
# 构造ErrorCode
ErrorCode err = Exceptions.errorCode(String module, String code);
ErrorCode err = Exceptions.errorMessage(String module, String code, String message);
# 异常包装，抛出unchecked异常
throw Exceptions.wrap(Throwable e);
throw Exceptions.wrap(Throwable e, String code, String message);
throw Exceptions.wrap(Throwable e, ErrorCode errorCode, Object... arguments);
# 抛出业务逻辑异常，不含堆栈信息
throw Exceptions.fail(ErrorCode errCode, Object... params);
throw Exceptions.fail(String code, String message, Object... params);
# 故障型异常，包含堆栈信息
throw Exceptions.fault(ErrorCode errCode, Object... params);
throw Exceptions.fault(String code, String message, Object... params);
throw Exceptions.fault(Throwable e, ErrorCode errCode, Object... params);
throw Exceptions.fault(Throwable e, String code, String message, Object... params)
```
### rabbit
依赖jar
```
vip.justlive
snow-common-spring-rabbit
${snow.version}
```
生产者开发
- 消息的发送方只需要写以下代码，就可以实现消息的发送
- MessageProducer需要通过Spring注入
- sendMessage方法，第一个参数是交换机名称，第二个参数是队列的名称，第三个参数是消息实体
- sendMessageWithDelay方法，第一个参数是交换机名称，第二个参数是队列的名称，第三个参数是消息实体，第四个参数是延迟的时间，单位毫秒
```
@Autowired
MessageProducer producer;
@Test
public void testRabbit() throws IOException {
Vo message = new Vo();
message.setCode("12313");
message.setDate(new Date());
producer.sendMessage("e.sms", "q.sms", message);
}
```
消费者开发
- delay=true 是延迟消息 。使用延迟消息 ，务必加上此注解
- 实现MessageProcess接口，在process方法体内做消息的业务处理
- 加上@Rqueue注解，如果程序要消费多个不同的队列，那就再写多个这样的类，实现MessageProcess
- 自动配置需要加上vip.justlive.common.spring.rabbit包的扫描
```
@Rqueue(queueName = "q.sms", exchangeName = "e.sms")
public class MessageProcessDemo implements MessageProcess {
@Override
public void process(Vo message) {
System.out.println("process message -> " + JSON.toJSON(message));
}
}
```