BBjAPI::cloneAsClientObject

Description

In BBj 8.0 and higher, this method creates a clone of a server-side object on the client and returns a ClientObject that is an RMI handle to that client-side Object.

Syntax

Return Value	Method
ClientObject	cloneAsClientObject(ObjectserverObj)

Parameters

Variable	Description
serverObj	A server-side Object.

Return Value

A ClientObject that is an RMI handle to a client-side Object which is a clone of serverObj.

Remarks

The ServerObj must be a serializable Object. ServerObj is serialized through an ObjectOutputStream and the resulting bytes are transported to the client where they are used to create an ObjectInputStream on the client. A new Object is read from the ObjectInputStream. Finally a ClientObject is created on the server that is an RMI handle for this newly created client-side Object. This ClientObject is the return value of the method

An error is thrown if the serverObj is not serializable.