环境准备
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|选择器 & 规则介绍
评论