Waiting for engine...
Skip to main content

Implement GatewayManager

GatewayManager is the entry point the agent uses to load your plugin at runtime. It connects all your Handler and HandlerFactory implementations so the agent can discover and call them correctly.

Prerequisites

Implement GatewayManager

  1. Create a class that implements GatewayManager.

  2. For every Handler you implemented, override the corresponding getXFactory method to return a new instance of your HandlerFactory. For example, if you implemented ApiDiscoveryHandler and ApiDiscoveryHandlerFactory, override getApiDiscoveryHandlerFactory to return new YourApiDiscoveryHandlerFactory().

  3. For any Handler you did not implement, you do not need to override the corresponding factory method.

Create the META-INF/services resource file

The agent uses Java's service loader mechanism to find your GatewayManager implementation. You must create the service descriptor file manually.

  1. In your project's resources directory, create the path META-INF/services/.

  2. Inside that directory, create a file named exactly:

    com.boomi.controlplane.agent.api.GatewayManager
  3. Write the fully qualified class name of your GatewayManager implementation as the only line in the file. For example:

    com.boomi.controlplane.agent.example.ExampleGatewayManager
  4. Verify that the META-INF/services directory is included when you build your JAR file. If it is missing, the agent will not load your plugin.

On this Page