You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@servicecomb.apache.org by li...@apache.org on 2020/02/11 01:10:16 UTC
[servicecomb-docs] branch master updated: [SCB-1759] fix first
sample link error (#124)
This is an automated email from the ASF dual-hosted git repository.
liubao pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/servicecomb-docs.git
The following commit(s) were added to refs/heads/master by this push:
new ce019b3 [SCB-1759] fix first sample link error (#124)
ce019b3 is described below
commit ce019b369a0484540a95223881771664977dc7f9
Author: bao liu <bi...@qq.com>
AuthorDate: Tue Feb 11 09:10:07 2020 +0800
[SCB-1759] fix first sample link error (#124)
---
java-chassis-reference/en_US/introduction.md | 2 +-
java-chassis-reference/en_US/start/first-sample.md | 28 ++++++++++++---------
java-chassis-reference/zh_CN/introduction.md | 2 +-
java-chassis-reference/zh_CN/start/first-sample.md | 29 ++++++++++++----------
4 files changed, 34 insertions(+), 27 deletions(-)
diff --git a/java-chassis-reference/en_US/introduction.md b/java-chassis-reference/en_US/introduction.md
index 4d42aee..66c65fc 100644
--- a/java-chassis-reference/en_US/introduction.md
+++ b/java-chassis-reference/en_US/introduction.md
@@ -9,6 +9,6 @@ For other versions, please check the following table.
| version | link |
| :--- | :--- |
-| lastest(2.0.0) | [中文](https://docs.servicecomb.io/java-chassis/zh_CN/), [English](https://docs.servicecomb.io/java-chassis/en_US/)|
+| latest(2.0.0) | [中文](https://docs.servicecomb.io/java-chassis/zh_CN/), [English](https://docs.servicecomb.io/java-chassis/en_US/)|
| 1.3.0 | [中文](https://docs.servicecomb.io/java-chassis/1.x/zh_CN/), [English](https://docs.servicecomb.io/java-chassis/1.x/en_US/)|
| 1.2.1 | [中文](https://docs.servicecomb.io/java-chassis/1.x/zh_CN/), [English](https://docs.servicecomb.io/java-chassis/1.x/en_US/)|
\ No newline at end of file
diff --git a/java-chassis-reference/en_US/start/first-sample.md b/java-chassis-reference/en_US/start/first-sample.md
index 90e36b8..9fb06e6 100644
--- a/java-chassis-reference/en_US/start/first-sample.md
+++ b/java-chassis-reference/en_US/start/first-sample.md
@@ -1,20 +1,24 @@
# Develop the first microservice
-Developers can quickly build a project in two ways:
-
-* Download the samples project. It is recommended to download the entire project, according to the example [SpringMVC] (https://github.com/apache/incubator-servicecomb-java-chassis/tree/master/samples/springmvc-sample) or [JAX RS] (https: //github.com/apache/incubator-servicecomb-java-chassis/tree/master/samples/jaxrs-sample) Initialize the configuration.
-
-* Generate projects using archetypes
Before you start, developers need to choose a familiar development method. There are currently 3 ways to choose:
* Spring MVC
* JaxRS
* RPC
-Because transparent RPC acts as a Producer without any RESTful semantics, the automatically generated contracts are all POST methods, and only the BODY parameters are not in line with the usual rules of RESTful.
-Therefore, it is recommended to choose JaxRS or Spring MVC as the Producer development mode, and transparent RPC as the developer development mode.
+Developers can quickly build a project in following ways:
+
+* Download the samples project. [servicecomb-samples](https://github.com/apache/servicecomb-samples) provides many samples in hand.
+
+ * [Spring MVC Sample](https://github.com/apache/servicecomb-samples/tree/master/java-chassis-samples/springmvc-sample)
+ * [JaxRS Sample](https://github.com/apache/servicecomb-samples/tree/master/java-chassis-samples/jaxrs-sample)
+ * [POJO Sample](https://github.com/apache/servicecomb-samples/tree/master/java-chassis-samples/pojo-sample)
+
+* Generate projects using archetypes
+
+ Maven provide archetypes to generate projects. Java-chassis implements many types of archetypes, see [LINK](https://github.com/apache/servicecomb-java-chassis/tree/master/archetypes) for details.
+
+* Generate projects using ServiceComb Spring Initializer
-Their corresponding samples project are:
-* [Spring MVC](https://github.com/apache/incubator-servicecomb-java-chassis/tree/master/samples/springmvc-sample)
-* [JaxRS](https://github.com/apache/incubator-servicecomb-java-chassis/tree/master/samples/jaxrs-sample)
-* [RPC](https://github.com/apache/incubator-servicecomb-java-chassis/tree/master/samples/pojo-sample)
-* Or use [archetypes](https://github.com/apache/incubator-servicecomb-java-chassis/tree/master/archetypes)
\ No newline at end of file
+ ServiceComb Spring Initializer is an graphic user interface to generate projects. See [LINK](http://start.servicecomb.io/)
+
+
\ No newline at end of file
diff --git a/java-chassis-reference/zh_CN/introduction.md b/java-chassis-reference/zh_CN/introduction.md
index b8ee729..fa3b080 100644
--- a/java-chassis-reference/zh_CN/introduction.md
+++ b/java-chassis-reference/zh_CN/introduction.md
@@ -11,6 +11,6 @@ Apache ServiceComb Java Chassis 给开发者提供一个快速构建微服务的
| 版本| 链接 |
| :--- | :--- |
-| lastest(2.0.0) | [中文](https://docs.servicecomb.io/java-chassis/zh_CN/), [English](https://docs.servicecomb.io/java-chassis/en_US/)|
+| 最新(2.0.0) | [中文](https://docs.servicecomb.io/java-chassis/zh_CN/), [English](https://docs.servicecomb.io/java-chassis/en_US/)|
| 1.3.0 | [中文](https://docs.servicecomb.io/java-chassis/1.x/zh_CN/), [English](https://docs.servicecomb.io/java-chassis/1.x/en_US/)|
| 1.2.1 | [中文](https://docs.servicecomb.io/java-chassis/1.x/zh_CN/), [English](https://docs.servicecomb.io/java-chassis/1.x/en_US/)|
\ No newline at end of file
diff --git a/java-chassis-reference/zh_CN/start/first-sample.md b/java-chassis-reference/zh_CN/start/first-sample.md
index 253e2b0..bdd0d37 100644
--- a/java-chassis-reference/zh_CN/start/first-sample.md
+++ b/java-chassis-reference/zh_CN/start/first-sample.md
@@ -1,21 +1,24 @@
# 开发第一个微服务
-开发者可以通过两种方式快速构建一个项目：
+开始之前，开发者需要选择熟悉的开发方式，目前有3种方式可供选择：
+* Spring MVC
+* JaxRS
+* POJO
+
+Spring MVC和JaxRS适合REST接口开发。 POJO是通常说的RPC，适合于进行内部接口开发。java-chassis允许在一个微服务里面混合使用上述开发方式，并且可以使用完全一致的方式，比如RestTemplate或者POJO的方式访问不同类型的服务，所以开始之前，可以根据熟悉程度，选择任意一种开发方式即可。java-chassis的开发方式和通信方式是完全解耦的，因此不同的开发方式并没有性能上的差异。
+
+开发者可以通过如下方式快速构建一个项目：
-* 下载samples项目。建议把整个项目都下载下来，按照例子[ SpringMVC ](https://github.com/apache/incubator-servicecomb-java-chassis/tree/master/samples/springmvc-sample)或者 [JAX RS](https://github.com/apache/incubator-servicecomb-java-chassis/tree/master/samples/jaxrs-sample)进行初始化配置。
+* 下载samples项目。java-chassis提供了大量的示例代码，这些示例代码可以通过[servicecomb-samples](https://github.com/apache/servicecomb-samples)获取。
+
+ * [Spring MVC例子](https://github.com/apache/servicecomb-samples/tree/master/java-chassis-samples/springmvc-sample)
+ * [JaxRS例子](https://github.com/apache/servicecomb-samples/tree/master/java-chassis-samples/jaxrs-sample)
+ * [POJO例子](https://github.com/apache/servicecomb-samples/tree/master/java-chassis-samples/pojo-sample)
* 使用archetypes生成项目
-开始之前，开发者需要先选择熟悉的开发方式，目前有3种方式可供选择：
-* Spring MVC
-* JaxRS
-* RPC
+ archetypes是maven提供的一种机制，对于使用maven的用户，可以在项目里面配置插件，生成项目。java-chassis提供了多个archetypes供开发者使用，详细参考[链接](https://github.com/apache/servicecomb-java-chassis/tree/master/archetypes)
-因为透明RPC作为Producer时，不带任何RESTful语义，此时自动生成的契约全是POST方法，且只有BODY参数，不太符合RESTful的通常规则
-所以建议选择JaxRS或Spring MVC作为Producer开发模式，透明RPC作为Consumer的开发模式。
+* 使用脚手架生成项目
-他们对应的samples项目分别是：
-* [Spring MVC](https://github.com/apache/incubator-servicecomb-java-chassis/tree/master/samples/springmvc-sample)
-* [JaxRS](https://github.com/apache/incubator-servicecomb-java-chassis/tree/master/samples/jaxrs-sample)
-* [RPC](https://github.com/apache/incubator-servicecomb-java-chassis/tree/master/samples/pojo-sample)
-* 或者使用[archetypes](https://github.com/apache/incubator-servicecomb-java-chassis/tree/master/archetypes)
+ 脚手架提供了一个图形化向导，通过向导可以快速构建项目，参考[链接](http://start.servicecomb.io/)。
\ No newline at end of file