CORBA.IT_reqTransformer

CORBA.IT_reqTransformer.transform()
CORBA.IT_reqTransformer.transform_error()

Synopsis:

Class IT_reqTransformer provides access to the OrbixWeb request data buffer immediately prior to transmission over the network. This feature is useful for operations in which such access is necessary, for example request encryption.

A transformer class can be implemented by declaring a derived class of IT_reqTransformer and overriding the IT_reqTransformer methods; the method transform() provides access to the request buffer, transform_error() allows an implementation specific error to be returned (or null if no error exists).

If an OrbixWeb client implements a non-null IT_reqTransformer then servers with which that client communicates must implement a matching IT_reqTransformer.

OrbixWeb:

 // Java
 
 package IE.Iona.Orbix2.CORBA;
 
 public class IT_reqTransformer {
 	// Methods
 	public boolean transform(_sequence_Octet data, 
 			String host, boolean is_send);
 	public String transform_error();
 }

Notes:

This is an experimental interface which may change in future releases of OrbixWeb.

CORBA.IT_reqTransformer.transform()

Synopsis:

 public boolean transform(_sequence_Octet data, 
 		String host, boolean is_send);

Description:

Defines the transformation to be carried out on a CORBA.Request. This method is automatically invoked on the registered transformer object immediately prior to transmitting data in a CORBA.Request (and after any filtering) and directly subsequent (before any filtering) to receiving data in a CORBA.Request.

A derived class of CORBA.IT_reqTransformer should override this method to implement a transformation.

An implementation of this method may raise a TRANSFORM_ERR system exception to indicate that an error has occurred during the transformation.

Parameters:

data	The raw data buffer to be transmitted or received.
host	If the request is being transmitted from an address space, then this parameter indicates the host name on which the target application resides. If the request is being received, then this indicates the host of the source application.
is_send	A flag which identifies whether the data is being transmitted from an address space or received into an address space. A `true` value indicates that data is outgoing; a `false` value indicates that the data is incoming.