TIBCO BE CICD Sample Using Maven, jUnit, and Jacoco

• Illustrate Maven build of application containing multiple Java and TIBCO BusinessEvents (BE) projects;
• Illustrate jUnit tests of BE projects using API-mode of BE engines;
• Illustrate jUnit tests of BE projects by wrapping tests implemented in BE rule-functions;
• Illustrate generation of Jacoco code-coverage reports for BE test suite;
• Illustrate collecting and visualizing BE application performance stats using time-series database, i.e., InfluxDB.

Prerequisites

• Install TIBCO BusinessEvents 5.4.1, and set env for BE_HOME, e.g., export BE_HOME=/usr/local/tibco/be/5.4 on Mac, or set BE_HOME=C:/tibco/be/5.4 on Windows. Note that you need to use forward slash on Windows, too.
• Verify that curl is in the PATH, e.g., curl --version (download and install curl if it not already available)

Note: This sample is tested on Mac and Windows, and *nix should work the same as on Mac, except that the be-engine.tra file used to start BE-engine is a little different from the version for Mac.

Install TIBCO BusinessEvents jars into local Maven repository

The Java utilities in this sample uses 3 jars from the TIBCO BusinesEvents library.

• $BE_HOME/lib/cep-common.jar
• $BE_HOME/lib/cep-kernel.jar
• $BE_HOME/lib/be-functions.jar

They are not available in Maven Central, and so you need to install them into your local Maven repository using the following commands:

mvn install:install-file -Dfile=$BE_HOME/lib/cep-common.jar -DgroupId=com.tibco.be \
-DartifactId=cep-common -Dversion=5.4.1 -Dpackaging=jar
mvn install:install-file -Dfile=$BE_HOME/lib/cep-kernel.jar -DgroupId=com.tibco.be \
-DartifactId=cep-kernel -Dversion=5.4.1 -Dpackaging=jar
mvn install:install-file -Dfile=$BE_HOME/lib/be-functions.jar -DgroupId=com.tibco.be \
-DartifactId=be-functions -Dversion=5.4.1 -Dpackaging=jar

Build the sample

After you clone this project be_sample to, e.g., $workspace/be_sample, you can build all components of this sample from the project root

cd $workspace/be_sample
mvn clean install

This will build all components and execute unit tests of the following 5 components:

• BEAssert: Java implementation of BE catalog functions for Hamcrest matcher functions;
• BEStats: Java implementation of BE catalog functions for collecting performance stats and storing stats in a time-series database, i.e., InfluxDB;
• BETestClient: Java helper functions for wrapping and executing BE unit tests as Java jUnit tests;
• BETestLib: BE projlib designed to provide an HTTP service for processing jUnit test requests; This sample demonstrates the approach of implementing BE unit tests inside the BE project, and driving the tests using a jUnit wrapper; It also demonstrates the use of Maven to build BE projlibs;
• SimpleHTTP: BE sample to demonstrate the approach of implementing BE unit tests in Java, and executing jUnit tests using API-mode of BE engines.

Besides, Jacoco code-coverage report is also generated for BETestLib, which is in $workspace/be_sample/BETestLib/target/jacoco/reports/BETestLib/index.html.

The author

Yueming is a Sr. Architect working at TIBCO Architecture Service Group.