Solution gateway API

The solution gateway API is the mechanism through which inbound events are submitted to the Decision Server Insights runtime environment. The solution gateway is not used for delivering outbound event messages. You can access the solution gateway either directly through a Java™ API, or indirectly by modeling and deploying inbound connectivity as part of your solution. Each solution gateway instance represents a single, specified solution that is connected to the object grid.

The solution gateway establishes a connection between a solution and an object grid. Connections can be established between multiple solutions and a single object grid. A gateway instance is used to submit events for processing, which involves placing them on an event queue.

The solution gateway API is thread-safe, which means that you can use a gateway instance to create events and submit events from multiple threads. When you have a gateway instance, you can call the EventFactory to create, parse, and serialize events.

Important: Do not make calls to the solution gateway from Java agents or OSGi services that are on a runtime server. Instead, use the agent APIs to route events or route external events through inbound connectivity.

You can use the solution gateway API to manage solutions and do the following tasks:

  • Retrieve solution information, such as the current solution name and version of the solution, by using the SolutionGateway API and the getSolutionName, getSolutionVersion and getVersion classes.
  • Use the GridConnection API to retrieve information about the grid configuration and the solutions that are connected to the grid.
Tip:

If you want to make SSL connections from code that is run in the same JVM as the gateway, you must set the JVM property com.ibm.xs.xio.transport.disableSSL to true.