Object_To_String

Description

Gets the string form of an object.

This function is used by PowerBuilder clients connecting to EAServer.

Applies to

JaguarORB objects

Syntax

jaguarorb.Object_To_String ( object )

Argument

Description

jaguarorb

An instance of JaguarORB.

object

The CORBA object that will be converted to a string.

The string representation of a CORBA object is an Interoperable Object Reference (IOR) that describes how to connect to the server hosting the object. EAServer supports both standard format IORs (which are hex-encoded) and a URL format that is human-readable.

Returns

String. Returns the string representation of a CORBA object.

Usage

The Object_To_String function can be used to serialize a proxy object reference. By serializing an object reference, you can save the state of the object so that it persists after the client terminates processing.

Object_To_String is typically used in conjunction with String_To_Object, which allows you to deserialize an object reference.

Examples

Example 1

The following example shows the use of the Object_To_String function to serialize a proxy object reference:

Payroll payroll

JaguarORB my_orb

...

my_orb = CREATE JaguarORB

my_orb.init("ORBRetryCount=3,ORBRetryDelay=1000")

...

String payroll_ior = my_orb.Object_To_String(payroll)

See also