Description

The Amadis Configuration Module provides an integrator with easy access to Nexo TMS related functionalities.

Goal and usage

This module’s main functionality is to retrieve a configuration from a compatible Nexo TMS host, and translate into Arkos Framework’s configuration format. In Java land, this configuration is represented as a generic byte array (byte[]) containing the entire configuration structure as TLV fields.

This configuration then becomes the integrator’s application responsibility. The Arkos Framework functionalities generally requires this configuration to be provided - however, other uses (including persistance) are left to the integrator.

How to?

Initialise a connection provider

...

// Provide an input stream to the Certificate Authorities allowed on this provider
InputStream nexoCAFile = { ... };

// Initiate an instance of an Object implementing the TMSConnectionProvider interface
// We are using the Amadis provider here for ease of use
AmadisUnifiedConnectionProvider connectionProvider = AmadisUnifiedConnectionProvider.DefaultNexoProvider(nexoCAFile);

Force a configuration attempt on a specific host

This should be used for the first configuration retrieval, or to force a specific host different from what was specified in the configuration

...

// Load or initialise an empty configuration - see the [Minimal Configuration Required] section for more information
byte[] configuration = { ... };

ConfigurationResult result = AmadisTMSModule.DoConfiguration(connectionProvider, configuration, "hostname:port");

// Inspect and use the result Object
if (result.isSuccess()) {
    Log.d("config", "Configuration attempt was successful");
    
    // Configuration attempt was successful - this is the new valid configuration and should replace the old one.
    configuration = result.getConfiguration();

    // It is important to always keep the Connection Provider up to date with the current configuration
    connectionProvider.setConfiguration(configuration);
}
else {
    // The textual reason for a failure is provided
    Log.d("config", "Configuration attempt failed: " + result.getError());
}

Execute a configuration attempt, using the system-configured TMS host

This should be used for any subsequent manually triggered configuration retrieval. It uses the configuration content’s host system to identify the active TMS host, then proceeds to retrieve the configuration if required.

...