Adapter Services


The interceptor component of the adapter provides the following:

The service component of the adapter provides the following:

Interceptor

TIBCO Adapter for COM allows you to use COM interfaces to send messages over a TIBCO messaging transport. You do not need to write complex code to manage a messaging session or to marshal your data into messages. Instead, you can develop a COM interface and then use TIBCO Designer to set certain configuration parameters for the interceptor. The client application then instantiates the COM object through a TIBCO moniker, obtaining an interface pointer, and invokes methods on this interface pointer. The use of the TIBCO moniker to activate the coclass causes the interface pointer returned to your client to be an interceptor proxy.

For more information on the TIBCO moniker and interceptor proxies, see TIBCO Moniker and Interceptor Activation.

This proxy intercepts all method invocations made by the client, marshals the input parameters into a TIBCO ActiveEnterprise message (operation request or document), and places the message on the TIBCO messaging transport. To know how to perform the marshalling, the proxy utilizes the type library of the coclass and the configuration information you entered in the repository.

The operation of the interceptor proxy is completely transparent to the client. As far as the client knows, it is merely making method calls on an arbitrary COM interface. In reality, these method calls are being intercepted and converted automatically into TIBCO ActiveEnterprise messages.

For example, you may configure TIBCO Adapter for COM so that it converts all calls to the method INews::Politics into documents to be published on the subject NEWS.LOCAL.POLITICS. Once you have mapped INews::Politics to a particular subject and defined other configuration preferences, you make calls to the INews::Politics method. These calls are intercepted and the call parameters are automatically marshaled into a document and published on the specified subject by the Interceptor component.

Service

TIBCO Adapter for COM also allows your COM components to be driven by messages flowing off a TIBCO messaging transport. Again, you do not need to write complex code to manage a messaging session or to unmarshal parameters from messages. You can use TIBCO Designer to map messages on a particular subject to a particular COM method. When you start the service component of TIBCO Adapter for COM, it starts listening for messages on the configured subject. When a message arrives, the service automatically unmarshals it and converts it into an invocation of the appropriate COM method call. When the call returns, if a two-way operation request was received, the service marshals the output parameters and the HRESULT from the stack into an operation reply and returns this reply to the client.

The following figure illustrates the interceptor and service.

Figure 1 Interaction between the Interceptor and Service Component

Publication Service

The interceptor component of the adapter intercepts a method call from a COM client, converts it into a message, and sends the message to the TIBCO environment.

Figure 2 Typical Publication Service Flow

Request Response Invocation Service

The interceptor component of the adapter gets a request from a COM client and sends the request through the TIBCO environment. When a response is returned from the TIBCO environment, the adapter sends the response back to the COM client.

Figure 3 Typical Request Response Invocation Service Flow

Subscription Service

The service component of the adapter gets a message from the TIBCO environment and invokes the COM method on the COM server.

Figure 4 Typical Subscription Service Flow

Request Response Service

The service component of the adapter gets a request from the TIBCO environment and sends the request to a COM server. When a response is returned to the adapter from the COM server, the adapter sends the response to the TIBCO environment.

Figure 5 Typical Request Response Service Flow

The adapter supports request response scenarios with an RPC server. When the adapter receives a request, it takes the raw requested data, converts it into a formatted schema, and sends it to COM server by using a designated COM interface.


TIBCO Adapter™ for COM User’s Guide
Software Release 5.3, September 2005
Copyright © TIBCO Software Inc. All rights reserved
www.tibco.com