环境准备
soul 网关使用 divide 插件来处理 http 请求,在网关的 pom.xml
文件中添加如下依赖:
<!--if you use http proxy start this-->
<dependency>
<groupId>org.dromara</groupId>
<artifactId>soul-spring-boot-starter-plugin-divide</artifactId>
<version>${project.version}</version>
</dependency>
<dependency>
<groupId>org.dromara</groupId>
<artifactId>soul-spring-boot-starter-plugin-httpclient</artifactId>
<version>${project.version}</version>
</dependency>
<!--if you use http proxy end this-->
复制代码
重启网关服务
一、在 soul-admin 直接配置
在 soul-admin
的操作页面点击插件列表,选择 divide,进行选择器和规则的添加。
示例:
选择器配置
规则配置
当一个请求的 uri
是 /http/soul
,会被转发到 https://gitee.com/shuaiqiyu/soul/ ,并打印日志。
日志
实际效果
二、Soul-Client 接入方式
此方式适用于 Spring MVC , Spring Boot 用户
1. Spring Boot 用户配置
1.1 在你的真实服务的 pom.xml
新增如下依赖:
<dependency>
<groupId>org.dromara</groupId>
<artifactId>soul-spring-boot-starter-client-springmvc</artifactId>
<version>${last.version}</version>
</dependency>
复制代码
1.2 在 yml 中新增如下配置:
soul:
http:
adminUrl: http://localhost:9095
port: 你本项目的启动端口
contextPath: /http
appName: http
full: false
# adminUrl: 为你启动的soul-admin 项目的ip + 端口,注意要加http://
# port: 你本项目的启动端口
# contextPath: 为你的这个mvc项目在soul网关的路由前缀,比如/order ,/product 等,网关会根据你的这个前缀来进行路由
# appName:你的应用名称,不配置的话,会默认取 `spring.application.name` 的值
# full: 设置true 代表代理你的整个服务,false表示代理你其中某几个controller
复制代码
2. Spring MVC 用户配置
1.1 在你的真实服务的 pom.xml
新增如下依赖:
<dependency>
<groupId>org.dromara</groupId>
<artifactId>soul-client-springmvc</artifactId>
<version>${last.version}</version>
</dependency>
复制代码
1.2 在你的 bean 定义的 xml 文件中新增如下:
<bean id ="springMvcClientBeanPostProcessor" class ="org.dromara.soul.client.springmvc.init.SpringMvcClientBeanPostProcessor">
<constructor-arg ref="soulSpringMvcConfig"/>
</bean>
<bean id="soulSpringMvcConfig" class="org.dromara.soul.client.springmvc.config.SoulSpringMvcConfig">
<property name="adminUrl" value="http://localhost:9095"/>
<property name="port" value="你的端口"/>
<property name="contextPath" value="/你的contextPath"/>
<property name="appName" value="你的名字"/>
<property name="full" value="false"/>
</bean>
复制代码
3. 使用 @SoulSpringMvcClient 注解
你可以把注解加到 Controller
类上面, 里面的 path 属性则为前缀,如果含有 /**
代表你的整个接口需要被网关代理。
启动你的项目,你的接口接入到了网关。
三、其他接入方式
自定义开发属于你的 http-client 。
{
"appName": "xxx", //应用名称 必填
"context": "/xxx", //请求前缀 必填
"path": "xxx", //路径需要唯一 必填
"pathDesc": "xxx", //路径描述
"rpcType": "http", //rpc类型 必填
"host": "xxx", //服务host 必填
"port": xxx, //服务端口 必填
"ruleName": "xxx", //可以同path一样 必填
"enabled": "true", //是否开启
"registerMetaData": "true" //是否需要注册元数据
}
复制代码
扩展阅读
Soul 网关实践 01|把项目跑起来
Soul 网关实践 02|选择器 & 规则介绍
评论