pl.chilldev.commons.jsonrpc.client

Class Connector

java.lang.Object

pl.chilldev.commons.jsonrpc.client.Connector

All Implemented Interfaces:

IoServiceUtils.Configuration

public class Connector
extends Object
implements IoServiceUtils.Configuration

Single TCP client.

Field Summary

Fields

Modifier and Type	Field and Description
protected InetSocketAddress	address Listening address.
protected org.apache.mina.transport.socket.nio.NioSocketConnector	connector Connector itself.
static int	DEFAULT_PACKET_LIMIT Default packet size limit.
protected RequestIoHandler	handler JSON-RCP handler.
protected org.slf4j.Logger	logger Logger.
protected int	maxPacketSize Maximum size of JSON-RPC packet.
protected org.apache.mina.core.session.IoSession	session Current connection session.

Constructor Summary

Constructors

Constructor and Description
Connector(org.apache.mina.transport.socket.nio.NioSocketConnector connector, RequestIoHandler handler, InetSocketAddress address) Initializes connector with given configuration.

Method Summary

Modifier and Type	Method and Description
org.apache.mina.core.future.ConnectFuture	connect() Connects to server.
static Connector	create(InetSocketAddress address) Creates connector instance with default resources.
static Connector	create(String host, int port) Creates connector instance with default resources.
void	dispose() Releases all resources.
protected Object	execute(com.thetransactioncompany.jsonrpc2.JSONRPC2Request request) Executes queued RPC call.
Object	execute(String method) Executes remote call without parameters.
Object	execute(String method, Map<String,Object> params) Executes remote call with parameters.
protected static long	generateRequestId() Generates new request ID.
int	getMaxPacketSize() Returns size of maximum JSON-RPC packet size.
void	reconnect(org.apache.mina.core.future.ConnectFuture future) Enforces connection to server.
void	setMaxPacketSize(int maxPacketSize) Sets max JSON-RPC packet size.

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT_PACKET_LIMIT

public static final int DEFAULT_PACKET_LIMIT

Default packet size limit.

See Also:

Constant Field Values

logger

protected org.slf4j.Logger logger

Logger.

address

protected InetSocketAddress address

Listening address.

maxPacketSize

protected int maxPacketSize

Maximum size of JSON-RPC packet.

connector

protected org.apache.mina.transport.socket.nio.NioSocketConnector connector

Connector itself.

handler

protected RequestIoHandler handler

JSON-RCP handler.

session

protected org.apache.mina.core.session.IoSession session

Current connection session.

Constructor Detail

Connector

public Connector(org.apache.mina.transport.socket.nio.NioSocketConnector connector,
                 RequestIoHandler handler,
                 InetSocketAddress address)

Initializes connector with given configuration.

Parameters:

connector - Socket connector.

handler - JSON-RPC request handler.

address - Listening address.

Method Detail

setMaxPacketSize

public void setMaxPacketSize(int maxPacketSize)

Sets max JSON-RPC packet size.

Parameters:

maxPacketSize - Packet size in bytes.

getMaxPacketSize

public int getMaxPacketSize()

Returns size of maximum JSON-RPC packet size.

Specified by:

getMaxPacketSize in interface IoServiceUtils.Configuration

Returns:

Maximum packet size.

execute

public Object execute(String method)
               throws RpcCallException

Executes remote call without parameters.

Parameters:

method - Method name.

Returns:

Response.

Throws:

RpcCallException - When execution fails.

execute

public Object execute(String method,
                      Map<String,Object> params)
               throws RpcCallException

Executes remote call with parameters.

Parameters:

method - Method name.

params - RPC params.

Returns:

Response.

Throws:

RpcCallException - When execution fails.

execute

protected Object execute(com.thetransactioncompany.jsonrpc2.JSONRPC2Request request)
                  throws RpcCallException

Executes queued RPC call.

Parameters:

request - JSON-RPC request.

Returns:

Method result.

Throws:

RpcCallException - When execution fails.

connect

public org.apache.mina.core.future.ConnectFuture connect()

Connects to server.

Returns:

Connection establishing future.

reconnect

public void reconnect(org.apache.mina.core.future.ConnectFuture future)

Enforces connection to server.

Parameters:

future - Connection establishing future.

dispose

public void dispose()

Releases all resources.

create

public static Connector create(InetSocketAddress address)

Creates connector instance with default resources.

Parameters:

address - Server address.

Returns:

Client connector.

create

public static Connector create(String host,
                               int port)

Creates connector instance with default resources.

Parameters:

host - Listen host.

port - Listen port.

Returns:

Client connector.

generateRequestId

protected static long generateRequestId()

Generates new request ID.

Returns:

Request ID.