Error handling

/**
 * An interface to return additional error details when needed.
 */
public interface OneginiErrorDetails {

  /**
   * Returns the {@link CustomInfo} object if the error was caused by custom authenticator.
   * @return instance of {@link CustomInfo} or null
   */
  CustomInfo getCustomInfo();

  /**
   * Returns the {@link UserProfile} object if the profile was deregistered as an effect of the error.
   * @return instance of {@link UserProfile} or null
   */
  UserProfile getUserProfile();

  /**
   * Returns the {@link OneginiAuthenticator} object of the authenticator was deregistered as an effect of the error.
   * @return instance of {@link OneginiAuthenticator} or null
   */
  OneginiAuthenticator getAuthenticator();
}

public class OneginiAuthenticationError implements OneginiError {
  public static final int GENERAL_ERROR = 10000;
  public static final int NETWORK_CONNECTIVITY_PROBLEM = 9000;
  public static final int SERVER_NOT_REACHABLE = 9001;
  public static final int DEVICE_DEREGISTERED = 9002;
  public static final int CONFIGURATION_ERROR = 10001;
  public static final int USER_DEREGISTERED = 9003;
  public static final int OUTDATED_APP = 9004;
  public static final int OUTDATED_OS = 9005;
  public static final int ACTION_CANCELED = 9006;
  public static final int ACTION_ALREADY_IN_PROGRESS = 9007;
  public static final int AUTHENTICATOR_NOT_REGISTERED = 10_007;
  public static final int INVALID_AUTHENTICATOR = 9015;
  public static final int CUSTOM_AUTHENTICATOR_FAILURE = 9027;
  public static final int CUSTOM_AUTHENTICATION_DISABLED = 10_017;
  public static final int AUTHENTICATOR_DEREGISTERED = 9022;
  public static final int DATA_STORAGE_NOT_AVAILABLE = 9024;
  // ...
}

private void registerUser() {
  final OneginiClient oneginiClient = OneginiSDK.getOneginiClient(this);
  oneginiClient.getUserClient().registerUser(null, Constants.DEFAULT_SCOPES, new OneginiRegistrationHandler() {

    @Override
    public void onSuccess(final UserProfile userProfile) {
      PinActivity.setRemainingFailedAttempts(0);
      registeredProfile = userProfile;
      userProfileDebugText.setText(userProfile.getProfileId());
      askForProfileName();
    }

    @Override
    public void onError(final OneginiRegistrationError oneginiRegistrationError) {
      handleRegistrationErrors(oneginiRegistrationError);
    }
  });
}

private void handleRegistrationErrors(final OneginiRegistrationError oneginiRegistrationError) {
  @OneginiRegistrationError.RegistrationErrorType final int errorType = oneginiRegistrationError.getErrorType();
  switch (errorType) {
    case OneginiRegistrationError.DEVICE_DEREGISTERED:
      showToast("The device was deregistered, please try registering again");
      new DeregistrationUtil(this).onDeviceDeregistered();
      break;
    case OneginiRegistrationError.ACTION_CANCELED:
      showToast("Registration was cancelled");
      break;
    case OneginiRegistrationError.NETWORK_CONNECTIVITY_PROBLEM:
    case OneginiRegistrationError.SERVER_NOT_REACHABLE:
      showToast("No internet connection.");
      break;
    case OneginiRegistrationError.OUTDATED_APP:
      showToast("Please update this application in order to use it.");
      break;
    case OneginiRegistrationError.OUTDATED_OS:
      showToast("Please update your Android version to use this application.");
      break;
    case OneginiRegistrationError.GENERAL_ERROR:
    default:
      // General error handling for other, less relevant errors
      handleGeneralError(oneginiRegistrationError);
      break;
  }
}

private void handleGeneralError(final OneginiRegistrationError error) {
  final StringBuilder stringBuilder = new StringBuilder("Error: ");
  stringBuilder.append(error.getMessage());
  stringBuilder.append(" Check logcat for more details.");

  error.printStackTrace();

  showToast(stringBuilder.toString());
}