com.goldencode.p2j.util

Class LegacyJavaAppserverClientProxy

java.lang.Object

com.goldencode.p2j.util.LegacyJavaAppserverClientProxy

public abstract class LegacyJavaAppserverClientProxy
extends java.lang.Object

Base class for legacy open client proxy programs. This provides also high-level APIs to manage the remote persistent procedure, data objects and more.

Field Summary

Fields

Modifier and Type	Field and Description
protected LegacyJavaAppserverClient	client Helper which is used to connect and invoke remote programs.
protected static LegacyJavaAppserver	HELPER A static helper which is used by generated proxy's metadata APIs.
protected handle	proxy The proxy procedure.

Constructor Summary

Constructors

Constructor and Description
LegacyJavaAppserverClientProxy(LegacyJavaAppserverClient client) Create a new instance with the specified client.
LegacyJavaAppserverClientProxy(LegacyJavaAppserverClient client, boolean trackChanges) Create a new instance with the specified client.

Method Summary

Modifier and Type	Method and Description
void	addRow(commonj.sdo.DataGraph graph, commonj.sdo.DataObject row) Add the specified row to its table.
void	cancelAllRequests() Cancel all active requests on this client.
static void	configureMetadataHelper(boolean defaultTrackingChanges, boolean normalizedExtent) Configure the HELPER used by the generated proxies to create the metadata.
commonj.sdo.DataObject	createRow(commonj.sdo.DataGraph graph, java.lang.String table) Create a row for the specified table.
void	dispose() Delete the proxy.
LegacyJavaAppserver	getMetadataHelper() Get the helper used by generated proxy metadata APIs.
void	invokeWithArgs(java.lang.String target, LegacyJavaAppserverParameter... paramArray) Perform a pseudo-dynamic call where the target procedure doesn't receive the parameter as arguments at the Java method definition, but instead they are managed via LegacyOpenClientCaller APIs.
java.util.List<commonj.sdo.DataObject>	listRows(commonj.sdo.DataGraph graph, java.lang.String table) List all the rows in the specified table.

Methods inherited from class java.lang.Object

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

Field Detail

HELPER

protected static final LegacyJavaAppserver HELPER

A static helper which is used by generated proxy's metadata APIs. This must be initialized by the client application using initializeAppserverHelper

client

protected final LegacyJavaAppserverClient client

Helper which is used to connect and invoke remote programs.

proxy

protected handle proxy

The proxy procedure.

Constructor Detail

LegacyJavaAppserverClientProxy

public LegacyJavaAppserverClientProxy(LegacyJavaAppserverClient client)

Create a new instance with the specified client.

Parameters:

client - The proxy client.

LegacyJavaAppserverClientProxy

public LegacyJavaAppserverClientProxy(LegacyJavaAppserverClient client,
                                      boolean trackChanges)

Create a new instance with the specified client.

Parameters:

client - The proxy client.

trackChanges - Flag indicating if changes are tracked for all datasets, by default.

Method Detail

configureMetadataHelper

public static void configureMetadataHelper(boolean defaultTrackingChanges,
                                           boolean normalizedExtent)

Configure the HELPER used by the generated proxies to create the metadata.

Parameters:

defaultTrackingChanges - Flag indicating if changes are tracked for all datasets, by default.

normalizedExtent - The extent mode.

getMetadataHelper

public LegacyJavaAppserver getMetadataHelper()

Get the helper used by generated proxy metadata APIs.

Returns:

The HELPER.

dispose

public void dispose()

Delete the proxy.

listRows

public java.util.List<commonj.sdo.DataObject> listRows(commonj.sdo.DataGraph graph,
                                                       java.lang.String table)

List all the rows in the specified table.

Parameters:

graph - The parent data graph.

table - The table name.

Returns:

The row list.

createRow

public commonj.sdo.DataObject createRow(commonj.sdo.DataGraph graph,
                                        java.lang.String table)

Create a row for the specified table.

Parameters:

graph - The parent data graph.

table - The table name.

Returns:

The created row. This is not added to the table - use addRow(commonj.sdo.DataGraph, commonj.sdo.DataObject) to add it.

addRow

public void addRow(commonj.sdo.DataGraph graph,
                   commonj.sdo.DataObject row)

Add the specified row to its table.

Parameters:

graph - The parent data graph.

row - The row to insert.

cancelAllRequests

public void cancelAllRequests()

Cancel all active requests on this client.

invokeWithArgs

public void invokeWithArgs(java.lang.String target,
                           LegacyJavaAppserverParameter... paramArray)

Perform a pseudo-dynamic call where the target procedure doesn't receive the parameter as arguments at the Java method definition, but instead they are managed via LegacyOpenClientCaller APIs.

This allows the target program to act as a controller, where it can prepare the arguments, perform security checks, etc, before dispatching the call to the real target, which can be resolved from the arguments or in some other way.

Parameters:

target - The target external program. Must have no parameters defined.

paramArray - The parameter array.