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

   String uniqueName = InProcessServerBuilder.generateName();
   Server server = InProcessServerBuilder.forName(uniqueName)
       .directExecutor() // directExecutor is fine for unit tests
       .addService(/* your code here */)
       .build().start();
   ManagedChannel channel = InProcessChannelBuilder.forName(uniqueName)
       .directExecutor()
       .build();
 

Usage in tests

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

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

Field Summary

Fields inherited from class io.grpc.internal.AbstractServerImplBuilder

binlog, callTracerFactory, channelz, transportTracerFactory

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.
static String	generateName() Generates a new server name that is unique each time.
InProcessServerBuilder	scheduledExecutorService(ScheduledExecutorService scheduledExecutorService) Provides a custom scheduled executor service.
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, overrideCensusStatsModule, setBinaryLog, setStatsEnabled, setStatsRecordFinishedRpcs, setStatsRecordStartedRpcs, setTracingEnabled

Methods inherited from class io.grpc.ServerBuilder

maxInboundMessageSize, useTransportSecurity

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.

generateName

public static String generateName()

Generates a new server name that is unique each time.

scheduledExecutorService

public InProcessServerBuilder scheduledExecutorService(ScheduledExecutorService scheduledExecutorService)

Provides a custom scheduled executor service.

It's an optional parameter. If the user has not provided a scheduled executor service when the channel is built, the builder will use a static cached thread pool.

Returns:

this

Since:

1.11.0

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