Gateway 是 Solon 框架的特殊控制器(也是Handler 的一个实现类)。它通过注册收集之后,在局部范围内提供:二级路由、拦截、过滤、融断、异常处理等功能,并统一到网关处理。
另一个作用:可以为同一批接口安排多个网关,进而定制不同的协议效果。
1、定义2个组件
API_0
@Component(tag = "api")
public class API_0 {
@Mapping
public Result exec() {
return Result.failure(404, "Interface does not exist");
}
}
API_hello_world
@Component(tag = "api")
public class API_hello_world {
@Mapping("hello")
public Result exec(String name) {
return Result.succeed("Hello " + name);
}
}
这2个组件,很特别???有@Mapping,看起来像控制器类。但它确用@Component注解,而且还有tag属性。
其实它们跟平常开发的控制器类是一样的。改用 @Component ,是为了不被根路由器扫描进去。而增加tag属性,是为了方便 Gateway 做局部扫描。
@Mapping 值为空时,会被 Gateway 做为默认接口对待。即找不到别的接口时,就用它。
2、定义 Gateway
ApiGateway
@Mapping("/api/**")
@Component
public class ApiGateway extends Gateway {
@Override
protected void register() {
addBeans(bw -> "api".equals(bw.tag()));
}
}
最简单的 Gateway 只需要完成注册即可,输出效果跟普通的控制器差不多。启动服务后,我们就可以访问 http://localhost:8080/api/hello
。
3、在 Gateway 上做点什么
加一个前置处理,做令牌验证。再重写渲染,对未处理异常做控制。
@Mapping("/api/**")
@Component
public class ApiGateway extends Gateway {
@Override
protected void register() {
//添加个前置处理
before(c -> {
//检测有没有token(用 param 替代;方便手浏览器测试)
if (c.param("t") == null) {
//如果没有令牌;直接设定结果
c.result = Result.failure(403, "Missing authentication information");
//设为已处理(主接口就不会进去了)
c.setHandled(true);
}
});
//添加Bean
addBeans(bw -> "api".equals(bw.tag()));
}
//重写染处理异常
@Override
public void render(Object obj, Context c) throws Throwable {
if (obj instanceof Throwable) {
c.render(Result.failure("unknown error"));
} else {
c.render(obj);
}
}
}