A toolkit is a collection of artifacts that are organized into a package. Toolkits make SPL or native functions and primitive or composite operators reusable across different applications. A toolkit provides one or more namespaces that contain functions, operators, and types that are packaged as part of the toolkit, all of which can then be reused in other Streams applications.
The Streams platform includes many toolkits, each with useful operators and functions. For example, the operators used to connect to Apache Kafka are in the Kafka toolkit.
However, you can create your own custom toolkit if the included toolkits do not contain the functionality that you need.
For more information, see Developing toolkits.
Building a toolkit
Build a custom toolkit that you can use in your streaming applications.
- Toolkit builds are intended for custom toolkits. Toolkits that are included with the Streams product are pre-built.
- Developing a toolkit in a folder that is included in the Toolkit Paths setting is not recommended. Only indexed toolkits should be specified in the setting (i.e., toolkits where the
toolkit.xmlfile is up-to-date with the contents of the toolkit directory).
Before you begin
You must open or add the folder for the toolkit you wish to build in Visual Studio Code.
Makefile at the root of the toolkit folder is required. It must run the
spl-make-toolkit command, which indexes the toolkit and makes the functions and operators it contains ready for use by SPL programs. A simple
Makefile would look like the following.
all: spl-make-toolkit -i .
Makefile examples, see the toolkits in the Streams GitHub organization.
all: cd com.ibm.streamsx.kafka; ../gradlew build
- Add your Streams 5.5 instance to the Streams Explorer in VS Code if you haven’t already.
- Right-click on a custom toolkit folder (must include a
Makefileat the root of the folder),
toolkit.xmlfile and select Build Toolkit.
- Follow the prompts to submit the build.
Watch and learn: This video demonstrates how to build a toolkit.
After a build completes successfully, the indexed toolkit is extracted to the toolkit folder (overwriting the existing files). You will be presented with two options:
- Download Toolkit: Downloads the toolkit archive file (
.tgz) to the toolkit folder.
- Add Toolkit to Toolkit Path: Adds the toolkit to a toolkit path folder (defined in the Toolkit Paths setting). This makes the indexed toolkit available to use in your Streams applications.