org.glassfish.grizzly.thrift.client

Interface ThriftClient<T extends org.apache.thrift.TServiceClient>

All Superinterfaces:

ThriftClientLifecycle

All Known Implementing Classes:

GrizzlyThriftClient

public interface ThriftClient<T extends org.apache.thrift.TServiceClient>
extends ThriftClientLifecycle

The thrift client's interface

By addServer(java.net.SocketAddress) and removeServer(java.net.SocketAddress), servers can be added and removed dynamically in this thrift client. In other words, the managed server list can be changed in runtime by APIs. By execute(org.glassfish.grizzly.thrift.client.ThriftClientCallback<T, U>), user can execute custom service(For more information, please see ThriftClientCallback's javadoc).

Author:

Bongjae Chang

Method Summary

Modifier and Type	Method and Description
boolean	addServer(SocketAddress serverAddress) Add a specific server in this thrift client
<U> U	execute(ThriftClientCallback<T,U> callback)
String	getName() Return the name of the thrift client.
boolean	isInServerList(SocketAddress serverAddress) Check if this thrift client contains the given server
void	removeServer(SocketAddress serverAddress) Remove the given server in this thrift client

Methods inherited from interface org.glassfish.grizzly.thrift.client.ThriftClientLifecycle

start, stop

Method Detail

execute

<U> U execute(ThriftClientCallback<T,U> callback)
       throws Exception

Throws:

Exception

getName

String getName()

Return the name of the thrift client.

Returns:

the name of the thrift client.

addServer

boolean addServer(SocketAddress serverAddress)

Add a specific server in this thrift client

Parameters:

serverAddress - a specific server's SocketAddress to be added

Returns:

true if the given serverAddress is added successfully

removeServer

void removeServer(SocketAddress serverAddress)

Remove the given server in this thrift client

Parameters:

serverAddress - the specific server's SocketAddress to be removed in this thrift client

isInServerList

boolean isInServerList(SocketAddress serverAddress)

Check if this thrift client contains the given server

Parameters:

serverAddress - the specific server's SocketAddress to be checked

Returns:

true if this thrift client already contains the given serverAddress