Triple-Samples

Triple is an application layer's protocol based on HTTP/2, which supports interoperating with GRPC protocol naturally using Protobuf serialization. For non-protobuf applications, triple provides a compatible mode to upgrade without code modifications. So it is smooth to migrate to triple.

This sample project contains most scenarios of Dubbo and non-Dubbo interoperation.

Before Start

Generate protobuf class for IDE hints.

mvn clean -DskipTests=true

For beginners

1. Start a zookeeper or config other registry in org.apache.dubbo.sample.tri.stub.TriStubServer and org.apache.dubbo.sample.tri.stub.TriStubClient
2. Build with mvn clean install to generate protobuf classes.
3. Run org.apache.dubbo.sample.tri.stub.TriStubServer
4. Run org.apache.dubbo.sample.tri.stub.TriStubClient

For dubbo2 or non-prototbuf users

Run org.apache.dubbo.sample.tri.pojo.TriPojoServer and org.apache.dubbo.sample.tri.pojo.TriPojoClient.

Dubbo3 will wrap request and response with a protobuf wrapper automatically, so it is still compatible with GRPC.

For Dubbo developers

Code under test folder is a general interoperation test suite for both Dubbo/Dubbo and Dubbo/GRPC.

Dubbo/Dubbo test

1. Run org.apache.dubbo.sample.tri.TriGrpcProvider
2. Run org.apache.dubbo.sample.tri.TriClientTest , org.apache.dubbo.sample.tri.TriPojoClientTest and org.apache.dubbo.sample.tri.TriGenericTest

Dubbo/GRPC test

GRPC --> Dubbo

1. Run org.apache.dubbo.sample.tri.TriGrpcProvider
2. Run org.apache.dubbo.sample.tri.grpc.GrpcClientTest

Dubbo --> GRPC

1. Run org.apache.dubbo.sample.tri.grpc.GrpcServer
2. Run org.apache.dubbo.sample.tri.TriClientTest