上一篇中,我们对 Soul 有了一个简单的认识。
在学习一项新技术时,我们先按照官网上的 Demo 把环境搭建起来。今天先搭建一个单机版测试环境。
1.下载源码
soul 的 github 地址: https://github.com/dromara/soul
这里有2个选择:
- 如果只是用来阅读 soul 源码,不会改动,不提交 PR的,直接 git clone 的地址。
- 如果学习源码后,希望参与到 soul 开源项目中,fork 到自己账号下,再 clone 自己账号下的 soul 项目。
这里,我建议大家采用第2种方式,也以第2种方式演示。
git clone https://github.com/hellboy0621/soul.git
为了方便后续拉取最新代码,设置 upstream 远程仓库
git remote add upstream https://github.com/dromara/soul
# 后续拉取最新代码时使用
git checkout master
git pull upstream master
后续如果提交 PR 时,会创建单独的 branch 修改代码后上传,目前我们只是阅读源码,所以创建一个 read 的分支,互不影响。
git checkout -b read
把源码下载好后,导入 IDEA 中。
2.启动 MySQL
soul-admin 模块需要把一些数据持久化到 MySQL中。
3.启动 soul-admin 项目
在 IDEA 里找到 soul-admin 模块,按照各自数据库配置,修改配置文件(我的是3306端口号,用户名root,没有密码)
启动完成后,进入控制页面 http://127.0.0.1:9095/,使用 admin/123456 登录。欢迎页面如下:
在插件列表下,所有页面都是空白的。
4.启动 soul-bootstrap,这就是 Soul 网关服务项目,默认端口号是9195。
5.接入 HTTP 应用。
启动 examples 下的 soul-examples-http。
再次访问管理页面的 devide 插件,有了如下选择器。
在 soul-examples-http 项目下的 controller 层,可以看到这些接口信息,如下图这个接口 /order/findById。
此时可以直接访问这个接口 http://localhost:8188/order/findById?id=95
也可以通过网关来访问这个接口 http://localhost:9195/http/order/findById?id=95
今天就先体验到这里,明天我们继续深入的探索 HTTP 服务是如何接入的。
文章是本人一边学习一边记录的,如有错误,请批评指正,谢谢。