Copyright © Cloud Software Group, Inc. All Rights Reserved

Overview

TIBCO API Exchange Gateway provides the following examples:

−	GetLocation

−

BookQuery

−

Caching

Prerequisites

Complete the following tasks before running the examples:

Install TIBCO API Exchange Gateway

Install the TIBCO API Exchange Gateway software and finish the post installation tasks, as described in TIBCO API Exchange Gateway Installation Guide.

Verify the TIBCO API Exchange Gateway Server Status

Verify the installation and health of the TIBCO API Exchange Gateway server by following the steps listed in "Checking TIBCO API Exchange Gateway server status" section of TIBCO API Exchange Gateway Installation Guide.

Install TIBCO Runtime Agent and TIBCO BusinessWorks

The examples require the installation of TIBCO Runtime Agent and TIBCO BusinessWorks products. Refer to the TIBCO API Exchange Gateway readme file at TIBCO_HOME/release_notes directory for the supported version of TIBCO Runtime Agent and TIBCO BusinessWorks products.

Examples

TIBCO API Exchange Gateway software ships the following examples:

GetLocation

GetLocation example is shipped with a GetLocation BusinessWorks project. The project contains the client operations and back-end services, such as GetLocationService to be executed. The GetLocation service demonstrates the routing capability of TIBCO API Exchange Gateway.

The gateway interacts with a mock-up back-end service which returns the coordinates of a device associated with a phone number. The gateway routes the request to a different back-end service depending on the input phone number in the request.

Refer to ASG_HOME/examples/GetLocation/readme.html file for instructions on how to run the example.

BookQuery

The BookQuery service queries all the books in a book store using different criteria such as author, ISBN, publisher, and title. TIBCO API Exchange Gateway example project implements the following policies:

•	Rate Throttles

•	Quota Throttles

•	High Water Mark Throttles

•	Error Throttles

Refer to ASG_HOME/examples/BookQuery/readme.html file for instructions on how to run the example.

Caching

The Caching example demonstrates the caching functionality provided by TIBCO API Exchange Gateway.

It has the following main components:

•

ASG_CBA is a TIBCO BusinessWorks project that simulates an east side service. The service takes the firstIdentity field as a cross-reference key and translates its value. This project does a simple translation on the key using an XML file. Alternatively, the service can be an adapter call, a lookup in a database, or any other web service.

•	A SOAP service, which is hosted on TIBCO API Exchange Gateway. This service type is NOOP which means that it returns a XML document with a received key and a translated value.

After the translated value is received from the service implemented in the ASG_CBA BusinessWorks project, this is plugged into a SOAP payload. This payload is used to call a SOAP service running on TIBCO API Exchange Gateway.

When the CustomStage feature is applied to an operation configuration, it enables a set of rules in the ASG_DefaultImplementation project. When the operation request is invoked, it looks into the cache for a cross-reference before the routing step. It uses the value of firstIdentity as a key for the cross-reference. If a value for that key is present in the cache, it is used in the cross- reference. If a value is not found, it sends a TIBCO Rendezvous message to retrieve that value from the service in the ASG_CBA BusinessWorks project.

Refer to ASG_HOME/examples/Caching/readme.html file for instructions on how to run the example.

Copyright © Cloud Software Group, Inc. All Rights Reserved