io.grpc

Class Server

java.lang.Object

io.grpc.Server

@ThreadSafe
public abstract class Server
extends Object

Server for listening for and dispatching incoming calls. It is not expected to be implemented by application code or interceptors.

Constructor Summary

Constructors

Constructor and Description
Server()

Method Summary

Modifier and Type	Method and Description
abstract void	awaitTermination() Waits for the server to become terminated.
abstract boolean	awaitTermination(long timeout, TimeUnit unit) Waits for the server to become terminated, giving up if the timeout is reached.
int	getPort() Returns the port number the server is listening on.
abstract boolean	isShutdown() Returns whether the server is shutdown.
abstract boolean	isTerminated() Returns whether the server is terminated.
abstract Server	shutdown() Initiates an orderly shutdown in which preexisting calls continue but new calls are rejected.
abstract Server	shutdownNow() Initiates a forceful shutdown in which preexisting and new calls are rejected.
abstract Server	start() Bind and start the server.

Methods inherited from class java.lang.Object

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

Constructor Detail

Server

public Server()

Method Detail

start

public abstract Server start()
                      throws IOException

Bind and start the server.

Returns:

this object

Throws:

IllegalStateException - if already started

IOException - if unable to bind

getPort

@ExperimentalApi(value="https://github.com/grpc/grpc-java/issues/1780")
public int getPort()

Returns the port number the server is listening on. This can return -1 if there is no actual port or the result otherwise does not make sense. Result is undefined after the server is terminated.

Throws:

IllegalStateException - if the server has not yet been started.

shutdown

public abstract Server shutdown()

Initiates an orderly shutdown in which preexisting calls continue but new calls are rejected.

shutdownNow

public abstract Server shutdownNow()

Initiates a forceful shutdown in which preexisting and new calls are rejected. Although forceful, the shutdown process is still not instantaneous; isTerminated() will likely return false immediately after this method returns.

isShutdown

public abstract boolean isShutdown()

Returns whether the server is shutdown. Shutdown servers reject any new calls, but may still have some calls being processed.

See Also:

shutdown(), isTerminated()

isTerminated

public abstract boolean isTerminated()

Returns whether the server is terminated. Terminated servers have no running calls and relevant resources released (like TCP connections).

See Also:

isShutdown()

awaitTermination

public abstract boolean awaitTermination(long timeout,
                                         TimeUnit unit)
                                  throws InterruptedException

Waits for the server to become terminated, giving up if the timeout is reached.

Returns:

whether the server is terminated, as would be done by isTerminated().

Throws:

InterruptedException

awaitTermination

public abstract void awaitTermination()
                               throws InterruptedException

Waits for the server to become terminated.

Throws:

InterruptedException