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);
 

Method Summary

Modifier and Type	Method and Description
protected List<io.grpc.inprocess.InProcessServer>	buildTransportServers(List<? extends ServerStreamTracer.Factory> streamTracerFactories)
InProcessServerBuilder	deadlineTicker(Deadline.Ticker ticker) Provides a custom deadline ticker that this server will use to create incoming Deadlines.
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	maxInboundMetadataSize(int bytes) Sets the maximum size of metadata allowed to be received.
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, getChannelz, getExecutorPool, getTransportTracerFactory, handshakeTimeout, intercept, setBinaryLog, setDeadlineTicker, setStatsEnabled, setStatsRecordFinishedRpcs, setStatsRecordRealTimeMetrics, setStatsRecordStartedRpcs, setTracingEnabled, setTransportTracerFactory

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

deadlineTicker

public InProcessServerBuilder deadlineTicker(Deadline.Ticker ticker)

Provides a custom deadline ticker that this server will use to create incoming Deadlines.

This is intended for unit tests that fake out the clock. You should also have a fake ScheduledExecutorService whose clock is synchronized with this ticker and set it to scheduledExecutorService(java.util.concurrent.ScheduledExecutorService). DO NOT use this in production.

Returns:

this

Since:

1.24.0

See Also:

Deadline.after(long, TimeUnit, Deadline.Ticker)

maxInboundMetadataSize

public InProcessServerBuilder maxInboundMetadataSize(int bytes)

Sets the maximum size of metadata allowed to be received. Integer.MAX_VALUE disables the enforcement. Defaults to no limit (Integer.MAX_VALUE).

There is potential for performance penalty when this setting is enabled, as the Metadata must actually be serialized. Since the current implementation of Metadata pre-serializes, it's currently negligible. But Metadata is free to change its implementation.

Overrides:

maxInboundMetadataSize in class ServerBuilder<InProcessServerBuilder>

Parameters:

bytes - the maximum size of received metadata

Returns:

this

Throws:

IllegalArgumentException - if bytes is non-positive

Since:

1.17.0

buildTransportServers

protected List<io.grpc.inprocess.InProcessServer> buildTransportServers(List<? extends ServerStreamTracer.Factory> streamTracerFactories)

Specified by:

buildTransportServers 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