An object containing the information necessary for
invoking a method. This class is
the cornerstone of the ORB Dynamic
Invocation Interface (DII), which allows dynamic creation and
invocation of requests.
A server cannot tell the difference between a client
invocation using a client stub and a request using the DII.
A Request
object consists of:
- the name of the operation to be invoked
- an
NVList
containing arguments for the operation.
Each item in the list is a NamedValue
object, which has three
parts:
- the name of the argument
- the value of the argument (as an
Any
object)
- the argument mode flag indicating whether the argument is
for input, output, or both
Request
objects may also contain additional information,
depending on how an operation was defined in the original IDL
interface definition. For example, where appropriate, they may contain
a NamedValue
object to hold the return value or exception,
a context, a list of possible exceptions, and a list of
context strings that need to be resolved.
New Request
objects are created using one of the
create_request
methods in the Object
class.
In other words, a create_request
method is performed on the
object which is to be invoked.