摘要：與文章框架實踐之一文中實踐的另一種通用框架能通過自動生成對應語言的接口類似，也能自動地生成和的存根，我們只需要一個命令就能快速搭建起運行環境。類似于之前對于框架的實踐步驟，下面一一闡述。

gRPC是Google開源的通用高性能RPC框架，它支持的是使用Protocol Buffers來編寫Service定義，支持較多語言擴平臺并且擁有強大的二進制序列化工具集。與文章《RPC框架實踐之：Apache Thrift》 一文中實踐的另一種通用RPC框架 Thrift 能通過Generator自動生成對應語言的Service接口類似，gRPC也能 自動地生成 Server和Client的 Service存根（Stub），我們只需要 一個命令 就能快速搭建起RPC運行環境。

下面實踐一下gRPC框架，做的事情就是：Client端通過遠程RPC調用Server的獲取時間的接口，從而將服務器時間獲取到本地并顯示。

類似于之前對于 RPC框架: Thrift 的實踐步驟，下面一一闡述。

注： 本文首發于 My 公眾號 CodeSheep ，可 長按 或 掃描 下面的 小心心 來訂閱 ↓ ↓ ↓

首先創建一個基于Maven的項目： GrpcAPI

pom中加入grpc相關的依賴

        
            io.grpc
            grpc-all
            1.12.0
        

這個grpc-all包含了很多grpc相關的組件：grpc-netty 、 grpc-protobuf 、grpc-stub 等等

pom中加入grpc相關的 build插件

這里添加兩個Maven插件，目的是后面需要用這些插件來執行Protocol Buffers命令，從而自動生成相關的Stub代碼：

os-maven-plugin：生成平臺無關的屬性
protobuf-maven-plugin：執行Protocol Buffers命令并生成Stub代碼庫

    
        
            
                kr.motd.maven
                os-maven-plugin
                1.4.1.Final
            
        
        
            
                org.xolstice.maven.plugins
                protobuf-maven-plugin
                0.5.0
                
                    grpc-java
                    com.google.protobuf:protoc:3.0.2:exe:${os.detected.classifier}
                    io.grpc:protoc-gen-grpc-java:1.2.0:exe:${os.detected.classifier}
                
                
                    
                        
                            compile
                            compile-custom
                        
                    
                
            
        
    

編寫.proto的服務定義文件

這里.proto文件的作用和寫法就和我的前一篇文章《RPC框架實踐之：Apache Thrift》 一文中Thrift所要求的.thrift文件編寫一樣，是有其自己的語法要求的！

syntax = "proto3”;   // 語法版本

// stub選項
option java_package = "com.hansonwang99.grpc.api”;
option java_outer_classname = “RPCDateServiceApi”;
option java_multiple_files = true;

// 定義包名，類似于我的文章《RPC框架實踐之：Apache Thrift》中的Thrift的namespace
package com.hansonwang99.grpc.api;

// 服務接口定義，服務端和客戶端都要遵守該接口進行通信
service RPCDateService {
  rpc getDate (RPCDateRequest) returns (RPCDateResponse) {}
}

// 定義消息（請求）
message RPCDateRequest {
  string userName = 1;
}

// 定義消息（響應）
message RPCDateResponse {
  string serverDate = 1;
}

執行mvn compile命令來自動生成代碼Stub

mvn編譯完成以后，在target/generated-sources目錄下就能看到根據上面.proto文件自動轉化生成的Java代碼Stub

代碼生成結果如下所示

好了，既然gRPC-API已經有了，下面可以分別編寫服務端和客戶端

創建基于Maven的項目：Server

pom中添加 GrpcAPI 依賴

        
            com.hansonwang99
            GrpcAPI
            1.0-SNAPSHOT
            compile
        

接下來一步比較關鍵

實現gRPC服務接口

public class RPCDateServiceImpl extends RPCDateServiceGrpc.RPCDateServiceImplBase{
    @Override
    public void getDate(RPCDateRequest request, StreamObserver responseObserver) {
        RPCDateResponse rpcDateResponse = null;
        Date now=new Date();
        SimpleDateFormat simpleDateFormat = new SimpleDateFormat("今天是"+"yyyy年MM月dd日 E kk點mm分”);
        String nowTime = simpleDateFormat.format( now );
        try {
            rpcDateResponse = RPCDateResponse
                    .newBuilder()
                    .setServerDate( "Welcome " + request.getUserName()  + ", " + nowTime )
                    .build();
        } catch (Exception e) {
            responseObserver.onError(e);
        } finally {
            responseObserver.onNext( rpcDateResponse );
        }
        responseObserver.onCompleted();
    }
}

我想此處重寫的getDate()方法并不陌生吧，這正是上文 .proto 文件中定義的Service接口。
此處邏輯比較簡單：獲取當前時間，并且將其與請求RPCDateRequest中提取出的userName字段進行拼接，然后返回給調用端！形成一個閉環

創建gRPC服務端啟動類

public class GRPCServer {
    private static final int port = 9999;
    public static void main( String[] args ) throws Exception {
        Server server = ServerBuilder.
                forPort(port)
                .addService( new RPCDateServiceImpl() )
                .build().start();
        System.out.println( "grpc服務端啟動成功, 端口=" + port );
        server.awaitTermination();
    }
}

端口自定義的9999，也就是在該端口監聽。現在可以立即運行GRPCServer，來啟動服務端

創建基于Maven的項目：Client

pom中依然需要添加 GrpcAPI 依賴

        
            com.hansonwang99
            GrpcAPI
            1.0-SNAPSHOT
            compile
        

創建gRPC客戶端啟動類

public class GRPCClient {
    private static final String host = “localhost”;
    private static final int serverPort = 9999;

    public static void main( String[] args ) throws Exception {
        ManagedChannel managedChannel = ManagedChannelBuilder.forAddress( host, serverPort ).usePlaintext().build();
        try {
            RPCDateServiceGrpc.RPCDateServiceBlockingStub rpcDateService = RPCDateServiceGrpc.newBlockingStub( managedChannel );
            RPCDateRequest  rpcDateRequest = RPCDateRequest
                    .newBuilder()
                    .setUserName(“hansonwang99”)
                    .build();
            RPCDateResponse rpcDateResponse = rpcDateService.getDate( rpcDateRequest );
            System.out.println( rpcDateResponse.getServerDate() );
        } finally {
            managedChannel.shutdown();
        }
    }
}

現在立即啟動 GRPCClient！

還記得我們的目標嗎？

RPC完成的即是遠程的過程調用，在本實驗中那就是客戶端可以遠程調用服務端的getDate()過程，并將結果取到客戶端來顯示！

本文實驗代碼在此 → 需要自取

作者更多的原創文章在此，歡迎觀賞

My Personal Blog

作者更多的SpringBt實踐文章在此：

Spring Boot應用監控實戰

SpringBoot應用部署于外置Tomcat容器

ElasticSearch搜索引擎在SpringBt中的實踐

初探Kotlin+SpringBoot聯合編程

Spring Boot日志框架實踐

SpringBoot優雅編碼之：Lombok加持

如果有興趣，也可以抽點時間看看作者一些關于容器化、微服務化方面的文章：

利用K8S技術棧打造個人私有云 連載文章

從一份配置清單詳解Nginx服務器配置

Docker容器可視化監控中心搭建

利用ELK搭建Docker容器化應用日志中心

RPC框架實踐之：Apache Thrift

RPC框架實踐之：Google gRPC

微服務調用鏈追蹤中心搭建

Docker容器跨主機通信

Docker Swarm集群初探

高效編寫Dockerfile的幾條準則