java 调用rpc接口

原创

mob64ca12d2dee8 2024-10-07 04:02:14 ©著作权

文章标签 RPC java Java 文章分类 Java 后端开发

©著作权归作者所有：来自51CTO博客作者mob64ca12d2dee8的原创作品，请联系作者获取转载授权，否则将追究法律责任

Java 调用 RPC 接口的科普

1. 什么是 RPC？

RPC（Remote Procedure Call，远程过程调用）允许程序通过网络在不同的地址空间中进行交互而不需要用者了解底层网络协议的细节。它使得调用远程函数像调用本地函数一样简单，通常用于分布式系统中。

2. Java 中的 RPC 实现

在 Java 中，有多种库和框架可以实现 RPC，其中常见的包括：

gRPC
Apache Thrift
RMI（Remote Method Invocation）

在这篇文章中，我们将主要讨论如何使用 gRPC 来实现 Java 的 RPC 调用。

3. gRPC 简介

gRPC 是 Google 开发的开源高性能 RPC 框架，支持多种语言，使用 Protocol Buffers 作为接口描述语言（IDL）。它优势明显，性能高，适合微服务架构。

4. 环境准备

要开始使用 gRPC，我们需要几个基本步骤。首先，需要在项目中添加 gRPC 的依赖。假设我们使用 Maven 来构建项目，以下是 pom.xml 示例中的依赖部分：

<dependencies>
    <dependency>
        <groupId>io.grpc</groupId>
        <artifactId>grpc-netty</artifactId>
        <version>1.48.0</version>
    </dependency>
    <dependency>
        <groupId>io.grpc</groupId>
        <artifactId>grpc-protobuf</artifactId>
        <version>1.48.0</version>
    </dependency>
    <dependency>
        <groupId>io.grpc</groupId>
        <artifactId>grpc-stub</artifactId>
        <version>1.48.0</version>
    </dependency>
</dependencies>

5. 定义服务

在 gRPC 中，服务定义在 .proto 文件中。我们可以定义一个简单的计算服务：

syntax = "proto3";

service Calculator {
    rpc Add (AddRequest) returns (AddResponse);
}

message AddRequest {
    int32 a = 1;
    int32 b = 2;
}

message AddResponse {
    int32 result = 1;
}

6. 生成代码

使用 gRPC 的编译器将上述 .proto 文件编译成 Java 类。执行以下命令：

protoc --java_out=src/main/java --grpc_out=src/main/java --plugin=protoc-gen-grpc=$(which protoc-gen-grpc-java) calculator.proto

7. 实现服务端

服务端代码示例：

import io.grpc.Server;
import io.grpc.ServerBuilder;
import io.grpc.stub.StreamObserver;

public class CalculatorServer {
    public static void main(String[] args) throws Exception {
        Server server = ServerBuilder.forPort(8080)
            .addService(new CalculatorImpl())
            .build()
            .start();
        System.out.println("Server started on port 8080");
        server.awaitTermination();
    }

    static class CalculatorImpl extends CalculatorGrpc.CalculatorImplBase {
        @Override
        public void add(AddRequest req, StreamObserver<AddResponse> responseObserver) {
            int sum = req.getA() + req.getB();
            AddResponse response = AddResponse.newBuilder().setResult(sum).build();
            responseObserver.onNext(response);
            responseObserver.onCompleted();
        }
    }
}

8. 实现客户端

客户端代码示例：

import io.grpc.ManagedChannel;
import io.grpc.ManagedChannelBuilder;

public class CalculatorClient {
    public static void main(String[] args) {
        ManagedChannel channel = ManagedChannelBuilder.forAddress("localhost", 8080)
            .usePlaintext()
            .build();

        CalculatorGrpc.CalculatorBlockingStub stub = CalculatorGrpc.newBlockingStub(channel);
        
        AddRequest request = AddRequest.newBuilder().setA(3).setB(5).build();
        AddResponse response = stub.add(request);
        
        System.out.println("Result: " + response.getResult());
        
        channel.shutdown();
    }
}

9. 类图

以下是实现的简化类图，展示了服务端与客户端的基本关系：

classDiagram
    class CalculatorServer {
        + main(String[] args)
        + add(int a, int b)
    }
    class CalculatorClient {
        + main(String[] args)
        + callAdd(int a, int b)
    }
    CalculatorServer --> CalculatorClient : "uses"