com.borland.vbroker.NativeMessaging
Interface RequestAgentExOperations

All Superinterfaces:

RequestAgentOperations

All Known Subinterfaces:

RequestAgentEx

public interface RequestAgentExOperations
extends RequestAgentOperations

Extends the functionality of RequestAgent interface. Provides greater flexibility when writing Native Messaging applications. For example, the application can create a RequestProxy, which can be used to invoke multiple requests to the same target. In the older model, each request had to be created explicitly for each method on the same target. After completion of once request, the request object was not usable. Other advantages come with the help of Current objects. For example, synchronous-like invocations can be made by setting the wait timeout on the Current object. These invocations can evolve into asynchronous requests if reply is not available after the timeout.

Since:

6.0

Method Summary

RequestProxy	create_request_proxy(Object target, java.lang.String repository_id, ReplyRecipient reply_recipient, NameValuePair[] properties) Creates a request proxy for the specified target.
NameValuePair[]	properties() Returns the default property set for the Request Agent.

Methods inherited from interface com.borland.vbroker.NativeMessaging.RequestAgentOperations

create_request, destroy_request, poll

Method Detail

create_request_proxy

RequestProxy create_request_proxy(Object target,
                                  java.lang.String repository_id,
                                  ReplyRecipient reply_recipient,
                                  NameValuePair[] properties)
                                  throws InvalidProperty

Creates a request proxy for the specified target. Using the request proxy, the client can obtain a type proxy object (see RequestProxy interface) which then can be used for multiple invocations to the same target object.

Parameters:

target - Reference of the target object, on which client wish to invoke an operation. CORBA::BAD_PARAM exception will result if a null value is passed.

repository_id - Repository id of the target object. If this is an empty string, Request Agent will try to extract the rep id from the target object reference. If rep id is empty here and also null or empty in the target IOR reference, a CORBA::BAD_PARAM exception is thrown. Clients can also use a repository id of "*". This acts as a wild card and is_a operation on the request object returns true for any repository id.

reply_recipient - The reference of the reply recipient (or reply handler) when using callback model. If this reference is not null then the Request Agent will call its reply_available method when a reply is ready.

properties - Sequence of CORBA::NameValuePair. Note: Starting from VBE 6.0, the properties field is defined as CORBA::NameValuePair. Applications using Native Messaging from VBE 5.1/5.2.x are wire interoperable with VBE 6.0 Request Agent (and vice versa). However, code changes are required if an older Native Messaging application is to be compiled with VBE 6.0..

Returns:

reference to the RequestProxy object.

Throws:

InvalidProperty

See Also:

Property, RequestProxy

properties

NameValuePair[] properties()

Returns the default property set for the Request Agent.

Returns:

Sequence of CORBA::NameValuePair