### Java
gRPC 实现示例
以下是基于提供的引用以及
gRPC 官方文档的知识，展示如何通过 Java 编写一个简单的
gRPC 示例。
#### 1. 创建项目并引入依赖
首先，在项目的 `pom.xml` 文件中添加必要的 Maven 依赖项来支持
gRPC 和 Protocol Buffers (protobuf)[^4]：
```xml
<dependencies>
<!--
gRPC dependency -->
<dependency>
<groupId>io.
grpc</groupId>
<artifactId>
grpc-netty-shaded</artifactId>
<version>1.50.0</version>
</dependency>
<!-- Protobuf compiler plugin -->
<dependency>
<groupId>com.google.protobuf</groupId>
<artifactId>protobuf-java</artifactId>
<version>3.21.7</version>
</dependency>
<!--
gRPC protobuf generator -->
<dependency>
<groupId>io.
grpc</groupId>
<artifactId>
grpc-protobuf</artifactId>
<version>1.50.0</version>
</dependency>
<!--
gRPC stubs for client and server -->
<dependency>
<groupId>io.
grpc</groupId>
<artifactId>
grpc-stub</artifactId>
<version>1.50.0</version>
</dependency>
</dependencies>
```
#### 2. 定义 `.proto` 文件
`.proto` 文件用于描述服务接口和服务消息结构。下面是一个简单的例子[^3]:
```proto
syntax = "proto3";
option java_package = "com.example.
grpc";
option java_outer_classname = "HelloWorldProto";
// The greeting service definition.
service Greeter {
// Sends a greeting
rpc SayHello (HelloRequest) returns (HelloReply);
}
// The request message containing the user's name.
message HelloRequest {
string name = 1;
}
// The response message containing the greetings
message HelloReply {
string message = 1;
}
```
保存此文件为 `helloworld.proto` 并将其放置在 `src/main/proto` 目录下。
#### 3. 使用 protoc 工具生成 Java 类
运行以下命令以生成客户端和服务器端所需的 Java 类:
```bash
protoc --java_out=./generated_src helloworld.proto
```
这将在指定目录中生成对应的 Java 文件。
#### 4. 实现 Server 端逻辑
编写一个简单的
gRPC 服务端程序如下所示:
```java
import io.
grpc.Server;
import io.
grpc.ServerBuilder;
public class HelloWorldServer {
private int port = 50051;
private Server server;
public void start() throws IOException, InterruptedException {
server = ServerBuilder.forPort(port)
.addService(new GreeterImpl())
.build()
.start();
System.out.println("Server started on port " + port);
Runtime.getRuntime().addShutdownHook(new Thread(() -> {
try {
stop();
} catch (InterruptedException e) {
e.printStackTrace(System.err);
}
}));
server.awaitTermination();
}
public void stop() throws InterruptedException {
if (server != null && !server.isShutdown()) {
server.shutdownNow().awaitTermination(30, TimeUnit.SECONDS);
}
}
static class GreeterImpl extends Greeter
Grpc.GreeterImplBase {
@Override
public void sayHello(HelloRequest req, StreamObserver<HelloReply> responseObserver) {
String replyMessage = "Hello " + req.getName();
HelloReply reply = HelloReply.newBuilder().setMessage(replyMessage).build();
responseObserver.onNext(reply);
responseObserver.onCompleted();
}
}
public static void main(String[] args) throws IOException, InterruptedException {
new HelloWorldServer().start();
}
}
```
#### 5. 实现 Client 端调用
接着构建一个基本的
gRPC 客户端去连接到上述的服务端实例:
```java
import io.
grpc.ManagedChannel;
import io.
grpc.ManagedChannelBuilder;
public class HelloWorldClient {
private final ManagedChannel channel;
private final Greeter
Grpc.GreeterBlockingStub blockingStub;
public HelloWorldClient(String host, int port) {
this.channel = ManagedChannelBuilder.forAddress(host, port)
.usePlaintext()
.build();
this.blockingStub = Greeter
Grpc.newBlockingStub(channel);
}
public void shutdown() throws InterruptedException {
channel.shutdown().awaitTermination(5, TimeUnit.SECONDS);
}
public void greet(String name) {
HelloRequest request = HelloRequest.newBuilder().setName(name).build();
HelloReply response = blockingStub.sayHello(request);
System.out.println(response.getMessage());
}
public static void main(String[] args) throws InterruptedException {
HelloWorldClient client = new HelloWorldClient("localhost", 50051);
try {
client.greet("Alice");
} finally {
client.shutdown();
}
}
}
```
以上代码展示了完整的
gRPC 流程设置过程，包括定义协议缓冲区文件、编译它们成 Java 源码以及开发相应的服务端与客户端应用。
---
该文指导如何初始化一个Go模块，创建一个名为helloworld.proto的protobuf文件，定义一个名为Greeter的服务及SayHello方法。接着，使用protoc编译器生成Go代码，实现gRPC接口。
扫一扫
554
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
