|
VisiBroker for Java |
||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public interface RequestAgentExOperations
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.
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 |
---|
RequestProxy create_request_proxy(Object target, java.lang.String repository_id, ReplyRecipient reply_recipient, NameValuePair[] properties) throws InvalidProperty
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..
RequestProxy
object.
InvalidProperty
Property, RequestProxy
NameValuePair[] properties()
CORBA::NameValuePair
|
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |