Creating a Custom Store

You can use the custom store API to create a custom store according to the requirement of your project.

For more information about the classes, see the com.tibco.cep.store.custom package summary.

To refer to the reference implementations of Redis as a persistent store by using the custom store API's, see reference implementations on GitHub.

Procedure

1. Create an XML file and save it with the name as store.xml.

2. Configure the store.xml file for the custom store and add the properties that you want to display in TIBCO BusinessEvents Studio as follows:

   1. Provide the connection-related properties in the Connection property group.
   2. Inside the Security tag, provide the connection-related properties in the Connection-Security property group.
   3. Inside the class tag, provide the class name implementation of the BaseStoreProvider class.
   4. Inside the schema-generation tag, provide class name of implementation of the StoreDeployment class.

   For more information, see Structure of the store.xml File.

3. Create all the required Java class files by using the Java API for custom store.

4. Archive all the Java class files for the custom store along with the store.xml file as a JAR file. Place the store.xml file at the base of the JAR file.

   Ensure that the JAR is an "Uber JAR" which includes all the dependencies. For more details, see the reference implementations on GitHub.

5. Save this JAR file to BE_HOME/lib/ext/tpcl/contrib.
6. Restart TIBCO BusinessEvents Studio.
7. (Optional) If your custom store implementation has any external dependencies, add their respective JAR files to the BE_HOME/lib/ext/tpcl folder or add their classpaths to the be-engine.tra file at BE_HOME/bin
   Ensure that you do not add the dependencies that are already present in the BE_HOME/lib folder or your "Uber JAR" that you have created for the custom store.