TIBCO FTL Adapter Sample

Contents

Running This Sample in StreamBase Studio
Importing This Sample into StreamBase Studio
Sample Location

This sample demonstrates the use of the TIBCO StreamBase® Adapters for TIBCO FTL®.

Note

Before running this sample, be sure to configure the TIBCO FTL tibftl.jar file and make the FTL middleware libraries available to the system, as described in TIBCO Middleware Dependencies in the TIBCO FTL Subscribing Input Adapter or TIBCO FTL Publishing Output Adapter pages of the Adapters Guide.

Running This Sample in StreamBase Studio

When running this sample in StreamBase Studio, use the launch file under the project folder to start the Subscribe and Publish adapter instances. When running this sample outside of StreamBase Studio on Windows, first run the Setup_Env.bat script in the sample's folder before running the sample.

  1. Start the TIBCO FTL realm server. The sample assumes it is running on localhost, port 8080.

  2. In the Package Explorer, double-click tibco-ftl.sbapp.

  3. Select the Subscribe adapter icon to open the Properties view for the adapter.

  4. Adjust the Realm Server URL, Application Name, and Endpoint Name properties to match the realm server configuration.

  5. Repeat the previous step for the Publisher adapter.

  6. Click the Run button. This opens the SB Test/Debug perspective and starts the application.

  7. In the Test/Debug Perspective, open the Application Output view. If the adapter is able to connect to the realm server, two Connected status tuples appear, one from each TIBCO FTL adapter instance.

  8. In the Manual Input view, select the PublishIn stream and click Send Data. Additional tuples appear in the Application Output view from the SubscribeOut and SubscribeStatus streams indicating the following:

    • The message published by the FTL output adapter was received by the FTL input adapter.

    • The received message was acknowledged (assuming the subscribe adapter's Explict ACK property remains enabled).

  9. When done, press F9 or click the Stop Running Application button.

Importing This Sample into StreamBase Studio

In StreamBase Studio, import this sample with the following steps:

  • From the top menu, click File → Load StreamBase Sample.

  • Select this sample from the Embedded Input Adapters list.

  • Click OK.

StreamBase Studio creates a project for this sample.

Sample Location

When you load the sample into StreamBase Studio, Studio copies the sample project's files to your Studio workspace, which is normally part of your home directory, with full access rights.

Important

Load this sample in StreamBase Studio, and thereafter use the Studio workspace copy of the sample to run and test it, even when running from the command prompt.

Using the workspace copy of the sample avoids the permission problems that can occur when trying to work with the initially installed location of the sample. The default workspace location for this sample is: 

studio-workspace/sample_adapter_embedded_tibco-ftl

See Default Installation Directories for the location of studio-workspace on your system.

In the default TIBCO StreamBase installation, this sample's files are initially installed in: 

streambase-install-dir/sample/adapter/embedded/tibco-ftl

See Default Installation Directories for the location of streambase-install-dir on your system. This location may require administrator privileges for write access, depending on your platform.