This is an automated email from the ASF dual-hosted git repository.
guohao 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 5d2c721e63 Add triple stub (#1092)
5d2c721e63 is described below
commit 5d2c721e63d2ca5834da4db566bcc9b880ce39b3
Author: GuoHao <[email protected]>
AuthorDate: Tue May 24 16:18:32 2022 +0800
Add triple stub (#1092)
---
.../reference-manual/protocol/triple/idl.md | 230 +++++++++++++++++++++
1 file changed, 230 insertions(+)
diff --git
a/content/zh/docs3-building/java-sdk/reference-manual/protocol/triple/idl.md
b/content/zh/docs3-building/java-sdk/reference-manual/protocol/triple/idl.md
new file mode 100644
index 0000000000..1126d884cd
--- /dev/null
+++ b/content/zh/docs3-building/java-sdk/reference-manual/protocol/triple/idl.md
@@ -0,0 +1,230 @@
+---
+type: docs
+title: "IDL 方式使用 Triple"
+linkTitle: "IDL 方式使用 Triple"
+weight: 2
+---
+
+这篇教程会通过从零构建一个简单的工程来演示如何基于 IDL 方式使用 Dubbo Triple
+
+### 前置条件
+- [JDK](https://jdk.java.net/) 版本 >= 8
+- 已安装 [Maven](https://maven.apache.org/)
+- 已安装并启动 [Zookeeper](https://zookeeper.apache.org/)
+
+### 创建工程
+1. 首先创建一个空的 maven 工程
+ ```
+ $ mvn archetype:generate \
+ -DgroupId=org.apache.dubbo \
+ -DartifactId=tri-stub-demo \
+ -DarchetypeArtifactId=maven-archetype-quickstart \
+ -DarchetypeVersion=1.4 \
+ -DarchetypeGroupId=org.apache.maven.archetypes \
+ -Dversion=1.0-SNAPSHOT
+ ```
+2. 切换到工程目录
+ ```
+ $ cd tri-stub-demo
+ ```
+3. 在 `pom.xml` 中设置 JDK 版本，添加 Dubbo 依赖和插件
+ ```xml
+ <properties>
+ <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
+ <maven.compiler.source>1.8</maven.compiler.source>
+ <maven.compiler.target>1.8</maven.compiler.target>
+ </properties>
+
+ <dependencies>
+ <dependency>
+ <groupId>junit</groupId>
+ <artifactId>junit</artifactId>
+ <version>4.13</version>
+ <scope>test</scope>
+ </dependency>
+ <dependency>
+ <groupId>org.apache.dubbo</groupId>
+ <artifactId>dubbo</artifactId>
+ <version>3.0.8</version>
+ </dependency>
+ <dependency>
+ <groupId>org.apache.dubbo</groupId>
+ <artifactId>dubbo-dependencies-zookeeper-curator5</artifactId>
+ <type>pom</type>
+ <version>3.0.8</version>
+ </dependency>
+ <dependency>
+ <groupId>com.google.protobuf</groupId>
+ <artifactId>protobuf-java</artifactId>
+ <version>3.19.4</version>
+ </dependency>
+ </dependencies>
+
+ <build>
+ <extensions>
+ <extension>
+ <groupId>kr.motd.maven</groupId>
+ <artifactId>os-maven-plugin</artifactId>
+ <version>1.6.1</version>
+ </extension>
+ </extensions>
+ <plugins>
+ <plugin>
+ <groupId>org.xolstice.maven.plugins</groupId>
+ <artifactId>protobuf-maven-plugin</artifactId>
+ <version>0.6.1</version>
+ <configuration>
+
<protocArtifact>com.google.protobuf:protoc:3.19.4:exe:${os.detected.classifier}</protocArtifact>
+ <protocPlugins>
+ <protocPlugin>
+ <id>dubbo</id>
+ <groupId>org.apache.dubbo</groupId>
+ <artifactId>dubbo-compiler</artifactId>
+ <version>0.0.4.1-SNAPSHOT</version>
+
<mainClass>org.apache.dubbo.gen.tri.Dubbo3TripleGenerator</mainClass>
+ </protocPlugin>
+ </protocPlugins>
+ </configuration>
+ <executions>
+ <execution>
+ <goals>
+ <goal>compile</goal>
+ </goals>
+ </execution>
+ </executions>
+ </plugin>
+ </plugins>
+ </build>
+ ```
+4. 添加接口定义文件`src/main/proto/hello.proto`，Dubbo 使用
[Protobuf](https://developers.google.com/protocol-buffers) 作为 IDL
+ ```protobuf
+ syntax = "proto3";
+
+ option java_multiple_files = true;
+ option java_package = "org.apache.dubbo.hello";
+ option java_outer_classname = "HelloWorldProto";
+ option objc_class_prefix = "HLW";
+
+ package helloworld;
+
+ message HelloRequest {
+ string name = 1;
+ }
+
+ message HelloReply {
+ string message = 1;
+ }
+ service Greeter{
+ rpc greet(HelloRequest) returns (HelloReply);
+ }
+
+ ```
+5. 编译 IDL
+ ```
+ $ mvn clean install
+ ```
+ 编译成功后，可以看到`target/generated-sources/protobuf/java` 目录下生成了代码文件
+ ```
+ $ ls org/apache/dubbo/hello/
+ DubboGreeterTriple.java HelloReply.java HelloRequest.java
HelloWorldProto.java
+ Greeter.java HelloReplyOrBuilder.java
HelloRequestOrBuilder.java
+ ```
+
+6. 添加服务端接口实现`src/main/java/org/apache/dubbo/GreeterImpl.java`
+ ```java
+ package org.apache.dubbo;
+
+ import org.apache.dubbo.hello.DubboGreeterTriple;
+ import org.apache.dubbo.hello.HelloReply;
+ import org.apache.dubbo.hello.HelloRequest;
+
+ public class GreeterImpl extends DubboGreeterTriple.GreeterImplBase {
+ @Override
+ public HelloReply greet(HelloRequest request) {
+ return HelloReply.newBuilder()
+ .setMessage("Hello," + request.getName() + "!")
+ .build();
+ }
+ }
+ ```
+7. 添加服务端启动类 `src/main/java/org/apache/dubbo/MyDubboServer.java`
+ ```java
+ package org.apache.dubbo;
+
+ import org.apache.dubbo.common.constants.CommonConstants;
+ import org.apache.dubbo.common.context.Lifecycle;
+ import org.apache.dubbo.config.ApplicationConfig;
+ import org.apache.dubbo.config.ProtocolConfig;
+ import org.apache.dubbo.config.RegistryConfig;
+ import org.apache.dubbo.config.ServiceConfig;
+ import org.apache.dubbo.config.bootstrap.DubboBootstrap;
+ import org.apache.dubbo.hello.Greeter;
+
+ import java.io.IOException;
+
+ public class MyDubboServer {
+
+ public static void main(String[] args) throws IOException {
+ ServiceConfig<Greeter> service = new ServiceConfig<>();
+ service.setInterface(Greeter.class);
+ service.setRef(new GreeterImpl());
+
+ DubboBootstrap bootstrap = DubboBootstrap.getInstance();
+ bootstrap.application(new ApplicationConfig("tri-stub-server"))
+ .registry(new RegistryConfig("zookeeper://127.0.0.1:2181"))
+ .protocol(new ProtocolConfig(CommonConstants.TRIPLE, 50051))
+ .service(service)
+ .start();
+ System.out.println("Dubbo triple stub server started");
+ System.in.read();
+ }
+ }
+ ```
+
+8. 添加客户端启动类`src/main/java/org/apache/dubbo/MyDubboClient.java`
+ ```java
+ package org.apache.dubbo;
+
+ import org.apache.dubbo.common.constants.CommonConstants;
+ import org.apache.dubbo.config.ApplicationConfig;
+ import org.apache.dubbo.config.ReferenceConfig;
+ import org.apache.dubbo.config.RegistryConfig;
+ import org.apache.dubbo.config.bootstrap.DubboBootstrap;
+ import org.apache.dubbo.hello.Greeter;
+ import org.apache.dubbo.hello.HelloReply;
+ import org.apache.dubbo.hello.HelloRequest;
+
+ public class MyDubboClient {
+ public static void main(String[] args) {
+ DubboBootstrap bootstrap = DubboBootstrap.getInstance();
+ ReferenceConfig<Greeter> ref = new ReferenceConfig<>();
+ ref.setInterface(Greeter.class);
+ ref.setProtocol(CommonConstants.TRIPLE);
+ ref.setProxy(CommonConstants.NATIVE_STUB);
+ ref.setTimeout(3000);
+ bootstrap.application(new ApplicationConfig("tri-stub-client"))
+ .registry(new RegistryConfig("zookeeper://127.0.0.1:2181"))
+ .reference(ref)
+ .start();
+
+ Greeter greeter = ref.get();
+ HelloRequest request =
HelloRequest.newBuilder().setName("Demo").build();
+ HelloReply reply = greeter.greet(request);
+ System.out.println("Received reply:" + reply);
+ }
+ }
+ ```
+9. 编译代码
+ ```
+ $ mvn clean install
+ ```
+10. 启动服务端
+ ```
+ $ mvn org.codehaus.mojo:exec-maven-plugin:3.0.0:java
-Dexec.mainClass="org.apache.dubbo.MyDubboServer"
+ Dubbo triple stub server started
+ ```
+11. 启动一个新的终端，启动客户端
+ ```
+ $ mvn org.codehaus.mojo:exec-maven-plugin:3.0.0:java
-Dexec.mainClass="org.apache.dubbo.MyDubboClient"
+ Received reply:message: "Hello,Demo!"
+ ```
\ No newline at end of file
