Start Trial

This API creates and enables a trial license using the startTrial() method.

StartTrialRequest request = new StartTrialRequest(true); 

StartTrialResponse response = client.license().startTrial(request, RequestOptions.DEFAULT);

The returned StartTrialResponse returns a field indicating whether the trial 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 trialWasStarted = response.isTrialWasStarted();                        
String licenseType = response.getLicenseType();                                
String errorMessage = response.getErrorMessage();                              
String acknowledgeHeader = response.getAcknowledgeHeader();                    
Map<String, String[]> acknowledgeMessages = response.getAcknowledgeMessages(); 

This request can be executed asynchronously:

client.license().startTrialAsync(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 StartTrialResponse looks like:

ActionListener<StartTrialResponse> listener = new ActionListener<StartTrialResponse>() {
    @Override
    public void onResponse(StartTrialResponse response) {
        
    }

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