org.apache.flink.runtime.ipc

Class Server

java.lang.Object

org.apache.flink.runtime.ipc.Server

Direct Known Subclasses:

RPC.Server

public abstract class Server
extends Object

Field Summary

Fields

Modifier and Type	Field and Description
static ByteBuffer	HEADER
static String	IPC_THREAD_NAME_PREFIX
static org.slf4j.Logger	LOG

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	Server(String bindAddress, int port, Class<? extends IOReadableWritable> paramClass, int handlerCount)
protected	Server(String bindAddress, int port, Class<? extends IOReadableWritable> invocationClass, int handlerCount, String serverName) Constructs a server listening on the named port and address.

Method Summary

Modifier and Type	Method and Description
static void	bind(ServerSocket socket, InetSocketAddress address, int backlog) A convenience method to bind to a given address and report better exceptions if the address is not a valid host.
abstract IOReadableWritable	call(Class<?> protocol, IOReadableWritable param, long receiveTime) Called for each call.
static Server	get()
int	getCallQueueLen() The number of rpc calls in the queue.
InetSocketAddress	getListenerAddress() Return the socket (ip+port) on which the RPC server is listening to.
int	getNumOpenConnections() The number of open RPC conections
static String	getRemoteAddress() Returns remote address as a string when invoked inside an RPC.
static InetAddress	getRemoteIp() Returns the remote side ip address when invoked inside an RPC Returns null in case of an error.
void	join() Wait for the server to be stopped.
static <T> T	newInstance(Class<T> theClass)
void	setSocketSendBufSize(int size) Sets the socket buffer size used for responding to RPCs
void	start() Starts the service.
void	stop() Stops the service.

Methods inherited from class java.lang.Object

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

Field Detail

LOG

public static final org.slf4j.Logger LOG

HEADER

public static final ByteBuffer HEADER

IPC_THREAD_NAME_PREFIX

public static final String IPC_THREAD_NAME_PREFIX

See Also:

Constant Field Values

Constructor Detail

Server

protected Server(String bindAddress,
                 int port,
                 Class<? extends IOReadableWritable> paramClass,
                 int handlerCount)
          throws IOException

Throws:

IOException

Server

protected Server(String bindAddress,
                 int port,
                 Class<? extends IOReadableWritable> invocationClass,
                 int handlerCount,
                 String serverName)
          throws IOException

Constructs a server listening on the named port and address. Parameters passed must be of the named class. The handlerCount determines the number of handler threads that will be used to process calls.

Throws:

IOException

Method Detail

get

public static Server get()

getRemoteIp

public static InetAddress getRemoteIp()

Returns the remote side ip address when invoked inside an RPC Returns null in case of an error.

getRemoteAddress

public static String getRemoteAddress()

Returns remote address as a string when invoked inside an RPC. Returns null in case of an error.

bind

public static void bind(ServerSocket socket,
                        InetSocketAddress address,
                        int backlog)
                 throws IOException

A convenience method to bind to a given address and report better exceptions if the address is not a valid host.

Parameters:

socket - the socket to bind

address - the address to bind to

backlog - the number of connections allowed in the queue

Throws:

BindException - if the address can't be bound

UnknownHostException - if the address isn't a valid host name

IOException - other random errors from bind

setSocketSendBufSize

public void setSocketSendBufSize(int size)

Sets the socket buffer size used for responding to RPCs

start

public void start()
           throws IOException

Starts the service. Must be called before any calls will be handled.

Throws:

IOException

stop

public void stop()

Stops the service. No new calls will be handled after this is called.

join

public void join()
          throws InterruptedException

Wait for the server to be stopped. Does not wait for all subthreads to finish. See stop().

Throws:

InterruptedException

getListenerAddress

public InetSocketAddress getListenerAddress()

Return the socket (ip+port) on which the RPC server is listening to.

Returns:

the socket (ip+port) on which the RPC server is listening to.

call

public abstract IOReadableWritable call(Class<?> protocol,
                                        IOReadableWritable param,
                                        long receiveTime)
                                 throws IOException

Called for each call.

Throws:

IOException

getNumOpenConnections

public int getNumOpenConnections()

The number of open RPC conections

Returns:

the number of open rpc connections

getCallQueueLen

public int getCallQueueLen()

The number of rpc calls in the queue.

Returns:

The number of rpc calls in the queue.

newInstance

public static <T> T newInstance(Class<T> theClass)