org.marketcetera.util.ws.stateless

Class StatelessClient

java.lang.Object

org.marketcetera.util.ws.stateless.Node

org.marketcetera.util.ws.stateless.StatelessClient

All Implemented Interfaces:

UsesPort

Direct Known Subclasses:

Client

public class StatelessClient
extends Node

A client node for stateless communication. Its (optional) application ID is that of the application which hosts the client.

Since:

1.0.0

Version:

$Id: StatelessClient.java 17112 2016-02-11 17:58:19Z colin $

Author:

tlerios@marketcetera.com

Field Summary

Fields inherited from class org.marketcetera.util.ws.stateless.Node

DEFAULT_CLIENT_HOST, DEFAULT_PORT, DEFAULT_SERVER_HOST

Constructor Summary

Constructors

Constructor and Description
StatelessClient() Creates a new client node with the default server host name and port, and no client application ID.
StatelessClient(AppId appId) Creates a new client node with the default server host name and port, and the given client application ID.
StatelessClient(String host, int port, AppId appId) Creates a new client node with the given server host name, port, and client application ID.
StatelessClient(String inHost, int inPort, AppId inAppId, ContextClassProvider inContextClasses) Create a new StatelessClient instance.

Method Summary

Methods

Modifier and Type	Method and Description
protected void	fillContext(StatelessClientContext context) Sets the properties of the given client context, so that it may be used for remote calls made via proxies obtained from the receiver.
AppId	getAppId() Returns the receiver's application ID.
StatelessClientContext	getContext() Returns a client context which the client must supply as an argument to every remote call made via proxies obtained from the receiver.
<T extends StatelessServiceBase> T	getService(Class<T> inInterface) Retrieves the client-side proxy for the given service interface.

Methods inherited from class org.marketcetera.util.ws.stateless.Node

getConnectionUrl, getHost, getId, getNodeDescription, getPort, getPortDescriptors, setHost, setNodeDescription, setPort

Methods inherited from class java.lang.Object

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

Constructor Detail

StatelessClient

public StatelessClient(String inHost,
               int inPort,
               AppId inAppId,
               ContextClassProvider inContextClasses)

Create a new StatelessClient instance.

Parameters:

inHost - a String value

inPort - an int value

inAppId - an AppId value

inContextClasses - a ContextClassProvider value

StatelessClient

public StatelessClient(String host,
               int port,
               AppId appId)

Creates a new client node with the given server host name, port, and client application ID.

Parameters:

host - The host name.

port - The port.

appId - The application ID, which may be null.

StatelessClient

public StatelessClient(AppId appId)

Creates a new client node with the default server host name and port, and the given client application ID.

Parameters:

appId - The application ID, which may be null.

StatelessClient

public StatelessClient()

Creates a new client node with the default server host name and port, and no client application ID.

Method Detail

getAppId

public AppId getAppId()

Returns the receiver's application ID.

Returns:

The application ID, which may be null.

fillContext

protected void fillContext(StatelessClientContext context)

Sets the properties of the given client context, so that it may be used for remote calls made via proxies obtained from the receiver.

Parameters:

context - The context.

getContext

public StatelessClientContext getContext()

Returns a client context which the client must supply as an argument to every remote call made via proxies obtained from the receiver.

Returns:

The context.

getService

public <T extends StatelessServiceBase> T getService(Class<T> inInterface)

Retrieves the client-side proxy for the given service interface.

Parameters:

inInterface - The interface class.