Web 开发 —— 高阶本地网关

最新推荐文章于 2025-05-23 17:03:50 发布

发强-CrazyAirhead

最新推荐文章于 2025-05-23 17:03:50 发布

阅读量1.2k

点赞数 29

分类专栏： Solon Solon 实用教程文章标签： java

本文链接：https://blog.csdn.net/endergo/article/details/145656278

版权

说明

这里说本地网关，主要是为了区分分布式网关。

在 Web 进阶中，我们讲解了如何定制过滤器和拦截器，提到 Action 本质上是 Handler 和 Class Method 的结合通过，今天我们要讲解一种特殊的Handler —— Gateway（本地网关），通过本地网关更统一的定制系统功能，比如二级路由、拦截、过滤、熔断、异常处理等，虽然直接使用过滤器，也可以做统一的鉴权和异常处理，但网关还可以把一批接口编排进多个网关中，从而实现不同的协议。

示例

在 IDEA 中通过 File->New->Modules... 可以创建新的模块 demo-web04，基础代码和配置可以从demo-web02中拷贝过来。

在这里，我们将继续调整demo-web02，通过 Gateway 来统一的控制逻辑。

增加路由分组，/admin-api/** 对应管理端接口，/app-api/**对应应用端接口
不同的路由分组使用不同的过滤器，从而实现不同的协议等。

通用

BaseGateway

通过 Component 的标签来添加过滤器的通用逻辑。

package com.example.demo.web.common.gateway;

import java.util.function.Predicate;
import org.noear.solon.Solon;
import org.noear.solon.core.BeanWrap;
import org.noear.solon.core.handle.Filter;
import org.noear.solon.core.handle.Gateway;

/**
 * @author airhead
 */
public abstract class BaseGateway extends Gateway {
  public void addFilters(Predicate<BeanWrap> where) {
    Solon.context()
        .lifecycle(
            () ->
                Solon.context()
                    .beanForeach(
                        (bw) -> {
                          if (where.test(bw)) {
                            if (bw.raw() instanceof Filter) {
                              filter(bw.index(), bw.raw());
                            }
                          }
                        }));
  }
}

SwaggerConfig

对 /admin-api 和 /app-api 的文档进行分组。

package com.example.demo.web.common.config;

import com.github.xiaoymin.knife4j.solon.extension.OpenApiExtensionResolver;
import io.swagger.models.Scheme;
import io.swagger.models.auth.ApiKeyAuthDefinition;
import io.swagger.models.auth.In;
import java.util.function.Predicate;
import org.dromara.hutool.core.text.StrUtil;
import org.noear.solon.Solon;
import org.noear.solon.annotation.Bean;
import org.noear.solon.annotation.Configuration;
import org.noear.solon.annotation.Inject;
import org.noear.solon.core.BeanWrap;
import org.noear.solon.docs.DocDocket;
import org.noear.solon.docs.models.ApiContact;
import org.noear.solon.docs.models.ApiInfo;

/**
 * @author airhead
 */
@Configuration
public class SwaggerConfig {
  @Inject private OpenApiExtensionResolver openApiExtensionResolver;

  @Bean("adminApi")
  public DocDocket adminApi() {
    DocDocket docDocket =
        new DocDoc