This is an automated email from the ASF dual-hosted git repository.
albumenj pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/dubbo-website.git
The following commit(s) were added to refs/heads/master by this push:
new 907f477a0b2 fix: fix website error (#2829)
907f477a0b2 is described below
commit 907f477a0b290eebf3024c64332a6274d0aaf8b5
Author: YuLuo <[email protected]>
AuthorDate: Sun Oct 8 10:06:27 2023 +0800
fix: fix website error (#2829)
---
.../golang-sdk/quickstart/quickstart_triple.md | 33 ++++++++++---------
.../overview/quickstart/go/quickstart_triple.md | 38 +++++++++++-----------
2 files changed, 37 insertions(+), 34 deletions(-)
diff --git
a/content/zh-cn/overview/mannual/golang-sdk/quickstart/quickstart_triple.md
b/content/zh-cn/overview/mannual/golang-sdk/quickstart/quickstart_triple.md
index 92f272bb267..fc7b6ff71b0 100644
--- a/content/zh-cn/overview/mannual/golang-sdk/quickstart/quickstart_triple.md
+++ b/content/zh-cn/overview/mannual/golang-sdk/quickstart/quickstart_triple.md
@@ -13,16 +13,19 @@ weight: 2
使用安装好的 dubbogo-cli 工具，创建 demo 工程。
创建并切换目录
+
```bash
$ mkdir quickstart && cd quickstart
```
使用 dubbogo-cli 工具创建新项目
+
```bash
$ dubbogo-cli newDemo .
```
查看项目结构
+
```bash
$ tree .
.
@@ -44,9 +47,7 @@ $ tree .
```
可看到生成的项目中包含一个 client 项目和一个 server 项目，以及相关的配置文件。
-### 1.1 查看接口描述文件
-
-`helloworld.proto`
+### 1.1 查看接口描述文件 sample_api.proto
```protobuf
syntax = "proto3";
@@ -75,7 +76,7 @@ message User {
}
```
-demo项目中，默认生成了一个接口描述文件，接口服务名为 api.Greeter, 包含两个 RPC 方法，入参为 HelloRequest，返回值为
User，两个方法分别为普通 RPC 方法和 Streaming 类型 RPC 方法。
+demo 项目中，默认生成了一个接口描述文件，接口服务名为 api.Greeter, 包含两个 RPC 方法，入参为 HelloRequest，返回值为
User，两个方法分别为普通 RPC 方法和 Streaming 类型 RPC 方法。
### 1.2 编译接口 (可选)
@@ -86,9 +87,9 @@ $ cd api
$ protoc --go_out=. --go-triple_out=. ./samples_api.proto
```
-参数意义：`--go_out=.` 使用上述安装的 `protoc-gen-go`
插件，生成文件到当前目录，`--go-triple_out=.`使用上述安装的 `protoc-gen-go-triple` 插件，生成文件到当前目录。
+参数意义：`--go_out=.` 使用上述安装的 `protoc-gen-go` 插件，生成文件到当前目录，`--go-triple_out=.`
使用上述安装的 `protoc-gen-go-triple` 插件，生成文件到当前目录。
-执行该指令后，会生成两个文件，分别是helloworld.pb (包含 proto 结构) 和 helloworld_triple.pb.go (包含
triple 协议接口)。
+执行该指令后，会生成两个文件，分别是 sample_api.pb (包含 proto 结构) 和 sample_api_triple.pb.go (包含
triple 协议接口)。
在 demo 工程中，预先生成好了这两个文件，修改 .proto 文件后重新执行命令生成，即可覆盖。
@@ -96,22 +97,23 @@ $ protoc --go_out=. --go-triple_out=. ./samples_api.proto
项目根目录执行
-```
+```bash
$ go mod tidy
```
-拉取到最新的框架依赖：
+拉取到最新的框架依赖（其中 Go SDK 版本和 module 名以个人机器配置为准）：
```go
module helloworld
-go 1.17
+go 1.21.1
require (
- dubbo.apache.org/dubbo-go/v3 v3.0.1
- github.com/dubbogo/grpc-go v1.42.9
- github.com/dubbogo/triple v1.1.8
- google.golang.org/protobuf v1.27.1
+ dubbo.apache.org/dubbo-go/v3 v3.1.0
+ github.com/dubbogo/gost v1.14.0
+ github.com/dubbogo/grpc-go v1.42.10
+ github.com/dubbogo/triple v1.2.2-rc3
+ google.golang.org/protobuf v1.31.0
)
require (
@@ -119,6 +121,7 @@ require (
)
```
+
{{% alert title="输出结果" color="info" %}}
先后启动服务端和客户端: 开启两个终端，在 `go-server/cmd` 和 `go-client/cmd` 文件夹下分别执行 `go run .` ,
可在客户端看到输出：
@@ -126,9 +129,9 @@ require (
client response result: name:"Hello laurence" id:"12345" age:21
```
-获得调用结果成功。
+调用成功。
{{% /alert %}}
{{% alert title="更多" color="primary" %}}
-细心的读者可以发现，以上例子编写的的服务端可以接受来自客户端的普通RPC、流式RPC调用请求。目前只编写了普通调用的Client，读者可以根据
samples 库中的例子来尝试编写流式客户端和服务端。
+细心的读者可以发现，以上例子编写的的服务端可以接受来自客户端的普通 RPC、流式 RPC 调用请求。目前只编写了普通调用的 Client，读者可以根据
samples 库中的例子来尝试编写流式客户端和服务端应用。
{{% /alert %}}
diff --git a/content/zh-cn/overview/quickstart/go/quickstart_triple.md
b/content/zh-cn/overview/quickstart/go/quickstart_triple.md
index 57371295c7c..fc108256ec9 100644
--- a/content/zh-cn/overview/quickstart/go/quickstart_triple.md
+++ b/content/zh-cn/overview/quickstart/go/quickstart_triple.md
@@ -7,12 +7,9 @@ type: docs
weight: 2
---
-
-
-
## 1. 生成 Demo 项目
-使用安装好的 dubbogo-cli 工具，创建demo工程。
+使用安装好的 dubbogo-cli 工具，创建 demo 工程。
```bash
$ mkdir quickstart
@@ -39,7 +36,7 @@ $ tree .
可看到生成的项目中包含一个 client 项目和一个 server 项目，以及相关的配置文件。
-### 1.1 查看接口描述文件 helloworld.proto
+### 1.1 查看接口描述文件 sample_api.proto
```protobuf
syntax = "proto3";
@@ -77,9 +74,9 @@ $ cd api
$ protoc --go_out=. --go-triple_out=. ./samples_api.proto
```
-参数意义：`--go_out=.` 使用上述安装的 `protoc-gen-go`
插件，生成文件到当前目录，`--go-triple_out=.`使用上述安装的 `protoc-gen-go-triple` 插件，生成文件到当前目录。
+参数意义：`--go_out=.` 使用上述安装的 `protoc-gen-go` 插件，生成文件到当前目录，`--go-triple_out=.`
使用上述安装的 `protoc-gen-go-triple` 插件，生成文件到当前目录。
-执行该指令后，会生成两个文件，分别是helloworld.pb (包含 proto 结构) 和 helloworld_triple.pb.go (包含
triple 协议接口)。
+执行该指令后，会生成两个文件，分别是 sample_api.pb (包含 proto 结构) 和 sample_api_triple.pb.go (包含
triple 协议接口)。
在 demo 工程中，预先生成好了这两个文件，修改 .proto 文件后重新执行命令生成，即可覆盖。
@@ -87,22 +84,23 @@ $ protoc --go_out=. --go-triple_out=. ./samples_api.proto
项目根目录执行
-```
+```bash
$ go mod tidy
```
-拉取到最新的框架依赖：
+拉取到最新的框架依赖（其中 Go SDK 版本和 module 名以个人机器配置为准）：
```go
module helloworld
-go 1.17
+go 1.21.1
require (
- dubbo.apache.org/dubbo-go/v3 v3.0.1
- github.com/dubbogo/grpc-go v1.42.9
- github.com/dubbogo/triple v1.1.8
- google.golang.org/protobuf v1.27.1
+ dubbo.apache.org/dubbo-go/v3 v3.1.0
+ github.com/dubbogo/gost v1.14.0
+ github.com/dubbogo/grpc-go v1.42.10
+ github.com/dubbogo/triple v1.2.2-rc3
+ google.golang.org/protobuf v1.31.0
)
require (
@@ -111,14 +109,16 @@ require (
```
-先后启动服务端和客户端: 开启两个终端，在 go-server/cmd 和 go-client/cmd 文件夹下分别执行 `go run .` ,
可在客户端看到输出：
+{{% alert title="输出结果" color="info" %}}
+先后启动服务端和客户端: 开启两个终端，在 `go-server/cmd` 和 `go-client/cmd` 文件夹下分别执行 `go run .` ,
可在客户端看到输出：
```shell
client response result: name:"Hello laurence" id:"12345" age:21
```
-获得调用结果成功
-
-## 3. 更多
+调用成功。
+{{% /alert %}}
-细心的读者可以发现，以上例子编写的的服务端可以接受来自客户端的普通RPC、流式RPC调用请求。目前只编写了普通调用的Client，读者可以根据
samples 库中的例子来尝试编写流式客户端和服务端。
\ No newline at end of file
+{{% alert title="更多" color="primary" %}}
+细心的读者可以发现，以上例子编写的的服务端可以接受来自客户端的普通 RPC、流式 RPC 调用请求。目前只编写了普通调用的 Client，读者可以根据
samples 库中的例子来尝试编写流式客户端和服务端应用。
+{{% /alert %}}
