Handcrafted Clients › Coding the Invocation

Coding the Invocation

The following code would be used to invoke the .NET server:

... 
<method-name>Import importView = new <method-name>Import();
<method-name> server = new <method-name>();
... 
<define the importView properties as desired>
... 
// In its simplest form:
 <method-name>Export exportView = server.Execute(importView, null, null);
 
// In its complete form:
 <method-name>Export exportView = server.Execute(importView, securityObject, userObject);
... 
<retrieve exportView data>
...

The securityObject and userObject are optional; if not specified, null must be specified in the method call.

The securityObject is a serializable object that is passed unmodified to the SecurityValidationExit, which allows customers to validate the client's security credentials. The securityObject allows customers to pass any arbitrary security-related information from the caller to the target .NET server to be evaluated by the exit.

The userObject is a serializable object that is passed unmodified to the exit UserExit. The userObject allows customers to pass any arbitrary data from the caller to the target .NET server to be evaluated by the exit.

Each exit may report an error by throwing an exception, which will be returned to the client without executing the server.