net.xoetrope.optional.service
Class ServiceProxy

java.lang.Object
  net.xoetrope.optional.service.ServiceProxy

public abstract class ServiceProxy
extends java.lang.Object

The basis of each element in the service proxy stack.

Copyright (c) Xoetrope Ltd. 2001-2003

$Revision: 2.8 $

Field Summary

static int	COMPLETE The call has ended
protected XExceptionHandler	exceptionHandler
static int	FAILED The call has failed
protected ServiceProxy	nextProxy The next proxy in the route
static int	OK Call is OK
static int	PENDING The call is pending
protected java.lang.String	routeName The name of the route of which this ServiceProxy is a layer
protected java.lang.String	serviceName The name of the service being called
protected int	side is this instance of the layer on the client or the server?
static int	STARTED The call has been started
protected int	status The status of the ServiceProxy call

Constructor Summary

ServiceProxy()

Method Summary

java.lang.Object	call() Calls call( null, null )
abstract java.lang.Object	call(java.lang.String method, ServiceContext context) Call this proxy with the specified arguments
java.lang.Object	callNextProxy(java.lang.String method, ServiceContext context, java.lang.Object ret) Utility function to call the next ServiceProxy if it is not null.
protected java.lang.String	getRouteName() Retrieve the name of the proxy route.
protected java.lang.String	getServiceName() Retrieves the service name.
protected int	getSide() Retrieve the side of the proxy (Client or Server)
int	getStatus() Retrieves the current state of the proxy
void	setAttributes(java.util.Hashtable t) Set the attributes for this service proxy.
void	setExceptionHandler(XExceptionHandler handler) Set an exception handler for the ServiceProxy
void	setNextProxy(ServiceProxy sp) Set the next ServiceProxy in the route.
void	setRouteName(java.lang.String route) Set the name of the proxy route
void	setServiceName(java.lang.String name) Sets the proxy service name
void	setSide(int activeSide) Sets the side on which the proxy resides (Client or Server)

Methods inherited from class java.lang.Object

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

Field Detail

OK

public static final int OK

Call is OK

See Also:

Constant Field Values

STARTED

public static final int STARTED

The call has been started

See Also:

Constant Field Values

PENDING

public static final int PENDING

The call is pending

See Also:

Constant Field Values

COMPLETE

public static final int COMPLETE

The call has ended

See Also:

Constant Field Values

FAILED

public static final int FAILED

The call has failed

See Also:

Constant Field Values

routeName

protected java.lang.String routeName

The name of the route of which this ServiceProxy is a layer

serviceName

protected java.lang.String serviceName

The name of the service being called

status

protected int status

The status of the ServiceProxy call

nextProxy

protected ServiceProxy nextProxy

The next proxy in the route

side

protected int side

is this instance of the layer on the client or the server?

exceptionHandler

protected XExceptionHandler exceptionHandler

Constructor Detail

ServiceProxy

public ServiceProxy()

Method Detail

call

public java.lang.Object call()
                      throws ServiceProxyException

Calls call( null, null )

Returns:

the result of the service call

Throws:

ServiceProxyException - Throw a ServiceProxyException if there is a problem

call

public abstract java.lang.Object call(java.lang.String method,
                                      ServiceContext context)
                               throws ServiceProxyException

Call this proxy with the specified arguments

Parameters:

context - The ServiceContext contain pass and return parameters

method - the name of the service being called

Returns:

the result of the call

Throws:

ServiceProxyException - Throw an exception if there is a problem with the call

callNextProxy

public java.lang.Object callNextProxy(java.lang.String method,
                                      ServiceContext context,
                                      java.lang.Object ret)
                               throws ServiceProxyException

Utility function to call the next ServiceProxy if it is not null.

Parameters:

context - The ServiceContext contain pass and return parameters

method - the name of the service being called

ret - the return object if the next proxy is null

Returns:

the passed return object or the result of the proxy call

Throws:

ServiceProxyException - Throw an exception if there is a problem with the call

getStatus

public int getStatus()

Retrieves the current state of the proxy

Returns:

the proxy state

setSide

public void setSide(int activeSide)

Sets the side on which the proxy resides (Client or Server)

Parameters:

activeSide - the side of the proxy

getSide

protected int getSide()

Retrieve the side of the proxy (Client or Server)

Returns:

the proxy instance side

getRouteName

protected java.lang.String getRouteName()

Retrieve the name of the proxy route.

Returns:

the route name

setRouteName

public void setRouteName(java.lang.String route)

Set the name of the proxy route

Parameters:

route - the route name

getServiceName

protected java.lang.String getServiceName()

Retrieves the service name.

Returns:

the name of the proxy service

setServiceName

public void setServiceName(java.lang.String name)

Sets the proxy service name

Parameters:

name - the proxy service name

setNextProxy

public void setNextProxy(ServiceProxy sp)

Set the next ServiceProxy in the route.

Parameters:

sp - the next ServiceProxy in the route

setAttributes

public void setAttributes(java.util.Hashtable t)

Set the attributes for this service proxy.

Parameters:

t - The Hashtable of attributes as found in the XML declaration

setExceptionHandler

public void setExceptionHandler(XExceptionHandler handler)

Set an exception handler for the ServiceProxy

Parameters:

handler - The XExceptionHandler which will take care of problems.