IIOP Connect (IluProxy) Interfaces

How to use this interface Step-by-Step.

ORBProxy, NVList, Request, Any

Interface ORPProxy Top

Request create_request(in IluObject object, in string operation, in NVList arg_list)

creates a dynamic invocation request initialized with the specified parameters.

Request get_next_response()

this blocking method waits until a response to a deferred operation request in available. the completed Request is returned.

boolean poll_next_response()

returns true if a response to a deferred operation request is available. Otherwise, false is returned.

NVList create_list(in IluObject object, in short num)

creates a list of NVList with the specified number of elements and returns a reference to the list.

void send_multiple_requests_deferred(in RequestSeq reqs)

this non-blocking method sends a number of operation requests. Return values may then be obtained using the poll_next_response and get_next_response method.

oneway void send_multiple_requests_oneway(in RequestSeq reqs)

sends a number of oneway operation requests. Return values are not provided for oneway requests.

IluObject bind(in string object_name)

for binding with dlcoslib Naming Service

Request create_request_with_args(in IluObject object, in string operation, in AnySeq args)

faster creation of the request object.

Any invoke_with_result(in Request method)

convenient method invocation

Any invoke_with_all(in IluObject object, in string operation, in AnySeq args)

faster method invocation

void delete(in Request req)

remove request object

Request request(in IluObject object, in string operation) raises(IluProxyException)

creates an empty dynamic invocation request.

---

Interface NVList Top

void add()

adds a NamedValue item to this list without initializing the name or the value associated with the item.

void add_item(in string name)

adds a NamedValue item to this list without initializing the value associated with the item.

void add_value(in string name, in Any value)

adds a NamedValue item to this NVList that has the specified name, value.

short count()

returns the number of NamedValue items in this NVList.

NamedValue item(in short index)

returns the NamedValue item from this list that has the specified index. If the index is out of range, a IluProxy.BadParam exception is raised.

void remove(in short index)

removes the NamedValue with the specified index from this list. If the index is out of range, a IluProxy.BadParam is raised.

---

Interface Request Top

void add_arg(in string name, in Any value)

add argument value to the associated NVList.

NVList arguments()

returns the list of arguments for this operation request. These arguments must be initialized prior to sending the operation request.

string ctx()

returns the context string associated with this operation.

void get_response()

this blocking method waits for the results of a dynamic invocation request that was sent with the send_diferred method. the non-blocking poll_response method can be used to determine if a response is available prior to invoking this method.

void invoke()

sends the operation request and blocks waiting for a response. If the client does not wish to block waiting for a response, the send_diferred method may be used instead.

string operation()

returns the name of the operation, or method name, associated with this request.

boolean poll_response()

returns true if a response for an operation is currently available. Otherwise, false is returned. This method is used after the send_deferred method has been invoked and prior to invoking the get_response method, which actually reads in the result values.

Any result()

returns the results, or return value, of the operation request. If the type of the result is not specified, the type defaults to void. If tye return type is not void, the type must be initialized prior to sending the operation method.

void send_deferred()

sends this operation request, but does not block awaiting a response. The poll_response and get_response methods are then used to determine when a response is available and to receive the results.

oneway void send_oneway()

this non-blocking method sends this operation request as a oneway request. Oneway request do not result in a response from the server to which they are sent.

IluObject target()

returns the target Object to which this operation request will be sent. The target Object is specified when the Request is created.

string object_to_string(IluObject)

returns the IOR representation of the IluObject. Note that IluObject is consist of two attributes; SBH and Type String.

void delete()

deletes Request object and the NVList associated with this object from the server.

---

Interface Any Top

Constructors

Any()

Any(int v)

Any(short v)

Any(boolean v)

Any(float v)

Any(char v)

Any(String v)

Any(IluProxy.IluObject v)

Any(byte v)

Any(byte[] v)

Any(double v)

'to' converters

boolean to_boolean()

char to_char()

double to_double()

float to_float()

int to_long()

IluProxy.IluObject to_Object()

byte to_octet()

byte[] to_Principal()

short to_short()

String to_string()

String to_struct()

'from' converters

Any from_boolean(boolean v)

Any from_char(char v)

Any from_double(double v)

Any from_float(float v)

Any from_long(int v)

Any from_Object(IluProxy.IluObject v)

Any from_octet(byte v)

Any from_Principal(byte[] v)

Any from_short(short v)

Any from_string(String v)

Any from_struct(String v)