1.quick_start.md

准备工作

• Java ，版本应大于等于1.8.0_251。
• Maven ，版本应大于等于3.6.3。

获取示例代码

示例代码是tRPC-Java仓库的一部份，先克隆tRPC-Java仓库到本地目录。

$ git clone https://github.com/trpc-group/trpc-java.git
$ cd trpc-java

详细的示例代码在trpc-demo目录中，具体如下：

trpc-demo
├── trpc-java-demo                # 基础示例代码目录
│   └──src/main/java/com/tencent/trpc/demo/example  # 详细的示例代码路径
│       ├── config                # 基于代码配置方式的示例
│       ├── yaml                  # 基于yaml配置文件的示例
│       └── stream                # 流式功能示例
└── trpc-spring-demo              # 基于Spring Boot的示例代码目录
    ├── trpc-spring-client-demo   # 基于Spring Boot的客户端示例代码
    └── trpc-spring-server-demo   # 基于Spring Boot的服务端示例代码

执行示例

本文档仅演示命令行方式执行示例代码。如使用IDE，可直接导入tRPC-Java仓库，并在IDE中执行对应类即可。

安装tRPC-Java

执行以下命令，本地安装tRPC-Java及其依赖：

$ mvn -Dmaven.test.skip=true clean install

请通过 mvn -Dmaven.test.skip=true clean install 编译tRPC-Java。如果运行单元测试需使用JDK 8执行。

运行服务端示例代码

执行以下命令运行服务端示例代码：

$ mvn exec:java -pl :trpc-java-demo -Dexec.cleanupDaemonThreads=false -Dexec.mainClass=com.tencent.trpc.demo.example.config.ServerTest

此时应可看到服务端正常启动的信息，且运行于前台，若想退出服务可按ctrl-c。

运行客户端示例代码

新打开一个终端，并cd到tRPC-Java目录。确保服务端已启动的情况下，执行以下命令：

$ mvn exec:java -pl :trpc-java-demo -Dexec.cleanupDaemonThreads=false -Dexec.mainClass=com.tencent.trpc.demo.example.config.ClientTest

此时应可看到客户端与服务端正常通信的信息，且通信完成后，客户端会正常结束。

更新并执行服务端和客户端

如果想更新代码并重新执行，可进入如下目录，并修改对应代码：

src/main/java/com/tencent/trpc/demo/example/config
src/main/java/com/tencent/trpc/demo/example/server

更新代码后，执行以下命令重新编译：

$ mvn -pl :trpc-java-demo clean compile

编译完成后，可继续参考运行服务端示例代码处重新执行示例代码。

下一步

• 阅读 基础教程 来更深入地了解 tRPC-Java。