Skip to content

Latest commit

 

History

History
82 lines (54 loc) · 2.73 KB

1.quick_start.md

File metadata and controls

82 lines (54 loc) · 2.73 KB

准备工作

  • 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

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

下一步