Class GRPCTestHelper

java.lang.Object

org.summerboot.jexpress.nio.grpc.GRPCTestHelper

public abstract class GRPCTestHelper
extends Object

For testing gRPC with two-way TLS. (usage and example see https://github.com/SummerBootFramework/jExpressDemo-HelloSummer/blob/main/HelloSummer-demo02/src/test/java/test/integration/grpc/GrpcTest.java)

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	GRPCTestHelper.GRPCSimpleClient

Constructor Summary

Constructors

Constructor	Description
GRPCTestHelper()

Method Summary

Modifier and Type	Method	Description
protected GRPCTestHelper.GRPCSimpleClient[]	buildDefaultTestConfigs()
static io.grpc.netty.shaded.io.grpc.netty.NettyChannelBuilder	buildGRPCClient(String tlsProtocal, String host, int port, String loadBalancingPolicy, String loadBalancingTargetScheme, KeyManagerFactory kmfClient, TrustManagerFactory tmfClient, String overrideAuthority)
static io.grpc.netty.shaded.io.grpc.netty.NettyChannelBuilder	buildGRPCClient(String tlsProtocal, String host, int port, KeyManagerFactory kmfClient, TrustManagerFactory tmfClient, String overrideAuthority)
static io.grpc.netty.shaded.io.grpc.netty.NettyChannelBuilder	buildGRPCClient(GRPCTestHelper.GRPCSimpleClient config)
static GRPCServer	buildGRPCServer(String host, int port, KeyManagerFactory kmfServer, TrustManagerFactory tmfServer, io.grpc.BindableService... serviceImps)
static GRPCServer	buildGRPCServer(GRPCTestHelper.GRPCSimpleClient config, io.grpc.BindableService... serviceImps)
protected abstract io.grpc.BindableService[]	getServerImpls()
protected abstract void	runClient(io.grpc.netty.shaded.io.grpc.netty.NettyChannelBuilder channelBuilder)
void	test2WayTLS()
void	test2WayTLS(String host, int port, KeyManagerFactory kmfServer, TrustManagerFactory tmfServer, io.grpc.BindableService[] serviceImpls, String loadBalancingTargetScheme, String tlsProtocalClient, KeyManagerFactory kmfClient, TrustManagerFactory tmfClient, String overrideAuthority)	Run a gRPC server and client with two-way TLS.
void	test2WayTLS(GRPCTestHelper.GRPCSimpleClient config)

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

GRPCTestHelper

public GRPCTestHelper()

Method Details

buildGRPCServer

public static GRPCServer buildGRPCServer(GRPCTestHelper.GRPCSimpleClient config,
 io.grpc.BindableService... serviceImps)
                                  throws GeneralSecurityException,
IOException

Throws:

GeneralSecurityException

IOException

buildGRPCServer

public static GRPCServer buildGRPCServer(String host,
 int port,
 KeyManagerFactory kmfServer,
 TrustManagerFactory tmfServer,
 io.grpc.BindableService... serviceImps)
                                  throws IOException

Throws:

IOException

buildGRPCClient

public static io.grpc.netty.shaded.io.grpc.netty.NettyChannelBuilder buildGRPCClient(GRPCTestHelper.GRPCSimpleClient config)
                                                                              throws IOException,
GeneralSecurityException

Throws:

IOException

GeneralSecurityException

buildGRPCClient

public static io.grpc.netty.shaded.io.grpc.netty.NettyChannelBuilder buildGRPCClient(String tlsProtocal,
 String host,
 int port,
 KeyManagerFactory kmfClient,
 TrustManagerFactory tmfClient,
 String overrideAuthority)
                                                                              throws SSLException

Throws:

SSLException

buildGRPCClient

public static io.grpc.netty.shaded.io.grpc.netty.NettyChannelBuilder buildGRPCClient(String tlsProtocal,
 String host,
 int port,
 String loadBalancingPolicy,
 String loadBalancingTargetScheme,
 KeyManagerFactory kmfClient,
 TrustManagerFactory tmfClient,
 String overrideAuthority)
                                                                              throws SSLException

Throws:

SSLException

test2WayTLS

public void test2WayTLS()
                 throws GeneralSecurityException,
IOException

Throws:

GeneralSecurityException

IOException

buildDefaultTestConfigs

protected GRPCTestHelper.GRPCSimpleClient[] buildDefaultTestConfigs()
                                                             throws GeneralSecurityException,
IOException

Throws:

GeneralSecurityException

IOException

getServerImpls

protected abstract io.grpc.BindableService[] getServerImpls()

test2WayTLS

public void test2WayTLS(GRPCTestHelper.GRPCSimpleClient config)
                 throws IOException

Throws:

IOException

test2WayTLS

public void test2WayTLS(String host,
 int port,
 KeyManagerFactory kmfServer,
 TrustManagerFactory tmfServer,
 io.grpc.BindableService[] serviceImpls,
 String loadBalancingTargetScheme,
 String tlsProtocalClient,
 KeyManagerFactory kmfClient,
 TrustManagerFactory tmfClient,
 String overrideAuthority)
                 throws IOException

Run a gRPC server and client with two-way TLS.

Parameters:

host - the host for the server and client

port - the port for the server and client

kmfServer - KeyManagerFactory for the server

tmfServer - TrustManagerFactory for the server

serviceImpls - array of BindableService implementations for the server

loadBalancingTargetScheme - scheme for load balancing target

kmfClient - KeyManagerFactory for the client

tmfClient - TrustManagerFactory for the client

overrideAuthority - override authority for the client

Throws:

IOException - if an I/O error occurs

runClient

protected abstract void runClient(io.grpc.netty.shaded.io.grpc.netty.NettyChannelBuilder channelBuilder)