Using java chassis in spring boot dir translation #40

DeanLee2013 · 2018-08-21T05:51:08Z

No description provided.

…ents-for-spring-boot.md

…/diff-between-java-web.md

…pring-mvc.md

…/java-application.md

…/web-application.md

zhengyangyong · 2018-08-22T06:32:44Z

java-chassis-reference/en_US/using-java-chassis-in-spring-boot/components-for-spring-boot.md

 * spring-boot-starter-configuration

-接入配置中心。当需要在Spring Boot、Spring Cloud应用中，使用配置中心作为动态配置管理工具的时候，需要依赖。
+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 to rely on it.


rely -> depend

zhengyangyong · 2018-08-22T06:33:43Z

java-chassis-reference/en_US/using-java-chassis-in-spring-boot/components-for-spring-boot.md

 * spring-boot-starter-provider

-在Spring Boot中通过@EnableServiceComb启用java chassis的核心功能。这个功能可以用于“JAVA应用方式”和”Web开发方式“。 在”Web开发方式”中，通过spring.main.web-environment=false禁用了Web环境。因此，这个模块主要是解决”JAVA应用方式“的问题。
+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 method", the web environment is disabled by spring.main.web-environment=false. Therefore, this module is mainly to solve the problem of "JAVA application mode".


Web development method -> Web development mode

zhengyangyong · 2018-08-22T06:34:12Z

java-chassis-reference/en_US/using-java-chassis-in-spring-boot/components-for-spring-boot.md


-在Spring Boot中通过@EnableServiceComb启用java chassis的核心功能，并启用java chassis的RestServlet。用于” Web开发方式“。
-
+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 methods".


Web development methods -> Web development mode

zhengyangyong · 2018-08-22T06:35:51Z

java-chassis-reference/en_US/using-java-chassis-in-spring-boot/diff-between-java-web.md

@@ -1,2 +1 @@
-两种开发方式都会启用java chassis的全量功能，JAVA应用方式运行于独立的HTTP服务器（基于vert.x构建）上，性能上存在很大的优势。Web开发方式运行于Tomcat或者其他内置的Web服务器之上，作为一个Servlet接收请求，因此在开发过程中，可以使用Web容器提供的一些功能，比如提供页面服务，使用Filter等。当应用只需要提供REST服务，并且对性能要求很高的场景，建议使用JAVA应用方式。
-
+Both development methods will enable the full functionality of the java chassis. The JAVA application mode runs on a separate HTTP server (based on vert.x build), which has great advantages in performance. The web development method runs on Tomcat or other built-in web servers and receives requests as a servlet. Therefore, during the development process, you can use some functions provided by the web container, such as providing page services and using Filter. When the application only needs to provide REST services, and performance requirements are high, it is recommended to use a JAVA application.


去掉build
JAVA application - JAVA application mode

zhengyangyong · 2018-08-22T06:41:09Z

java-chassis-reference/en_US/using-java-chassis-in-spring-boot/diff-spring-mvc.md

+Public void postData(@RequestBody Object data)
+// Interface definition
+Public void postData(@RequestBody IPerson interfaceData)
+// no generic type of the specified type


no generic type of the specified type 这个难以理解，修改一下

zhengyangyong · 2018-08-22T06:46:11Z

java-chassis-reference/en_US/using-java-chassis-in-spring-boot/diff-spring-mvc.md

+For more information on java chassis support for data types, please refer to the "Supported Data Types" section.

-* 常用标签支持
+* Common label support


标签应该翻译为Annotation，不是label

那中文应该是注解才对，这个需要改下。标签当然是label

zhengyangyong · 2018-08-22T06:47:59Z

java-chassis-reference/en_US/using-java-chassis-in-spring-boot/java-application.md

@@ -1,12 +1,12 @@
-使用JAVA方式集成，为Spring Boot应用增加了一个高效的HTTP服务器和REST开发框架。这种方式集成非常简单。只需要在项目中引入相关依赖，并且使用@EnableServiceComb标签即可。
+Using JAVA integration, an efficient HTTP server and REST development framework has been added for Spring Boot applications. This way of integration is very simple. Just introduce the relevant dependencies into the project and use the @EnableServiceComb tag.


tag -> Annotation

zhengyangyong · 2018-08-22T06:49:37Z

java-chassis-reference/en_US/using-java-chassis-in-spring-boot/java-application.md

+* Configure microservices

-通过microservice.yaml文件可以定制微服务的信息，包括应用名称、微服务名称、监听的地址和端口等。
+The microservice.yaml file allows you to customize the microservice information, including the application name, microservice name, listener address and port.


application name -> application id

zhengyangyong · 2018-08-22T06:50:25Z

java-chassis-reference/en_US/using-java-chassis-in-spring-boot/web-application.md

@@ -1,29 +1,29 @@
-Web开发方式和JAVA应用方式的开发步骤基本类似。
+The development steps of the web development method and the JAVA application method are similar.


method -> mode

zhengyangyong · 2018-08-22T06:51:06Z

java-chassis-reference/en_US/using-java-chassis-in-spring-boot/web-application.md



-主要有如下区别：
+There are mainly the following differences:


There are mainly the following differences: 这句话有点奇怪？

zhengyangyong · 2018-08-22T06:51:42Z

java-chassis-reference/en_US/using-java-chassis-in-spring-boot/web-application.md

+* JAVA application is based on spring-boot-starter, and web development is based on spring-boot-starter-web.

-* JAVA应用方式依赖spring-boot-starter-provider，而Web开发方式依赖spring-boot-starter-transport。spring-boot-starter-web已经携带了hibernate-validator，不需要额外依赖。
+* JAVA application relies on spring-boot-starter-provider, while web development relies on spring-boot-starter-transport. Spring-boot-starter-web already carries hibernate-validator and does not require additional dependencies.


relies ->depend

zhengyangyong · 2018-08-22T06:53:04Z

java-chassis-reference/en_US/using-java-chassis-in-spring-boot/web-application.md

-来关闭org.springframework.web.servlet.DispatcherServlet，通过@EnableServiceComb会启用org.apache.servicecomb.transport.rest.servlet.RestServlet。虽然排除DispatcherServlet不是必须的，但是大多数场景一个微服务里面存在多个REST框架都不是很好的主意，会造成很多使用上的误解。
-
-* 在microservice.yaml文件中通过配置项servicecomb.rest.servlet.urlPattern来指定RestServlet的URL根路径。并且配置项servicecomb.rest.address里面的监听端口，必须和tomcat监听的端口保持一致（默认是8080，可以通过application.yml中增加server.port修改）
+To close org.springframework.web.servlet.DispatcherServlet, enable org.apache.servicecomb.transport.rest.servlet.RestServlet via @EnableServiceComb. Although it is not necessary to exclude the DispatcherServlet, it is not a good idea to have multiple REST frameworks in a microservice in most scenarios, which will cause many misunderstandings in use.


misunderstandings -> confusion

DeanLee2013 · 2018-08-23T10:59:02Z

@zhengyangyong all done

zhengyangyong · 2018-08-24T02:06:10Z

please rebase and solve conflicts

crystaldust · 2018-08-22T06:34:49Z

java-chassis-reference/en_US/using-java-chassis-in-spring-boot/web-application.md

+1. Replace RestController with RestSchema

-如果业务代码不是新开发，而是基于Spring MVC做的开发，现在java chassis基于做改造，还需要注意在禁用DispatcherServlet后，和其有关的功能特性将不再生效。
+2. Need to display the declaration @RequestMapping


Declare @RequestMapping explicitly.

crystaldust · 2018-08-22T06:35:25Z

java-chassis-reference/en_US/using-java-chassis-in-spring-boot/web-application.md

-1. 通过RestSchema替换RestController
+You can see that the tags used are mostly the same as Spring MVC. But there are also a few different places, such as:

-2. 需要显示声明@RequestMapping


显式声明

crystaldust · 2018-08-22T06:38:31Z

java-chassis-reference/en_US/using-java-chassis-in-spring-boot/web-application.md

-在下面的章节，还会详细介绍在Spring MVC模式下两者的区别。
+If the business code is not a new development but based on the development of Spring MVC, now the java chassis is based on the transformation, but also need to pay attention to the disabling of the DispatcherServlet, and its related features will no longer take effect.

+In the following sections, the differences between the two in Spring MVC mode are also detailed.


In the following sections, we'll introduce some details of the differences in Spring MVC mode.

In the following sections, about web JAVA application mode and web development mode, we'll introduce some details of the differences in Spring MVC mode.

…/web-application.md with comments

DeanLee2013 · 2018-08-27T08:44:22Z

all done

DeanLee added 5 commits August 20, 2018 15:25

java-chassis-reference/en_US/using-java-chassis-in-spring-boot/compon…

77685a1

…ents-for-spring-boot.md

update java-chassis-reference/en_US/using-java-chassis-in-spring-boot…

dbfc705

…/diff-between-java-web.md

java-chassis-reference/en_US/using-java-chassis-in-spring-boot/diff-s…

f89fcee

…pring-mvc.md

update java-chassis-reference/en_US/using-java-chassis-in-spring-boot…

2584121

…/java-application.md

update java-chassis-reference/en_US/using-java-chassis-in-spring-boot…

5bafc75

…/web-application.md

zhengyangyong reviewed Aug 22, 2018

View reviewed changes

lidian added 4 commits August 23, 2018 17:24

Merge branch 'master' into using-java-chassis-in-spring-boot

8d381d7

fix desc issues :java app mode

8d6dbba

fix desc diff-spring-mvc.md tag -> annotation

a5ff453

fix issue about tag -> annotation of java-application.md

203d652

zhengyangyong approved these changes Aug 24, 2018

View reviewed changes

crystaldust reviewed Aug 25, 2018

View reviewed changes

update java-chassis-reference/en_US/using-java-chassis-in-spring-boot…

ced9dbc

…/web-application.md with comments

WillemJiang merged commit 31e6c81 into apache:master Aug 27, 2018


		在Spring Boot中通过@EnableServiceComb启用java chassis的核心功能，并启用java chassis的RestServlet。用于” Web开发方式“。

		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 methods".

		@@ -1,2 +1 @@
		两种开发方式都会启用java chassis的全量功能，JAVA应用方式运行于独立的HTTP服务器（基于vert.x构建）上，性能上存在很大的优势。Web开发方式运行于Tomcat或者其他内置的Web服务器之上，作为一个Servlet接收请求，因此在开发过程中，可以使用Web容器提供的一些功能，比如提供页面服务，使用Filter等。当应用只需要提供REST服务，并且对性能要求很高的场景，建议使用JAVA应用方式。

		Both development methods will enable the full functionality of the java chassis. The JAVA application mode runs on a separate HTTP server (based on vert.x build), which has great advantages in performance. The web development method runs on Tomcat or other built-in web servers and receives requests as a servlet. Therefore, during the development process, you can use some functions provided by the web container, such as providing page services and using Filter. When the application only needs to provide REST services, and performance requirements are high, it is recommended to use a JAVA application.

		@@ -1,12 +1,12 @@
		使用JAVA方式集成，为Spring Boot应用增加了一个高效的HTTP服务器和REST开发框架。这种方式集成非常简单。只需要在项目中引入相关依赖，并且使用@EnableServiceComb标签即可。
		Using JAVA integration, an efficient HTTP server and REST development framework has been added for Spring Boot applications. This way of integration is very simple. Just introduce the relevant dependencies into the project and use the @EnableServiceComb tag.

		@@ -1,29 +1,29 @@
		Web开发方式和JAVA应用方式的开发步骤基本类似。
		The development steps of the web development method and the JAVA application method are similar.



		主要有如下区别：
		There are mainly the following differences:

Using java chassis in spring boot dir translation #40

Using java chassis in spring boot dir translation #40

Uh oh!

Conversation

DeanLee2013 commented Aug 21, 2018

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

DeanLee2013 commented Aug 23, 2018

Uh oh!

zhengyangyong commented Aug 24, 2018

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

DeanLee2013 commented Aug 27, 2018

Uh oh!

Uh oh!