Java API Bindings

The Java API bindings can be used to develop Java client applications on a development server or directly on the Gateway Proxy. The location is at the discretion of MATRIXX customers. This procedure outlines how to generate the bindings on a remote development server. If the Java client will be developed directly on the Gateway Proxy, you do not need to copy the /opt/mtx/bin/JavaApiGenerator.jar file to a remote server, nor add the remote server to the Firewall allow list. To retrieve any custom (private) MDC definitions from the database, MATRIXX Engine must be running and the JavaApiGenerator.jar program must be configured to access the engine.

In addition to the code-generated Java classes, the JavaApiGenerator.jar program generates XSD files that can be used by third-party applications to validate their XML.

Note: Get methods on code-generated wrapper classes return named wrapper class types. For example, a field that holds MtxDiamRoObject returns an MtxDiamRoObject class. Previously, get methods were declared as type Object and the code using the get method had to test that the object returned was an MtxDiamRoObject and if so, the object had to be cast into an MtxDiamRoObject. Testing and casting the returned object is not required.