English | 简体中文

gRPC-Java-Polaris is a service management component based on the Grpc extension, which is convenient for developers who use Grpc to quickly access polaris and use the functions of service registration, load balancing, fusing, and current limiting provided by polaris.

• grpc-java-polaris　　　　　　　　Core code based on Grpc extended functions
• grpc-java-polaris-example　　　　Get started quickly with the use case of grpc-java-polaris

Copy the following command to clone the source code to the local:

git clone https://github.com/polarismesh/grpc-java-polaris.git

Then execute the install command to install the grpc-java-polaris project to the local maven warehouse:

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

Add grpc-java-polaris dependency to the developed Grpc project:

<dependency>
   <groupId>com.tencent.polaris</groupId>
   <artifactId>grpc-java-polaris</artifactId>
   <version>${grpc-java-polaris.version}</version>
</dependency>

The server uses the PolarisGrpcServer provided by the grpc-java-polaris package to create a grpc server. PolarisGrpcServer internally encapsulates service registration, heartbeat logic, etc:

PolarisGrpcServer polarisGrpcServer = PolarisGrpcServer.builder()
        .port(50051)
        .namespace("default")
        .applicationName("grpc-demo-java")
        .metadata(null)
        .bindableServices(services)
        .build();
        
polarisGrpcServer.start();

The client need replace the ManagedChannelBuilder to PolarisManagedChannelBuilder:

ManagedChannel channel = PolarisManagedChannelBuilder.forTarget("polaris://grpc-demo-java:8080?namespace=default")
        .usePlaintext().build();

• QuickStart