io.grpc.inprocess

Class InProcessServerBuilder

java.lang.Object

io.grpc.ServerBuilder<T>

io.grpc.internal.AbstractServerImplBuilder<InProcessServerBuilder>

io.grpc.inprocess.InProcessServerBuilder

@ExperimentalApi(value="https://github.com/grpc/grpc-java/issues/1783")
public final class InProcessServerBuilder
extends io.grpc.internal.AbstractServerImplBuilder<InProcessServerBuilder>

Builder for a server that services in-process requests. Clients identify the in-process server by its name.

The server is intended to be fully-featured, high performance, and useful in testing.

Using JUnit TestRule

The class "GrpcServerRule" (from "grpc-java/testing") is a JUnit TestRule that creates a InProcessServer and a ManagedChannel. This test rule contains the boilerplate code shown below. The classes "HelloWorldServerTest" and "HelloWorldClientTest" (from "grpc-java/examples") demonstrate basic usage.

Usage example

Server and client channel setup

   Server server = InProcessServerBuilder.forName("unique-name")
       .directExecutor() // directExecutor is fine for unit tests
       .addService(/* your code here */)
       .build().start();
   ManagedChannel channel = InProcessChannelBuilder.forName("unique-name")
       .directExecutor()
       .build();
 

Usage in tests

The channel can be used normally. A blocking stub example:

   TestServiceGrpc.TestServiceBlockingStub blockingStub =
       TestServiceGrpc.newBlockingStub(channel);
 

Method Summary

Modifier and Type	Method and Description
protected io.grpc.inprocess.InProcessServer	buildTransportServer(List<ServerStreamTracer.Factory> streamTracerFactories)
static InProcessServerBuilder	forName(String name) Create a server builder that will bind with the given name.
static InProcessServerBuilder	forPort(int port) Always fails.
InProcessServerBuilder	useTransportSecurity(File certChain, File privateKey) Makes the server use TLS.

Methods inherited from class io.grpc.internal.AbstractServerImplBuilder

addService, addService, addStreamTracerFactory, addTransportFilter, build, compressorRegistry, decompressorRegistry, directExecutor, executor, fallbackHandlerRegistry, handshakeTimeout, intercept, setStatsEnabled, setTracingEnabled, statsContextFactory

Methods inherited from class java.lang.Object

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

Method Detail

forName

public static InProcessServerBuilder forName(String name)

Create a server builder that will bind with the given name.

Parameters:

name - the identity of the server for clients to connect to

Returns:

a new builder

forPort

public static InProcessServerBuilder forPort(int port)

Always fails. Call forName(java.lang.String) instead.

buildTransportServer

protected io.grpc.inprocess.InProcessServer buildTransportServer(List<ServerStreamTracer.Factory> streamTracerFactories)

Specified by:

buildTransportServer in class io.grpc.internal.AbstractServerImplBuilder<InProcessServerBuilder>

useTransportSecurity

public InProcessServerBuilder useTransportSecurity(File certChain,
                                                   File privateKey)

Description copied from class: ServerBuilder

Makes the server use TLS.

Specified by:

useTransportSecurity in class ServerBuilder<InProcessServerBuilder>

Parameters:

certChain - file containing the full certificate chain

privateKey - file containing the private key

Returns:

this