@ -1,13 +1,13 @@
# Spring Cloud Alibaba
Spring Cloud Alibaba 致力于提供分布式应用 服务开发的一站式解决方案。此项目包含开发分布式应用服务的必需组件,方便开发者通过 Spring Cloud 编程模型轻松使用这些组件来开发分布式应用服务。
Spring Cloud Alibaba 致力于提供微 服务开发的一站式解决方案。此项目包含开发分布式应用微 服务的必需组件,方便开发者通过 Spring Cloud 编程模型轻松使用这些组件来开发分布式应用服务。
依托 Spring Cloud Alibaba, 您只需要添加一些注解和少量配置, 就可以将 Spring Cloud 应用接入阿里分布式应用 解决方案,通过阿里中间件来迅速搭建分布式应用系统。
依托 Spring Cloud Alibaba, 您只需要添加一些注解和少量配置, 就可以将 Spring Cloud 应用接入阿里微服务 解决方案,通过阿里中间件来迅速搭建分布式应用系统。
## 主要功能
* ** 服务限流降级**:默认支持为 HTTP 服务的提供限流保护,也支持添加注解实现方法的自定义限流降级,且支持动态修改限流降级规则 。
* ** 服务限流降级**:默认支持 Servlet、RestTemplate、Dubbo 和 RocketMQ 限流降级功能的接入,可以在运行时通过控制台实时修改限流降级规则,还支持查看限流降级 Metrics 监控 。
* ** 服务注册与发现**:适配 Spring Cloud 服务注册与发现标准,默认集成了 Ribbon 的支持。
* ** 分布式配置管理**:支持分布式系统中的外部化配置,配置更改时自动刷新。
* ** 阿里云对象存储**:阿里云提供的海量、安全、低成本、高可靠的云存储服务。支持在任何应用、任何时间、任何地点存储和访问任意类型的数据。
@ -38,6 +38,52 @@ Spring Cloud 使用 Maven 来构建, 最快的使用方式是将本项目clone
## 如何使用
### 如何引入依赖
项目已经发布了第一个版本,版本 0.2.0.RELEASE 对应的是 Spring Boot 2.x 版本,版本 0.1.0.RELEASE 对应的是 Spring Boot 1.x 版本。
如果需要使用已发布的版本,在 `dependencyManagement` 中添加如下配置。
< dependencyManagement >
< dependencies >
< dependency >
< groupId > org.springframework.cloud< / groupId >
< artifactId > spring-cloud-alibaba-dependencies< / artifactId >
< version > 0.2.0.RELEASE< / version >
< type > pom< / type >
< scope > import< / scope >
< / dependency >
< / dependencies >
< / dependencyManagement >
然后再 `dependencies` 中添加自己所需使用的依赖即可使用。
如果您想体验最新的 BUILD-SNAPSHOT 的新功能,则可以将版本换成最新的版本,但是需要在 pom.xml 中配置 Spring BUILDSNAPSHOT 仓库,**注意: SNAPSHOT 版本随时可能更新**
< repositories >
< repository >
< id > spring-snapshot< / id >
< name > Spring Snapshot Repository< / name >
< url > https://repo.spring.io/snapshot< / url >
< snapshots >
< enabled > true< / enabled >
< / snapshots >
< / repository >
< / repositories >
### Reference Doc
[目录 ](https://github.com/spring-cloud-incubator/spring-cloud-alibaba/blob/master/spring-cloud-alibaba-docs/src/main/asciidoc-zh/spring-cloud-alibaba.adoc )
[Nacos Config ](https://github.com/spring-cloud-incubator/spring-cloud-alibaba/blob/master/spring-cloud-alibaba-docs/src/main/asciidoc-zh/nacos-config.adoc )
[Nacos Discovery ](https://github.com/spring-cloud-incubator/spring-cloud-alibaba/blob/master/spring-cloud-alibaba-docs/src/main/asciidoc-zh/nacos-discovery.adoc )
[ACM ](https://github.com/spring-cloud-incubator/spring-cloud-alibaba/blob/master/spring-cloud-alibaba-docs/src/main/asciidoc-zh/acm.adoc )
## 演示 Demo
为了演示如何使用, Spring Cloud Alibaba 项目包含了一个子模块`spring-cloud-alibaba-examples`。此模块中提供了演示用的 example ,您可以阅读对应的 example 工程下的 readme 文档,根据里面的步骤来体验。
Example 列表:
@ -50,6 +96,10 @@ Example 列表:
[AliCloud OSS Example ](https://github.com/spring-cloud-incubator/spring-cloud-alibaba/blob/master/spring-cloud-alibaba-examples/oss-example/readme-zh.md )
[AliCloud ANS Example ](https://github.com/spring-cloud-incubator/spring-cloud-alibaba/blob/master/spring-cloud-alibaba-examples/ans-example/ans-provider-example/readme-zh.md )
[AliCloud ACM Example ](https://github.com/spring-cloud-incubator/spring-cloud-alibaba/blob/master/spring-cloud-alibaba-examples/acm-example/acm-local-example/readme-zh.md )
## 版本管理规范
项目的版本号格式为 x.x.x 的形式,其中 x 的数值类型为数字, 从0开始取值, 且不限于 0~9 这个范围。项目处于孵化器阶段时, 第一位版本号固定使用0, 即版本号为 0.x.x 的格式。
@ -70,4 +120,4 @@ spring-cloud-alibaba@googlegroups.com, 欢迎通过此邮件列表讨论与 spr
### 钉钉群

