This page explains how to export a completed Java-based Adapter blade project into a form that's ready to deploy as part of a Caplin Platform system. It'll give you a bit of background about the export process, and step-by-step instructions for exporting blades using the CIS Toolkit.
About exporting projects
Once you've finished developing a platform blade, and you're ready to add it to your Caplin Platform system, you'll have to export it as a kit. This takes all the blade's configuration details and compiled Java code, and packs them into a zip file. Having done so, you would then copy the zip file to the kits directory of the Caplin Deployment Framework, from where it can then be deployed.
Before you can export your blade, it's Java code must be compiled. If you're developing your adapter in an IDE, then your Java source files are compiled automatically. If, on the other hand, you're developing your adapter using the CIS Toolkit, then you'll have to compile it using the CIS Toolkit's
build command before your blade can be successfully exported.
The files from the global_config directory of your blade-project are not included in the kit, as the Deployment Framework has its own global config settings.
Exporting your project using the CIS Toolkit
There are two stages to exporting your project as a kit:
- Compile your project's Java source code using the CIS Toolkit
- Export your project CIS Toolkit
You may skip this step if your development environment compiles your Java code for you.
build command is used whenever you want to run your blade, whether on the development machine or when you are ready to export it for deployment. It compiles any Java files in your blade project into class files. Any errors that occur during the process will be displayed at the command line.
build command is entered in the following format:
java -jar cis-blade-toolkit-[version number]-[build ID].jar build [BladeName]
If you don't provide the blade name along with the
build command, CIS will assume that you are in the root folder of the blade-project to be built, and will attempt to proceed on that basis. If you do enter the name of the blade, you can include a file path to indicate its location. The
build command has only one other argument, which is optional:
By default, the
You can define multiple paths. If you do so, separate them with semi-colons (if you are using Windows) or colons (if you are using Unix), and put quotation marks around the whole string. For example:
Say your CIS kit exists in a directory structure like this:
If you enter the command from the CIS kit's root folder (i.e. CaplinIntegrationSuite-6.0.1-255011368), and the MyNewBlade folder contains a blade project, the following code would compile the MyNewBlade blade project.
java –jar tools/cis-blade-toolkit-6.0.1-255011368.jar build ../platformblades/MyNewBlade/ –cp ../custom_code/lib
The code below would do exactly the same thing, as long as it was entered from the MyNewBlade folder.
java –jar ../../CaplinIntegrationSuite-6.0.1-255011368/tools/cis-blade-toolkit-6.0.1-255011368.jar build –cp ../../custom_code/lib
In both cases, custom jar files will be used instead of the defaults.
export command takes the relevant files from your blade-project, and packs them into a zipped blade kit. Any class files are converted into a jar file before packing them into the kit. The kit can then be slotted into the kits folder of the Caplin Deployment Framework and deployed.
export command is entered in the format shown below. The only information it needs is the name and location of the blade-project. If you don't provide this, the CIS Toolkit will assume that you are in the root folder of the blade-project to be exported, and will try to perform the export on that basis.
java –jar tools/cis-blade-toolkit-6.0.1-255011368.jar export ../platformblades/MyNewBlade
export command has the following arguments, all of which are optional:
The name to be assigned to the blade after it's been exported (if the existing name is unsuitable for some reason).
Note that this option only changes the name of the blade, it doesn't affect the blade's Java class, and therefore doesn't need to conform to Java class naming rules.
If your blade uses jars from any libraries that are outside the CIS, this allows you to provide the file path (or paths) to them.
The path to the blade-project's compiled Java class files.
The default location is the bin directory in the root of the blade-project.
This allows you to specify the location that the blade kit is saved to.
The default location is the current working directory.
||No||Using this argument indicates that the blade-project is to be exported as a config blade.|