|
|
|
|
# SOP(Simple Open Platform)
|
|
|
|
|
|
|
|
|
|
一个开放平台解决方案项目，基于Spring Cloud实现，目标是能够让用户快速得搭建起自己的开放平台。
|
|
|
|
|
|
|
|
|
|
SOP提供了两种接口调用方式，分别是：[支付宝开放平台](https://docs.open.alipay.com/api)的调用方式和[淘宝开放平台](http://open.taobao.com/api.htm?docId=285&docType=2)的调用方式。
|
|
|
|
|
通过简单的配置后，你的项目就具备了和支付宝开放平台的一样的接口提供能力。
|
|
|
|
|
|
|
|
|
|
SOP封装了开放平台大部分功能包括：签名验证、统一异常处理、统一返回内容 、业务参数验证（JSR-303）、秘钥管理等，未来还会实现更多功能。
|
|
|
|
|
|
|
|
|
|
## 项目特点
|
|
|
|
|
|
|
|
|
|
- 接入方式简单，与老项目不冲突，老项目注册到注册中心，然后在方法上加上注解即可。
|
|
|
|
|
- 架构松耦合，业务代码实现在各自微服务上，SOP不参与业务实现，这也是Spring Cloud微服务体系带来的好处。
|
|
|
|
|
- 扩展简单，开放平台对应的功能各自独立，可以自定义实现自己的需求，如：更改参数，更改签名规则等。
|
|
|
|
|
|
|
|
|
|
## 谁可以使用这个项目
|
|
|
|
|
|
|
|
|
|
- 有现成的项目，想改造成开放平台供他人调用
|
|
|
|
|
- 有现成的项目，想暴露其中几个接口并通过开放平台供他人调用
|
|
|
|
|
- 想搭一个开放平台新项目，并结合微服务的方式去维护
|
|
|
|
|
- 对开放平台感兴趣的朋友
|
|
|
|
|
|
|
|
|
|
以上情况都可以考虑使用SOP
|
|
|
|
|
|
|
|
|
|
## 架构图
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
## 已完成列表
|
|
|
|
|
|
|
|
|
|
- 签名验证
|
|
|
|
|
- 统一异常处理
|
|
|
|
|
- 统一返回内容
|
|
|
|
|
- session管理
|
|
|
|
|
- 秘钥管理
|
|
|
|
|
- 微服务端自动验证（JSR-303）
|
|
|
|
|
- 支持Spring Cloud Gateway
|
|
|
|
|
|
|
|
|
|
## 后期规划
|
|
|
|
|
|
|
|
|
|
- 关闭签名校验功能
|
|
|
|
|
- 整合[easyopen](https://gitee.com/durcframework/easyopen)
|
|
|
|
|
- 配置中心，Spring Cloud Config（Zookeeper）
|
|
|
|
|
- Admin管理平台，统一管理微服务配置，管理路由信息，微服务上下线等功能
|
|
|
|
|
|
|
|
|
|
## 工程说明
|
|
|
|
|
|
|
|
|
|
> 运行环境：JDK8，Maven3，zookeeper
|
|
|
|
|
|
|
|
|
|
- sop-registry：注册中心，eureka实现
|
|
|
|
|
- sop-gateway：网关，统一访问入口，Spring Cloud Zuul实现，可切换成Spring Cloud Gateway
|
|
|
|
|
- sop-gateway-common：网关公共模块，封装常用功能，包含签名校验、错误处理等功能
|
|
|
|
|
- sop-service-common：微服务端公共模块，封装配套功能
|
|
|
|
|
- sop-story：微服务示例，story服务，同时作为Provider提供服务
|
|
|
|
|
- sop-book：微服务示例，book服务，也是Consumer，调用story提供的服务
|
|
|
|
|
- sop-test：接口调用测试用例
|
|
|
|
|
|
|
|
|
|
## 快速开始
|
|
|
|
|
|
|
|
|
|
- 安装并启动zookeeper，[安装教程](http://zookeeper.apache.org/doc/r3.4.13/zookeeperStarted.html)
|
|
|
|
|
- IDE打开项目(IDEA下可以打开根pom.xml，然后open as project)
|
|
|
|
|
- 启动注册中心，sop-registry（运行SopRegistryApplication.java）
|
|
|
|
|
- 启动网关：sop-gateway（运行SopGatewayApplication.java）
|
|
|
|
|
- 启动微服务：sop-story-web(运行SopStoryApplication.java)
|
|
|
|
|
- 找到sop-test，打开测试用例，进行接口调用测试，运行com.gitee.sop.AlipayClientPostTest.testPost()
|
|
|
|
|
|
|
|
|
|
## 相关文档
|
|
|
|
|
|
|
|
|
|
待完善
|
|
|
|
|
|
|
|
|
|
## 沟通交流
|
|
|
|
|
|
|
|
|
|
Q群：328419269
|
