soul网关http用户接入使用教程

Scroll Down

soul网关http用户接入使用教程

1. 首先先从git 或者github 上面找到soul 的源码地址,将源码clone下来。
gitee soule地址
github soul地址
soul使用文档在这里插入图片描述
在这里插入图片描述

2. 将项目导入到idea 或者eclipse
在这里插入图片描述
3. 修改soul-admin 中的 数据库配置数据库sql 在resources/META-INF 中将数据库配置成自己的数据
在这里插入图片描述
4.如需要配置zookeeper修改soul-admin 中的配置文件

soul:
  http:
    register: true   # 设置为true
    zookeeperUrl: localhost:2181  #设置你的zk地址

5.启动soul-admin
浏览器输入:localhost:9095 默认账号密码为:admin 123456
在这里插入图片描述
6.然后再启动soul-bootstrap 项目admin为管理平台,bootstrap为web网关核心
7.将自己项目中的接口快速接入到soul网关

springMvc (springboot用户)

1.pom.xml中引入maven依赖

<dependency>
   <groupId>org.dromara</groupId>
   <artifactId>soul-client-springmvc</artifactId>
   <version>2.1.2-RELEASE</version>
 </dependency>

2.yml配置

soul:
  http:
    adminUrl: http://localhost:9095
    contextPath: /http
    appName: http


# adminUrl: 为你启动的soul-admin 项目的ip + 端口,注意要加http://
# contextPath: 为你的这个mvc项目在soul网关的路由前缀,这个你应该懂意思把? 比如/order ,/product 等等,网关会根据你的这个前缀来进行路由.
# appName:你的应用名称,不配置的话,会默认取 `spring.application.name` 的值

如何配置zk 添加

 zookeeper-url: localhost:2181

3.在controller的接口上加入@SoulClient 注解 例如:

@SoulClient(path = "/test/jn",desc = "例子")
@RequestMapping(value = "jn", method = RequestMethod.GET)

4.启动你的项目可以在admin 管理平台中看到自己的接口已经接入到了soul网关中

在这里插入图片描述
5.修改选择器配置
在这里插入图片描述
修改选择器配置,添加上自己的项目的ip和端口。点击确认之后记得同步divide和在元数据管理页面点击同步数据按钮

http用户对soul网关请求

保证之前将soul-admin 和soul-bootstrap 以及你自己接入的项目启动了。
springMvc & springcloud
说白了,你之前怎么请求就怎么请求,没有很大的变动,变动的地方有2点。

第一点,你之前请求的域名是你自己的服务,现在要换成网关的域名

第二点,soul网关需要有一个路由前缀,这个路由前缀就是你接入项目进行配置 contextPath ,如果熟的话,可以自由在 soul-admin 中的divide插件进行自由更改.
例如:

# 比如你有一个 order服务 它有一个接口,请求路径 http://localhost:8080/test/save

# 现在就需要换成:http://localhost:9195/order/test/save

# 其中 localhost:9195 为网关的ip端口,默认端口是9195 ,/order 是你接入网关配置的 contextPath

# 其他参数,请求方式不变。

然后你就可以进行访问了,如此的方便与简单。