Back to Kinetic Platform Integrations
Bridge Adapter · Version 1.0.0

Kineticcore System Kinetic Platform

GitHub

Kinetic Core Bridgehub Adapter

A Kinetic Bridgehub adapter for the Kinetic Request: Core Edition platform

Kinetic Core Bridgehub Adapter Information


Configuration Values

Name Description
Username The username that will be used to access the Kinetic Core information
Password The password that is associated with the username
Kinetic Core Space Url The url of the Kinetic Core instance up to and including the space that up want to be retrieving the data from

Example Configuration

Name Value
Username user@acme.com
Password secret-password
Kinetic Core Space Url https://localhost:8080/kinetic/space-slug

Changelog

1.0.0

  • Initial Version

General Bridgehub Information


What is a Bridgehub adapter?

A Bridgehub adapter is an extension to be used with the Kinetic Bridgehub project. Each adapter allows Kinetic Bridgehub to retrieve data from the data source specified by the adapter.


Bridgehub adapter basics

Properties

Bridgehub properties are a set of parameters specific to each Bridgehub adapter. These parameters are normally configuration values for properties like username, password, server location, etc.

Initialize

A one time initialization method for the Bridgehub adapter that is required to successfully complete before any of the implementation methods (count,retrieve,search) can be executed. This allows an adapter author to pre-load operations to improve the speed of the implementation methods, validate the adapter properties, and set variables that can be used by other methods.

Count

An implementation method that returns the amount of records for a given Structure and Query.

Retrieve

An implementation method that returns a single record containing the specified Fields for a given Structure and Query. If there is more than one record that matches the Structure/Query combination, an error is thrown.

Search

An implementation method that returns multiple records containing the specified Fields for a given Structure and Query. A search request can also optionally specify metadata (order,pagination,query parameters) to further refine the search results.

Using Parameters

To allow for the use of query parameters when calling the implementation methods, make sure that the adapter substitutes the query parameters before making its call. The following is an example of this being done using the Kinetic Core Adapter:

KineticCoreQualificationParser parser = new KineticCoreQualificationParser(); String substitutedQuery = parser.parse(request.getQuery(),request.getParameters());

Want more detail?

If you want more detail about how a Bridgehub adapter is structured and the various classes available to it, look at the Kinetic Bridgehub Adapter javadoc.


How is the adapter tested?

Kinetic Bridgehub adapters are tested using JUnit tests. To import a set of standard JUnit tests that all bridge adapters need to be able to pass, extend the JUnit class for an adapter with the BridgeAdapterTestBase class. To go along with the BridgeAdapterTestBase, a bridge-config.yml file needs to be included with the test resources at /src/test/resource/bridge-config.yml. An empty file with instructions on how to fill it out should be included in the repository by default.


How is the adapter built?

Kinetic Bridgehub adapters are built as Maven projects. To build the project from the command line, run the command mvn package from inside the adapter directory.

NOTE: Before building the adapter you will need to make sure that the kinetic-bridgehub-adapter JAR has been added to the Maven project. Currently the kinetic-bridgehub-adapter is only available as a 3rd party JAR file (included in this repository), so it will need to be manually installed before the project will successfully build. Information on installing 3rd party JARs to Maven can be found here.


Adding the adapter to Bridgehub

Discovery file

Kinetic Bridgehub find and loads new adapters by looking for and loading up a file containing the main class of the Bridgehub Adapter. The name of the file is com.kineticdata.bridgehub.adapter.BridgeAdapter and it is located at /src/resources/META-INF/adapters/com.kineticdata.bridgehub.adapter.BridgeAdapter. The only thing that file should contain is the location of the main java adapter class. The following example shows the contents of the file for the Kinetic Core Adapter:

com.kineticdata.bridgehub.adapter.kineticcore.KineticCoreAdapter

Adding the JAR to Kinetic Bridgehub

Once it has been built, the adapter JAR goes into the WEB-INF\lib of the Kinetic Bridgehub installation. After restarting the server containing Kinetic Bridgehub, the newly installed adapter should now show up in the adapter list.

GitHub

On This Page

Looking for a workflow engine? Learn more about the Kinetic Data Enterprise Workflow Platform. Check it out
Return to Top