Start Basic License

This API creates and enables a basic license using the startBasic() method.

StartBasicRequest request = new StartBasicRequest();

StartBasicResponse response = client.license().startBasic(request, RequestOptions.DEFAULT);

The returned StartBasicResponse returns a field indicating whether the basic was started. If it was started, the response returns a the type of license started. If it was not started, it returns an error message describing why.

Acknowledgement messages may also be returned if this API was called without the acknowledge flag set to true. In this case you need to display the messages to the end user and if they agree, resubmit the request with the acknowledge flag set to true. Please note that the response will still return a 200 return code even if it requires an acknowledgement. So, it is necessary to check the acknowledged flag.

boolean acknowledged = response.isAcknowledged();                              
boolean basicStarted = response.isBasicStarted();                              
String errorMessage = response.getErrorMessage();                              
String acknowledgeMessage = response.getAcknowledgeMessage();                  
Map<String, String[]> acknowledgeMessages = response.getAcknowledgeMessages(); 

This request can be executed asynchronously:

client.license().startBasicAsync(
    request, RequestOptions.DEFAULT, listener); 

The asynchronous method does not block and returns immediately. Once it is completed the ActionListener is called back using the onResponse method if the execution successfully completed or using the onFailure method if it failed.

A typical listener for StartBasicResponse looks like:

ActionListener<StartBasicResponse> listener = new ActionListener<StartBasicResponse>() {
    @Override
    public void onResponse(StartBasicResponse indexResponse) {
        
    }

    @Override
    public void onFailure(Exception e) {
        
    }
};