1. 重新划分章节和目录

2. 部分演示代码更新
3. 完善部分介绍

Author: eacdy

1 微服务简介/1 微服务简介.md

@@ -0,0 +1,11 @@
+# 1 微服务简介
+
+## 什么是微服务架构
+
+近年来，在软件开发领域关于微服务的讨论呈现出火爆的局面，有人倾向于在系统设计与开发中采用微服务方式实现软件系统的松耦合、跨部门开发，被认为是IT软件架构的未来方向，Martin Fowler也给微服务架构极高的评价；同时，反对之声也很强烈，持反对观点的人表示微服务增加了系统维护、部署的难度，导致一些功能模块或代码无法复用，同时微服务允许使用不同的语言和框架来开发各个系统模块，这又会增加系统集成与测试的难度，而且随着系统规模的日渐增长，微服务在一定程度上也会导致系统变得越来越复杂。尽管一些公司已经在生产系统中采用了微服务架构，并且取得了良好的效果；但更多公司还是处在观望的态度。
+
+什么是微服务架构呢？简单说就是将一个完整的应用（单体应用）按照一定的拆分规则（后文讲述）拆分成多个不同的服务，每个服务都能独立地进行开发、部署、扩展。服务于服务之间通过注入RESTful api或其他方式调用。大家可以搜索到很多相关介绍和文章。本文暂不细表。在此推荐两个比较好的博客：
+
+>[http://microservices.io/](http://microservices.io/)
+>[http://martinfowler.com/articles/microservices.html](http://martinfowler.com/articles/microservices.html)
+

chapter1/1 序言.md 2 Spring Cloud/2 Spring Cloud.md

@@ -1,21 +1,8 @@
-# 序言
-
-## 什么是微服务架构
-
-近年来，在软件开发领域关于微服务的讨论呈现出火爆的局面，有人倾向于在系统设计与开发中采用微服务方式实现软件系统的松耦合、跨部门开发；同时，反对之声也很强烈，持反对观点的人表示微服务增加了系统维护、部署的难度，导致一些功能模块或代码无法复用，同时微服务允许使用不同的语言和框架来开发各个系统模块，这又会增加系统集成与测试的难度，而且随着系统规模的日渐增长，微服务在一定程度上也会导致系统变得越来越复杂。尽管一些公司已经在生产系统中采用了微服务架构，并且取得了良好的效果；但更多公司还是处在观望的态度。
-
-什么是微服务架构呢？简单说就是将一个完整的应用（单体应用）按照一定的拆分规则（后文讲述）拆分成多个不同的服务，每个服务都能独立地进行开发、部署、扩展。服务于服务之间通过注入RESTful api或其他方式调用。大家可以搜索到很多相关介绍和文章。本文暂不细表。
-
-在此推荐两个比较好的博客：
-
->[http://microservices.io/](http://microservices.io/)
->[http://martinfowler.com/articles/microservices.html](http://martinfowler.com/articles/microservices.html)
-
-
+# 2 Spring Cloud
 
 ## Spring Cloud 简介
 
-Spring Cloud是在Spring Boot的基础上构建的，为开发人员提供快速建立分布式系统中的一些常见的模式
+Spring Cloud是在Spring Boot的基础上构建的，用于简化分布式系统构建的工具集，为开发人员提供快速建立分布式系统中的一些常见的模式。
 
 >  例如：配置管理（configuration management），服务发现（service discovery），断路器（circuit breakers），智能路由（ intelligent routing），微代理（micro-proxy），控制总线（control bus），一次性令牌（ one-time tokens），全局锁（global locks），领导选举（leadership election），分布式会话（distributed sessions），集群状态（cluster state）。
 
@@ -31,15 +18,31 @@ Spring Cloud 项目主页：[http://projects.spring.io/spring-cloud/](http://pro
 
 
 
-## 准备
+## 准备工作
+
+
+技术储备：
+
+| 所需技能        | 备注                              |
+| ----------- | ------------------------------- |
+| Java        |                                 |
+| Maven       | 文章涉及到大量的代码，均使用Maven构建           |
+| Spring Boot | Spring Cloud是在Spring Boot基础上构建的 |
 
 环境准备：
 
-| 工具    | 版本或描述                |
-| ----- | -------------------- |
-| JDK   | 1.8                  |
-| IDE   | STS 或者 IntelliJ IDEA |
-| Maven | 3.x                  |
+| 工具    | 版本或描述                            |
+| ----- | -------------------------------- |
+| JDK   | 1.8                              |
+| IDE   | STS 或者 IntelliJ IDEA，本教程使用的是STS. |
+| Maven | 3.x                              |
+
+本课程所使用的软件及版本：
+
+| 使用到的软件       | 版本号           | 是否最新版本 |
+| ------------ | ------------- | ------ |
+| Spring Boot  | 1.4.0.RELEASE | 是      |
+| Spring Cloud | Brixton.SR5   | 是      |
 
 主机名配置：
 
@@ -67,7 +70,9 @@ Spring Cloud 项目主页：[http://projects.spring.io/spring-cloud/](http://pro
 
 Spring Cloud所有的配置项：
 
-> [http://cloud.spring.io/spring-cloud-static/Brixton.SR5/#_appendix_compendium_of_configuration_properties](http://cloud.spring.io/spring-cloud-static/Brixton.SR5/#_appendix_compendium_of_configuration_properties)
+[http://cloud.spring.io/spring-cloud-static/Brixton.SR5/#_appendix_compendium_of_configuration_properties](http://cloud.spring.io/spring-cloud-static/Brixton.SR5/#_appendix_compendium_of_configuration_properties)
+
+父项目的建立
 
 在进入主题之前，我们首先创建一个父项目（spring-cloud-microservice-study），这样可以对项目中的Maven依赖进行统一的管理。
 
@@ -92,6 +97,9 @@ Spring Cloud所有的配置项：
 		<module>microservice-hystrix-dashboard</module>
 		<module>microservice-consumer-movie-feign-with-hystrix-stream</module>
 		<module>microservice-hystrix-turbine</module>
+		<module>microservice-config-server</module>
+		<module>microservice-config-client</module>
+		<module>microservice-api-gateway</module>
 	</modules>
 
 	<!-- 使用最新的spring-boot版本 -->
@@ -111,7 +119,7 @@ Spring Cloud所有的配置项：
 			<dependency>
 				<groupId>org.springframework.cloud</groupId>
 				<artifactId>spring-cloud-dependencies</artifactId>
-				<version>Brixton.SR4</version>
+				<version>Brixton.SR5</version>
 				<type>pom</type>
 				<scope>import</scope>
 			</dependency>
@@ -128,3 +136,10 @@ Spring Cloud所有的配置项：
 	</build>
 </project>
 ```
+
+
+
+## TIPS
+
+1. 笔者讲解采用最新的Spring Boot 和Spring Cloud进行讲解，其中可能涉及到部分新特性，笔者尽量指出，同时笔者能力有限，如有理解不到位的地方，还请各位看客指出，定在第一时间进行修正。
+2. Spring Cloud版本并不是传统的使用数字的方式标识，而是使用例如：Angel、Brixton、Camden...等等伦敦的地名来命名版本，版本的先后顺序大家可能已经猜到了，就是使用字母表的先后来标识的。笔者在咨询过Spring Cloud的主要贡献者之一Josh Long之后已经确认。

chapter2/2 服务发现.md 2 Spring Cloud/2.1 服务发现.md

@@ -1,3 +1,5 @@
+# 2.1 服务发现
+
 ## 关于服务发现
 
 在微服务架构中，服务发现（Service Discovery）是关键原则之一。手动配置每个客户端或某种形式的约定是很难做的，并且很脆弱。Spring Cloud提供了多种服务发现的实现方式，例如：Eureka、Consul、Zookeeper。本文暂时只讲述基于Eureka的服务发现。后续会补上基于Consul和Zookeeper的服务发现。
@@ -74,7 +76,7 @@ eureka:
 
 
 
-## 代码地址（任选其一）：
+## 代码地址（任选其一）
 
 > [http://git.oschina.net/itmuch/spring-cloud-study/tree/master/microservice-discovery-eureka](http://git.oschina.net/itmuch/spring-cloud-study/tree/master/microservice-discovery-eureka)
 > [https://github.com/eacdy/spring-cloud-study/tree/master/microservice-discovery-eureka](https://github.com/eacdy/spring-cloud-study/tree/master/microservice-discovery-eureka)

chapter3/3 服务提供者.md 2 Spring Cloud/2.2 服务提供者.md

@@ -1,3 +1,5 @@
+# 2.2 服务提供者
+
 ## 服务提供者和服务消费者
 
 下面这张表格，简单描述了服务提供者/消费者是什么：
@@ -214,7 +216,7 @@ public class UserApplication {
 
 
 
-## 代码地址（任选其一）：
+## 代码地址（任选其一）
 
 >[http://git.oschina.net/itmuch/spring-cloud-study/tree/master/microservice-provider-user](http://git.oschina.net/itmuch/spring-cloud-study/tree/master/microservice-provider-user)
 >[https://github.com/eacdy/spring-cloud-study/tree/master/microservice-provider-user](https://github.com/eacdy/spring-cloud-study/tree/master/microservice-provider-user)

chapter4/4 服务消费者.md 2 Spring Cloud/2.3 服务消费者.md

@@ -1,3 +1,5 @@
+# 2.3 服务消费者
+
 上文我们创建了注册中心，以及服务的提供者microservice-provider-user，并成功地将服务提供者注册到了注册中心上。
 
 要想消费microservice-provider-user的服务是很简单的，我们只需要使用RestTemplate即可，或者例如HttpClient之类的http工具也是可以的。但是在集群环境下，我们必然是每个服务部署多个实例，那么服务消费者消费服务提供者时的负载均衡又要如何做呢？

chapter4/4.1 Ribbon.md 2 Spring Cloud/2.3.1 Ribbon.md

@@ -1,12 +1,14 @@
-# 第1节：Ribbon
+# 2.3.1 Ribbon
 
-### Ribbon介绍
+
+
+## Ribbon介绍
 
 Ribbon是Netflix发布的开源项目，主要功能是提供客户端的软件负载均衡算法，将Netflix的中间层服务连接在一起。Ribbon客户端组件提供一系列完善的配置项如连接超时，重试等。简单的说，就是在配置文件中列出Load Balancer后面所有的机器，Ribbon会自动的帮助你基于某种规则（如简单轮询，随即连接等）去连接这些机器。我们也很容易使用Ribbon实现自定义的负载均衡算法。简单地说，Ribbon是一个客户端负载均衡器。
 
 
 
-### Ribbon代码示例
+## Ribbon代码示例
 
 创建一个Maven项目，并在pom.xml中加入如下内容：
 

chapter4/4.2 Feign.md 2 Spring Cloud/2.3.2 Feign.md

@@ -1,14 +1,15 @@
-# 第2节：Feign
+# 2.3.2. Feign
 
-### Feign介绍
+
+## Feign介绍
 
 Feign是一个声明式的web service客户端，它使得编写web service客户端更为容易。创建接口，为接口添加注解，即可使用Feign。Feign可以使用Feign注解或者JAX-RS注解，还支持热插拔的编码器和解码器。Spring Cloud为Feign添加了Spring MVC的注解支持，并整合了Ribbon和Eureka来为使用Feign时提供负载均衡。
 
 > 翻译自：[http://projects.spring.io/spring-cloud/docs/1.0.3/spring-cloud.html#spring-cloud-feign](http://projects.spring.io/spring-cloud/docs/1.0.3/spring-cloud.html#spring-cloud-feign)
 
 
 
-### Feign示例
+## Feign示例
 
 创建一个Maven项目，并在pom.xml添加如下内容：
 

chapter5/5 熔断器.md 2 Spring Cloud/2.4 熔断器.md

@@ -1,4 +1,4 @@
-# 第5章：熔断器
+# 2.4 熔断器
 
 
 

chapter5/5.1 Hystrix.md 2 Spring Cloud/2.4.1 Hystrix.md

@@ -1,4 +1,4 @@
-# 第1节：Hystrix
+# 2.4.1. Hystrix
 
 
 

chapter5/5.2 Hystrix Dashboard.md 2 Spring Cloud/2.4.2 Hystrix Dashboard.md

@@ -1,4 +1,4 @@
-# 第2节：Hystrix Dashboard
+# 2.4.2. Hystrix Dashboard
 
 
 
@@ -10,7 +10,7 @@
 
 
 
-### 测试步骤
+## 测试步骤
 
 1. 启动：microservice-discovery-eureka
 
@@ -30,7 +30,7 @@
 
 
 
-### Hystrix Dashboard
+## Hystrix Dashboard
 
 Hystrix Dashboard可以可视化查看实时监控数据。我们可以下载hystrix-dashboard的war包部署到诸如Tomcat之类的容器就，本文不做赘述另外Spring Cloud也提供了Hystrix Dashboard的整合，下面我们看看Spring Cloud是怎么玩转Hystrix Dashboard的。
 
@@ -109,15 +109,15 @@ server:
 
 
 
-### 代码地址（任选其一）：
+## 代码地址（任选其一）：
 
 >[http://git.oschina.net/itmuch/spring-cloud-study/tree/master/microservice-hystrix-dashboard](http://git.oschina.net/itmuch/spring-cloud-study/tree/master/microservice-hystrix-dashboard)
 >
 >[https://github.com/eacdy/spring-cloud-study/tree/master/microservice-hystrix-dashboard](https://github.com/eacdy/spring-cloud-study/tree/master/microservice-hystrix-dashboard)
 
 
 
-### TIPS
+## TIPS
 
 我们启动前文的microservice-consumer-movie-feign-with-hystrix项目后发现其访问[localhost:8021/hystrix.stream](localhost:8021/hystrix.stream) ，是404，查看pom.xml依赖树，发现其没有依赖hystrix-metrics-event-stream项目。故而添加依赖：
 

chapter5/5.3 Turbine.md 2 Spring Cloud/2.4.3 Turbine.md

@@ -1,14 +1,16 @@
-# 第3节：Turbine
+# 2.4.3. Turbine
 
-### Turbine
+
+
+## Turbine
 
 在复杂的分布式系统中，相同服务的结点经常需要部署上百甚至上千个，很多时候，运维人员希望能够把相同服务的节点状态以一个整体集群的形式展现出来，这样可以更好的把握整个系统的状态。 为此，Netflix提供了一个开源项目（Turbine）来提供把多个hystrix.stream的内容聚合为一个数据源供Dashboard展示。 
 
 和Hystrix Dashboard一样，Turbine也可以下载war包部署到Web容器，本文不做赘述。下面讨论Spring Cloud是怎么使用Turbine的。
 
 
 
-### 编码
+## 代码示例
 
 新建Maven项目，并在pom.xml中添加如下内容：
 
@@ -90,7 +92,7 @@ eureka:
 
 
 
-### Turbine测试
+## Turbine测试
 
 1. 启动项目：microservice-discovery-eureka
 2. 启动项目：microservice-provider-user
@@ -108,7 +110,7 @@ data: {"rollingCountFallbackSuccess":0,"rollingCountFallbackFailure":0,"property
 
 并且会不断刷新以获取实时的监控数据。同样的，我们可以将这些文本内容放入到Dashboard中展示。
 
-10000. 访问Hystrix Dashboard：[http://localhost:8030/hystrix.stream](http://localhost:8030/hystrix.stream)，并将[http://localhost:8031/turbine.stream](http://localhost:8031/turbine.stream)输入到其上的输入框，并随意指定一个Title，如下图：
+10000000000000000. 访问Hystrix Dashboard：[http://localhost:8030/hystrix.stream](http://localhost:8030/hystrix.stream)，并将[http://localhost:8031/turbine.stream](http://localhost:8031/turbine.stream)输入到其上的输入框，并随意指定一个Title，如下图：
 
 ![turbine-index](images/turbine-01.png)
 
@@ -118,7 +120,7 @@ data: {"rollingCountFallbackSuccess":0,"rollingCountFallbackFailure":0,"property
 
 
 
-### TIPS
+## TIPS
 
 1. 项目microservice-consumer-movie-ribbon-with-hystrix 和 microservice-consumer-movie-feign-with-hystrix-stream 需要配置不同的主机名，并将preferIpAddress设为false或者不设置，否则将会造成在单个主机上测试，Turbine只显示一个图表的情况。项目的代码已经修改好并注释了，这边友谊提示一下。
 
@@ -134,7 +136,7 @@ data: {"rollingCountFallbackSuccess":0,"rollingCountFallbackFailure":0,"property
 
 
 
-### 参考文档
+## 参考文档
 
 > [http://blog.csdn.net/liaokailin/article/details/51344281](http://blog.csdn.net/liaokailin/article/details/51344281)
 >

chapter6/6 配置中心.md 2 Spring Cloud/2.5 配置中心.md

@@ -1,4 +1,4 @@
-# 第6章：配置中心
+# 2.5 配置中心
 
 Spring Cloud Config提供了一种在分布式系统中外部化配置服务器和客户端的支持。配置服务器有一个中心位置，管理所有环境下的应用的外部属性。客户端和服务器映射到相同Spring Eventment 和 PropertySrouce抽象的概念，所以非常适合Spring应用，但也可以在任何语言开发的任何应用中使用。在一个应用从开发、测试到生产的过程中，你可以分别地管理开发、测试、生产环境的配置，并且在迁移的时候获取相应的配置来运行。
 
@@ -14,7 +14,7 @@ Config Server 存储后端默认使用git存储配置信息，因此可以很容
 
 
 
-### 准备工作
+## 准备工作
 
 准备几个配置文件，命名规范为`项目名称-环境名称.properties`，本文在git仓库：[https://github.com/eacdy/spring-cloud-study/](https://github.com/eacdy/spring-cloud-study/)中，新建目录config-repo，创建以下几个文件：
 
@@ -26,7 +26,7 @@ microservice-config-client.properties
 
 
 
-### Config Server 示例
+## Config Server 示例
 
 创建一个Maven项目，在pom.xml文件中添加如下内容：
 
@@ -105,7 +105,7 @@ spring:
 
 
 
-### 测试工作
+## 测试工作
 
 | 获取git上的资源信息遵循如下规则                        |
 | ---------------------------------------- |
@@ -121,13 +121,13 @@ spring:
 
 
 
-### 微服务如何获取配置信息
+## 微服务如何获取配置信息
 
 我们成功搭建了Config Server，并测试能够正常获取到git仓库中的配置信息。那么对于一个微服务应用，如何才能获取配置信息呢？
 
 
 
-#### DEMO
+### 配置服务客户端示例
 
 新建一个Maven项目，在pom.xml中添加如下内容：
 
@@ -222,7 +222,7 @@ spring:
 
 
 
-#### 配置的热加载
+### 配置的热加载
 
 如果不重启应用，能够做到配置的刷新吗？答案显然是可以的。
 
@@ -250,7 +250,7 @@ abcd
 
 
 
-#### 注意点：
+## 注意点：
 
 1. client需要添加以下依赖，否则访问/refresh将会得到404：