SOUL 网关http用户接入使用搭建教程（2.1.2版本）

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

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

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