modify developers guide for spring boot integration (#112)
diff --git a/java-chassis-reference/en_US/SUMMARY.md b/java-chassis-reference/en_US/SUMMARY.md
index 70a98b5..9c9e142 100644
--- a/java-chassis-reference/en_US/SUMMARY.md
+++ b/java-chassis-reference/en_US/SUMMARY.md
@@ -79,7 +79,7 @@
* [Using TLS](security/tls.md)
* [Using RSA certification](security/rsa.md)
* [Using java chassis in Spring Boot](using-java-chassis-in-spring-boot.md)
- * [Provided component description](using-java-chassis-in-spring-boot/components-for-spring-boot.md)
+ * [spring boot starter for java-chassis](using-java-chassis-in-spring-boot/components-for-spring-boot.md)
* [JAVA application development](using-java-chassis-in-spring-boot/java-application.md)
* [Web development method development](using-java-chassis-in-spring-boot/web-application.md)
* [The difference between JAVA application method and Web development method](using-java-chassis-in-spring-boot/diff-between-java-web.md)
diff --git a/java-chassis-reference/en_US/using-java-chassis-in-spring-boot/components-for-spring-boot.md b/java-chassis-reference/en_US/using-java-chassis-in-spring-boot/components-for-spring-boot.md
index ff1e7b7..20b51e5 100644
--- a/java-chassis-reference/en_US/using-java-chassis-in-spring-boot/components-for-spring-boot.md
+++ b/java-chassis-reference/en_US/using-java-chassis-in-spring-boot/components-for-spring-boot.md
@@ -1,29 +1,154 @@
-For Spring Boot, Spring Cloud, the following components are provided:
+# spring boot starter for java-chassis
-* spring-boot-starter-configuration
+java-chassis provide different starters for spring boot.
-Access the configuration center. When you need to use the Configuration Center as a dynamic configuration management tool in Spring Boot and Spring Cloud applications, you need dependence of them.
+## java-chassis 2.0.0 and above with spring boot 2.0 and above [example](https://github.com/apache/servicecomb-samples/tree/master/java-chassis-samples/metrics-extend-healthcheck)
+* java-chassis-spring-boot-starter-standalone
+For standalone applications:
-* spring-boot-starter-registry
+POM dependency：
-Access to the service center. When you need to use the service center as a service registration and discovery management tool in Spring Boot and Spring Cloud applications, you need dependence of them.
+```
+ <dependencies>
+ <dependency>
+ <groupId>org.apache.servicecomb</groupId>
+ <artifactId>java-chassis-spring-boot-starter-standalone</artifactId>
+ </dependency>
+ </dependencies>
+```
+* java-chassis-spring-boot-starter-servlet
+For web applications:
-* spring-boot-starter-discovery
+POM dependency：
-Adapt to the Spring Cloud's DiscoveryClient interface. When using @EnableDiscoveryClient in Spring Cloud, you need dependence of them.
+```
+ <dependencies>
+ <dependency>
+ <groupId>org.apache.servicecomb</groupId>
+ <artifactId>java-chassis-spring-boot-starter-servlet</artifactId>
+ </dependency>
+ </dependencies>
+```
+dependency management for applications：
+```
+ <dependencyManagement>
+ <dependencies>
+ <dependency>
+ <groupId>org.apache.servicecomb</groupId>
+ <artifactId>java-chassis-dependencies</artifactId>
+ <version>2.0.0-SNAPSHOT</version>
+ <type>pom</type>
+ <scope>import</scope>
+ </dependency>
+ </dependencies>
+ </dependencyManagement>
+```
+
+## java-chassis 1.3.0 and above with spring boot 2.0 and above [example](https://github.com/apache/servicecomb-samples/tree/1.3.0/dependency_management/springboot2)
+
+* spring-boot2-starter-standalone
+
+For standalone applications:
+
+POM dependency：
+
+```
+ <dependencies>
+ <dependency>
+ <groupId>org.apache.servicecomb</groupId>
+ <artifactId>spring-boot2-starter-standalone</artifactId>
+ </dependency>
+ </dependencies>
+```
+
+* spring-boot2-starter-servlet
+
+For web applications:
+
+POM dependency：
+
+```
+ <dependencies>
+ <dependency>
+ <groupId>org.apache.servicecomb</groupId>
+ <artifactId>spring-boot2-starter-servlet</artifactId>
+ </dependency>
+ </dependencies>
+```
+
+dependency management for applications：
+
+```
+ <dependencyManagement>
+ <dependencies>
+ <dependency>
+ <groupId>org.apache.servicecomb</groupId>
+ <artifactId>java-chassis-dependencies-springboot2</artifactId>
+ <version>1.3.0</version>
+ <type>pom</type>
+ <scope>import</scope>
+ </dependency>
+ </dependencies>
+ </dependencyManagement>
+```
+
+## java-chassis 1.3.0 and above with spring boot 1.0 and above [example](https://github.com/apache/servicecomb-samples/tree/1.3.0/dependency_management/springboot1)
* spring-boot-starter-provider
-Enable the core functionality of java chassis via @EnableServiceComb in Spring Boot. This feature can be used for "JAVA application mode" and "Web development mode". In the "Web development mode", the web environment is disabled by spring.main.web-environment=false. Therefore, this module is mainly to solve the problem of "JAVA application mode".
+For standalone applications:
+POM dependency：
+```
+ <dependencies>
+ <dependency>
+ <groupId>org.apache.servicecomb</groupId>
+ <artifactId>spring-boot-starter-provider</artifactId>
+ </dependency>
+ </dependencies>
+```
* spring-boot-starter-transport
-Enable the core functionality of the java chassis via @EnableServiceComb in Spring Boot and enable the RestServlet for the java chassis. Used in "Web development mode".
\ No newline at end of file
+For web applications:
+
+POM dependency：
+
+```
+ <dependencies>
+ <dependency>
+ <groupId>org.apache.servicecomb</groupId>
+ <artifactId>spring-boot-starter-transport</artifactId>
+ </dependency>
+ </dependencies>
+```
+
+dependency management for applications：
+
+```
+ <dependencyManagement>
+ <dependencies>
+ <dependency>
+ <groupId>org.apache.servicecomb</groupId>
+ <artifactId>java-chassis-dependencies-springboot1</artifactId>
+ <version>1.3.0</version>
+ <type>pom</type>
+ <scope>import</scope>
+ </dependency>
+ <!-- spring boot 1.5.14.RELEASE use a low version of validation-api, must override it -->
+ <dependency>
+ <groupId>javax.validation</groupId>
+ <artifactId>validation-api</artifactId>
+ <version>2.0.0.Final</version>
+ </dependency>
+ </dependencies>
+ </dependencyManagement>
+```
+
diff --git a/java-chassis-reference/zh_CN/SUMMARY.md b/java-chassis-reference/zh_CN/SUMMARY.md
index 2e1b08d..fd4fca5 100644
--- a/java-chassis-reference/zh_CN/SUMMARY.md
+++ b/java-chassis-reference/zh_CN/SUMMARY.md
@@ -78,12 +78,11 @@
* [微服务安全](catalog/security.md)
* [使用TLS通信](security/tls.md)
* [使用RSA认证](security/shi-yong-rsa-ren-zheng.md)
-* [在Spring Boot中使用java chassis](using-java-chassis-in-spring-boot.md)
- * [提供的组件说明](using-java-chassis-in-spring-boot/components-for-spring-boot.md)
+* [在Spring Boot中使用java chassis](using-java-chassis-in-spring-boot/using-java-chassis-in-spring-boot.md)
+ * [提供的spring boot starter说明](using-java-chassis-in-spring-boot/components-for-spring-boot.md)
* [JAVA应用方式开发步骤](using-java-chassis-in-spring-boot/java-application.md)
* [Web开发方式开发步骤](using-java-chassis-in-spring-boot/web-application.md)
- * [JAVA应用方式和Web开发方式的区别](using-java-chassis-in-spring-boot/diff-between-java-web.md)
- * [Spring MVC模式的差异](using-java-chassis-in-spring-boot/diff-spring-mvc.md)
+ * [Spring MVC开发习惯的差异](using-java-chassis-in-spring-boot/diff-spring-mvc.md)
* [处理链参考](references-handlers/intruduction.md)
* [负载均衡](references-handlers/loadbalance.md)
* [公钥认证](references-handlers/publickey.md)
diff --git a/java-chassis-reference/zh_CN/using-java-chassis-in-spring-boot.md b/java-chassis-reference/zh_CN/using-java-chassis-in-spring-boot.md
deleted file mode 100644
index e782023..0000000
--- a/java-chassis-reference/zh_CN/using-java-chassis-in-spring-boot.md
+++ /dev/null
@@ -1,30 +0,0 @@
-[Spring Boot](https://projects.spring.io/spring-boot/)可以让开发者能够更加快速的构建Spring应用。主要提供了如下功能：
-
-1. 创建独立可执行的Spring应用。通过将应用程序打包为jar，就可以通过java -jar来执行应用程序。
-
-2. 内嵌Tomcat, Jetty等WEB服务器，而不需要开发者打包war。
-
-3. 提供starter简化maven依赖关系配置。
-
-将Spring Boot用于微服务开发，可以极大的简化开发者配置和部署。java-chassis提供了完善的的服务治理能力、良好的跨语言特性和高效的异步通信能力，通过使用java chassis，可以快速启用各种满足商业运维需要的功能。
-
-本文将介绍如何在Spring Boot中集成和使用。开发者通常会以如下几种方式使用Spring Boot：
-
-1. JAVA应用方式：引入spring-boot-starter，开发普通JAVA应用。该应用不会启动WEB服务器。
-
-2. Web开发方式：引入spring-boot-starter-web，开发Web应用。该应用会包含一个内嵌的Tomcat或者Jetty服务器，并且使用The Spring Web MVC framework（简称Spring MVC）开发REST接口。
-
-在两种情况下，都可以集成java chassis，原理图如下：
-
-* JAVA应用方式
-
-
-
-这种集成方式相对简单，相当于直接将java chassis通过Spring Boot应用拉起，不涉及任何改造和变化。
-
-* Web开发方式
-
-
-
-该集成方式的本质是将Spring MVC的DispatcherServlet替换为java chassis的RestServlet。
-
diff --git a/java-chassis-reference/zh_CN/using-java-chassis-in-spring-boot/components-for-spring-boot.md b/java-chassis-reference/zh_CN/using-java-chassis-in-spring-boot/components-for-spring-boot.md
index fb085df..fbaae58 100644
--- a/java-chassis-reference/zh_CN/using-java-chassis-in-spring-boot/components-for-spring-boot.md
+++ b/java-chassis-reference/zh_CN/using-java-chassis-in-spring-boot/components-for-spring-boot.md
@@ -1,30 +1,154 @@
-针对Spring Boot、Spring Cloud，提供了如下几个组件：
+# java-chassis 提供的spring boot starter说明
-* spring-boot-starter-configuration
+java-chassis提供了spring-boot-starter，方便在spring boot中集成java-chassis。由于早期命名没考虑规范性，在使用这些starter之前，需要注意区分使用的java-chassis版本和spring boot版本。
-接入配置中心。当需要在Spring Boot、Spring Cloud应用中，使用配置中心作为动态配置管理工具的时候，需要依赖。
+## java-chassis 2.0.0 以上 + spring boot 2.0以上 [例子](https://github.com/apache/servicecomb-samples/tree/master/java-chassis-samples/metrics-extend-healthcheck)
+* java-chassis-spring-boot-starter-standalone
+"JAVA应用方式"使用。
-* spring-boot-starter-registry
+POM依赖：
-接入服务中心。当需要在Spring Boot、Spring Cloud应用中，使用服务中心作为服务注册、发现管理工具的时候，需要依赖。
+```
+ <dependencies>
+ <dependency>
+ <groupId>org.apache.servicecomb</groupId>
+ <artifactId>java-chassis-spring-boot-starter-standalone</artifactId>
+ </dependency>
+ </dependencies>
+```
+* java-chassis-spring-boot-starter-servlet
+"Web开发方式"使用。
-* spring-boot-starter-discovery
+POM依赖：
-适配Spring Cloud的DiscoveryClient接口。当在Spring Cloud中使用@EnableDiscoveryClient时，需要依赖。
+```
+ <dependencies>
+ <dependency>
+ <groupId>org.apache.servicecomb</groupId>
+ <artifactId>java-chassis-spring-boot-starter-servlet</artifactId>
+ </dependency>
+ </dependencies>
+```
+两种方式的dependency management配置如下：
+```
+ <dependencyManagement>
+ <dependencies>
+ <dependency>
+ <groupId>org.apache.servicecomb</groupId>
+ <artifactId>java-chassis-dependencies</artifactId>
+ <version>2.0.0-SNAPSHOT</version>
+ <type>pom</type>
+ <scope>import</scope>
+ </dependency>
+ </dependencies>
+ </dependencyManagement>
+```
+
+## java-chassis 1.3.x + spring boot 2.0 [例子](https://github.com/apache/servicecomb-samples/tree/1.3.0/dependency_management/springboot2)
+
+* spring-boot2-starter-standalone
+
+"JAVA应用方式"使用。
+
+POM依赖：
+
+```
+ <dependencies>
+ <dependency>
+ <groupId>org.apache.servicecomb</groupId>
+ <artifactId>spring-boot2-starter-standalone</artifactId>
+ </dependency>
+ </dependencies>
+```
+
+* spring-boot2-starter-servlet
+
+"Web开发方式"使用。
+
+POM依赖：
+
+```
+ <dependencies>
+ <dependency>
+ <groupId>org.apache.servicecomb</groupId>
+ <artifactId>spring-boot2-starter-servlet</artifactId>
+ </dependency>
+ </dependencies>
+```
+
+两种方式的dependency management配置如下：
+
+```
+ <dependencyManagement>
+ <dependencies>
+ <dependency>
+ <groupId>org.apache.servicecomb</groupId>
+ <artifactId>java-chassis-dependencies-springboot2</artifactId>
+ <version>1.3.0</version>
+ <type>pom</type>
+ <scope>import</scope>
+ </dependency>
+ </dependencies>
+ </dependencyManagement>
+```
+
+## java-chassis 1.3.x + spring boot 1.0 [例子](https://github.com/apache/servicecomb-samples/tree/1.3.0/dependency_management/springboot1)
* spring-boot-starter-provider
-在Spring Boot中通过@EnableServiceComb启用java chassis的核心功能。这个功能可以用于“JAVA应用方式”和”Web开发方式“。 在”Web开发方式”中，通过spring.main.web-environment=false禁用了Web环境。因此，这个模块主要是解决”JAVA应用方式“的问题。
+"JAVA应用方式"使用。
+POM依赖：
+```
+ <dependencies>
+ <dependency>
+ <groupId>org.apache.servicecomb</groupId>
+ <artifactId>spring-boot-starter-provider</artifactId>
+ </dependency>
+ </dependencies>
+```
* spring-boot-starter-transport
-在Spring Boot中通过@EnableServiceComb启用java chassis的核心功能，并启用java chassis的RestServlet。用于” Web开发方式“。
+"Web开发方式"使用。
+
+POM依赖：
+
+```
+ <dependencies>
+ <dependency>
+ <groupId>org.apache.servicecomb</groupId>
+ <artifactId>spring-boot-starter-transport</artifactId>
+ </dependency>
+ </dependencies>
+```
+
+两种方式的dependency management配置如下：
+
+```
+ <dependencyManagement>
+ <dependencies>
+ <dependency>
+ <groupId>org.apache.servicecomb</groupId>
+ <artifactId>java-chassis-dependencies-springboot1</artifactId>
+ <version>1.3.0</version>
+ <type>pom</type>
+ <scope>import</scope>
+ </dependency>
+ <!-- spring boot 1.5.14.RELEASE use a low version of validation-api, must override it -->
+ <dependency>
+ <groupId>javax.validation</groupId>
+ <artifactId>validation-api</artifactId>
+ <version>2.0.0.Final</version>
+ </dependency>
+ </dependencies>
+ </dependencyManagement>
+```
diff --git a/java-chassis-reference/zh_CN/using-java-chassis-in-spring-boot/diff-between-java-web.md b/java-chassis-reference/zh_CN/using-java-chassis-in-spring-boot/diff-between-java-web.md
deleted file mode 100644
index 180d66e..0000000
--- a/java-chassis-reference/zh_CN/using-java-chassis-in-spring-boot/diff-between-java-web.md
+++ /dev/null
@@ -1,2 +0,0 @@
-两种开发方式都会启用java chassis的全量功能，JAVA应用方式运行于独立的HTTP服务器（基于vert.x构建）上，性能上存在很大的优势。Web开发方式运行于Tomcat或者其他内置的Web服务器之上，作为一个Servlet接收请求，因此在开发过程中，可以使用Web容器提供的一些功能，比如提供页面服务，使用Filter等。当应用只需要提供REST服务，并且对性能要求很高的场景，建议使用JAVA应用方式。
-
diff --git a/java-chassis-reference/zh_CN/using-java-chassis-in-spring-boot/diff-spring-mvc.md b/java-chassis-reference/zh_CN/using-java-chassis-in-spring-boot/diff-spring-mvc.md
index a0e9c13..4da5a9f 100644
--- a/java-chassis-reference/zh_CN/using-java-chassis-in-spring-boot/diff-spring-mvc.md
+++ b/java-chassis-reference/zh_CN/using-java-chassis-in-spring-boot/diff-spring-mvc.md
@@ -1,4 +1,6 @@
-java chassis支持使用Spring MVC提供的标签\(org.springframework.web.bind.annotation\)来声明REST接口，但是两者是独立的实现，而且有不一样的设计目标。java chassis的目标是提供跨语言、支持多通信协议的框架，因此去掉了Spring MVC中一些对跨语言支持不是很好的特性，也不支持特定运行框架强相关的特性，比如直接访问Servlet协议定义的HttpServletRequest。下面是一些显著的差别。
+# Spring MVC开发习惯的差异
+
+java chassis支持使用Spring MVC提供的标签\(org.springframework.web.bind.annotation\)来声明REST接口，但是两者是独立的实现，而且有不一样的设计目标。java chassis的目标是提供跨语言、支持多通信协议的框架，因此去掉了Spring MVC中一些对跨语言支持不是很好的特性，也不支持特定运行框架强相关的特性，比如直接访问Servlet协议定义的HttpServletRequest。java-chassis支持的Spring MVC标签是spring boot的子集， 下面是一些显著的差别。
* 服务声明方式
@@ -26,48 +28,11 @@
public void postData(HttpServletRequest rquest)
```
-上面的类型在java chassis都不提供支持。因为java chassis会根据接口定义生成契约，从上面的接口定义，如果不结合实际的实现代码或者额外的开发文档说明，无法直接生成契约。也就是站在浏览器的REST视角，不知道如何在body里面构造消息内容。
+java chassis不支持上诉类型。因为java chassis会根据接口定义生成契约，从上面的接口定义，如果不结合实际的实现代码或者额外的开发文档说明，无法直接生成契约。
-为了支持快速开发，java chassis的数据类型限制也在不停的扩充，比如支持HttpServletRequest，但是实际在使用的时候，他们与WEB服务器的语义是不一样的，比如不能直接操作流。因此建议开发者在的使用场景下，尽可能使用契约能够描述的类型，让代码阅读性更好。
+为了支持快速开发，java chassis的数据类型限制也在不停的扩充，比如支持HttpServletRequest，但是实际在使用的时候，他们与WEB服务器的语义是不一样的，比如不能直接操作流。因此建议开发者在的使用场景下，尽可能使用契约能够描述的类型，让代码阅读性更好。此外，spring针对DispatcherServlet做了大量的扩展，这些扩展对于java-chassis的RestDispatcher是不适用的。
-java chassis在数据类型的支持方面的更多说明，请参考"支持的数据类型"章节。
+java chassis 在Spring MVC方面的更多开发支持，可以参考[用SpringMVC 开发微服务](../build-provider/springmvc.md)。
-* 常用标签支持
-下面是java chassis对于Spring MVC常用标签的支持情况。
-
-| 标签名称 | 是否支持 | 说明 |
-| :--- | :--- | :--- |
-| RequestMapping | 是 | |
-| GetMapping | 是 | |
-| PutMapping | 是 | |
-| PostMapping | 是 | |
-| DeleteMapping | 是 | |
-| PatchMapping | 是 | |
-| RequestParam | 是 | |
-| CookieValue | 是 | |
-| PathVariable | 是 | |
-| RequestHeader | 是 | |
-| RequestBody | 是 | 目前支持application/json，plain/text |
-| RequestPart | 是 | 用于文件上传的场景，对应的标签还有Part、MultipartFile |
-| ResponseBody | 否 | 返回值缺省都是在body返回 |
-| ResponseStatus | 否 | 可以通过ApiResponse指定返回的错误码 |
-| RequestAttribute | 否 | Servlet协议相关的标签 |
-| SessionAttribute | 否 | Servlet协议相关的标签 |
-| MatrixVariable | 否 | |
-| ModelAttribute | 否 | |
-| ControllerAdvice | 否 | |
-| CrossOrigin | 否 | |
-| ExceptionHandler | 否 | |
-| InitBinder | 否 | |
-
-* 其他
-
-不支持在GET方法中使用POJO对象进行参数映射
-
-比如：public void getOperation\(Person p\)
-
-不支持在GET方法中使用Map映射所有可能的参数
-
-比如：public void getOperation\(Map<String,String> p\)
diff --git a/java-chassis-reference/zh_CN/using-java-chassis-in-spring-boot/java-application.md b/java-chassis-reference/zh_CN/using-java-chassis-in-spring-boot/java-application.md
index 1d6dd1d..f2f5f4f 100644
--- a/java-chassis-reference/zh_CN/using-java-chassis-in-spring-boot/java-application.md
+++ b/java-chassis-reference/zh_CN/using-java-chassis-in-spring-boot/java-application.md
@@ -1,47 +1,15 @@
+# JAVA应用方式开发步骤
+
+
使用JAVA方式集成，为Spring Boot应用增加了一个高效的HTTP服务器和REST开发框架。这种方式集成非常简单。只需要在项目中引入相关依赖，并且使用@EnableServiceComb注解即可。
-本项目[代码示例](https://github.com/huaweicse/servicecomb-java-chassis-samples/tree/master/spring-boot-simple)
-
-
-
* 引入依赖
-依赖关系中增加spring-boot-starter-provider，即可引入java chassis的核心功能。引入hibernate-validator的目的是spring boot会检测validation-api的实现类，检测不到会无法启动。
-
-```
-<dependencyManagement>
- <dependencies>
- <dependency>
- <groupId>org.apache.servicecomb</groupId>
- <artifactId>java-chassis-dependencies</artifactId>
- <version>1.0.0-m1</version>
- <type>pom</type>
- <scope>import</scope>
- </dependency>
- </dependencies>
-</dependencyManagement>
-
-<dependencies>
- <dependency>
- <groupId>org.apache.servicecomb</groupId>
- <artifactId>spring-boot-starter-provider</artifactId>
- </dependency>
- <dependency>
- <groupId>org.springframework.boot</groupId>
- <artifactId>spring-boot-starter</artifactId>
- </dependency>
- <dependency>
- <groupId>org.hibernate</groupId>
- <artifactId>hibernate-validator</artifactId>
- </dependency>
-</dependencies>
-```
-
-
+参考[java-chassis 提供的spring boot starter说明](components-for-spring-boot.md)，注意区分使用的java-chassis版本和spring boot版本。
* 启用java chassis的核心功能
-在启动类前面增加@EnableServiceComb即可。
+在启动类前面增加@EnableServiceComb。
```
@SpringBootApplication
@@ -53,16 +21,12 @@
}
```
-
-
通过以上配置，就可以完整使用java chassis提供的所有功能，使用java chassis开发REST服务，并开启各种治理功能。
-
* 配置微服务
-通过microservice.yaml文件可以定制微服务的信息，包括应用名称、微服务名称、监听的地址和端口等。
-
+集成以后，可以在microservice.yaml中增加应用配置，也可以使用spring boot的application.yml增加配置，application.yml的配置优先级高于microservice.yaml。 为了保持spring boot的开发习惯，建议开发者配置文件使用application.yml, 可以在application.yml中定制微服务的信息，包括应用名称、微服务名称、监听的地址和端口等。
集成java chassis后，可以通过它的方式开发REST接口：
@@ -78,9 +42,5 @@
}
```
-
-
然后可以通过：http://localhost:9093/hello?name=world来访问。
-
-
diff --git a/java-chassis-reference/zh_CN/using-java-chassis-in-spring-boot/spring-mvcmo-shi-de-cha-yi.md b/java-chassis-reference/zh_CN/using-java-chassis-in-spring-boot/spring-mvcmo-shi-de-cha-yi.md
deleted file mode 100644
index e69de29..0000000
--- a/java-chassis-reference/zh_CN/using-java-chassis-in-spring-boot/spring-mvcmo-shi-de-cha-yi.md
+++ /dev/null
diff --git a/java-chassis-reference/zh_CN/using-java-chassis-in-spring-boot/using-java-chassis-in-spring-boot.md b/java-chassis-reference/zh_CN/using-java-chassis-in-spring-boot/using-java-chassis-in-spring-boot.md
new file mode 100644
index 0000000..2ef5dbb
--- /dev/null
+++ b/java-chassis-reference/zh_CN/using-java-chassis-in-spring-boot/using-java-chassis-in-spring-boot.md
@@ -0,0 +1,37 @@
+# 在Spring Boot中使用java chassis
+
+[Spring Boot](https://projects.spring.io/spring-boot/)可以让开发者能够更加快速的构建Spring应用。主要提供了如下功能：
+
+1. 创建独立可执行的Spring应用。通过将应用程序打包为jar，就可以通过java -jar来执行应用程序。
+
+2. 内嵌Tomcat, Jetty等WEB服务器，而不需要开发者打包war。
+
+3. 提供starter简化maven依赖关系配置。
+
+将Spring Boot用于微服务开发，可以极大的简化开发者配置和部署。java-chassis提供了完善的的服务治理能力、良好的跨语言特性和高效的异步通信能力，通过使用java chassis，可以快速启用各种满足商业运维需要的功能。
+
+本文将介绍如何在Spring Boot中集成和使用。开发者通常会以如下几种方式使用Spring Boot：
+
+1. JAVA应用方式：引入spring-boot-starter，开发普通JAVA应用，该应用不会启动WEB服务器。
+
+2. Web开发方式：引入spring-boot-starter-web，开发Web应用，该应用会包含一个内嵌的Tomcat或者Jetty服务器，并且使用The Spring Web MVC framework（简称Spring MVC）开发REST接口。
+
+## java-chassis 集成 spring boot的方式
+
+在两种情况下，都可以集成java chassis，原理图如下：
+
+* JAVA应用方式
+
+
+
+这种集成方式相对简单，相当于直接将java-chassis通过Spring Boot应用拉起，通过java-chassis 提供REST/RPC服务。
+
+* Web开发方式
+
+
+
+该集成方式的本质是将Spring MVC的DispatcherServlet替换为java chassis的RestServlet，通过java-chassis提供REST/RPC服务。
+
+## 两种集成方式的区别
+
+两种开发方式都会启用java chassis的全量功能，JAVA应用方式运行于独立的HTTP服务器（基于vert.x构建）上，性能上存在很大的优势。Web开发方式运行于Tomcat或者其他内置的Web服务器之上，作为一个Servlet接收请求，因此在开发过程中，可以使用Web容器提供的一些功能，比如提供页面服务，使用Filter等。当应用只需要提供REST服务，并且对性能要求很高的场景，建议使用JAVA应用方式。
diff --git a/java-chassis-reference/zh_CN/using-java-chassis-in-spring-boot/web-application.md b/java-chassis-reference/zh_CN/using-java-chassis-in-spring-boot/web-application.md
index 74144ca..2b685bf 100644
--- a/java-chassis-reference/zh_CN/using-java-chassis-in-spring-boot/web-application.md
+++ b/java-chassis-reference/zh_CN/using-java-chassis-in-spring-boot/web-application.md
@@ -1,27 +1,27 @@
Web开发方式和JAVA应用方式的开发步骤基本类似。
-本项目[代码示例](https://github.com/huaweicse/servicecomb-java-chassis-samples/tree/master/spring-boot-web)
-
-
主要有如下区别：
* JAVA应用方式基于spring-boot-starter，而Web开发方式基于spring-boot-starter-web。
-* JAVA应用方式依赖spring-boot-starter-provider，而Web开发方式依赖spring-boot-starter-transport。spring-boot-starter-web已经携带了hibernate-validator，不需要额外依赖。
-
-* 在启动函数中，Web开发方式可以通过声明
+* Web开发方式通过@EnableServiceComb会启用org.apache.servicecomb.transport.rest.servlet.RestServlet, 可以通过声明
```
@SpringBootApplication(exclude=DispatcherServletAutoConfiguration.class)
```
-来关闭org.springframework.web.servlet.DispatcherServlet，通过@EnableServiceComb会启用org.apache.servicecomb.transport.rest.servlet.RestServlet。虽然排除DispatcherServlet不是必须的，但是大多数场景一个微服务里面存在多个REST框架都不是很好的主意，会造成很多使用上的误解。
+来关闭org.springframework.web.servlet.DispatcherServlet。虽然排除DispatcherServlet不是必须的，但是大多数场景一个微服务里面存在多个REST框架都不是很好的主意，容易误用。
-* 在microservice.yaml文件中通过配置项servicecomb.rest.servlet.urlPattern来指定RestServlet的URL根路径。并且配置项servicecomb.rest.address里面的监听端口，必须和tomcat监听的端口保持一致（默认是8080，可以通过application.yml中增加server.port修改）
+***注意：*** 有些spring boot版本在加上这个配置以后，启动会失败。也可以不关闭DispatcherServlet，而是将他们指定为不同的URL前缀，让这两个Servlet共存。这种方式在一些历史遗留系统改造，必须使用DispatcherServlet发布REST接口的场景非常有用。
+```
+## DispatcherServlet path
+server.servlet.path: /ui
+## RestServlet path
+servicecomb.rest.servlet.urlPattern: /api/*
+```
-
-
+* 通过配置项servicecomb.rest.servlet.urlPattern来指定RestServlet的URL根路径。并且配置项servicecomb.rest.address里面的监听端口，必须和tomcat监听的端口保持一致（默认是8080，可以通过application.yml中增加server.port修改）
集成java chassis后，可以通过它的方式开发REST接口：
