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.

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

Methods

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.
void	dispose() Releases all resources.
protected Object	execute(FutureTask<com.thetransactioncompany.jsonrpc2.JSONRPC2Response> future) 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.
int	getMaxPacketSize() Returns size of maximum JSON-RPC packet size.
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.

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 ExecutionException,
                      com.thetransactioncompany.jsonrpc2.JSONRPC2Error

Executes remote call without parameters.

Parameters:

method - Method name.

Returns:

Response.

Throws:

ExecutionException - When execution fails on client side or due to a connection.

com.thetransactioncompany.jsonrpc2.JSONRPC2Error - When execution fails on server side.

execute

public Object execute(String method,
             Map<String,Object> params)
               throws ExecutionException,
                      com.thetransactioncompany.jsonrpc2.JSONRPC2Error

Executes remote call with parameters.

Parameters:

method - Method name.

params - RPC params.

Returns:

Response.

Throws:

ExecutionException - When execution fails on client side or due to a connection.

com.thetransactioncompany.jsonrpc2.JSONRPC2Error - When execution fails on server side.

execute

protected Object execute(FutureTask<com.thetransactioncompany.jsonrpc2.JSONRPC2Response> future)
                  throws ExecutionException,
                         com.thetransactioncompany.jsonrpc2.JSONRPC2Error

Executes queued RPC call.

Parameters:

future - Response fetcher future.

Returns:

Method result.

Throws:

ExecutionException - When execution fails on client side or due to a connection.

com.thetransactioncompany.jsonrpc2.JSONRPC2Error - When execution fails on server side.

connect

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

Connects to server.

Returns:

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.