replicant-packages_apps_Email/src/com/android/email/mail/MessagingException.java

86 lines
3.0 KiB
Java

/*
* Copyright (C) 2008 The Android Open Source Project
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package com.android.email.mail;
/**
* This exception is used for most types of failures that occur during server interactions.
*
* Data passed through this exception should be considered non-localized. Any strings should
* either be internal-only (for debugging) or server-generated.
*
* TO DO: Does it make sense to further collapse AuthenticationFailedException and
* CertificateValidationException and any others into this?
*/
public class MessagingException extends Exception {
public static final long serialVersionUID = -1;
public static final int NO_ERROR = -1;
/** Any exception that does not specify a specific issue */
public static final int UNSPECIFIED_EXCEPTION = 0;
/** Connection or IO errors */
public static final int IOERROR = 1;
/** The configuration requested TLS but the server did not support it. */
public static final int TLS_REQUIRED = 2;
/** Authentication is required but the server did not support it. */
public static final int AUTH_REQUIRED = 3;
/** General security failures */
public static final int GENERAL_SECURITY = 4;
/** Authentication failed */
public static final int AUTHENTICATION_FAILED = 5;
/** Attempt to create duplicate account */
public static final int DUPLICATE_ACCOUNT = 6;
protected int mExceptionType;
public MessagingException(String message) {
super(message);
mExceptionType = UNSPECIFIED_EXCEPTION;
}
public MessagingException(String message, Throwable throwable) {
super(message, throwable);
mExceptionType = UNSPECIFIED_EXCEPTION;
}
/**
* Constructs a MessagingException with an exceptionType and a null message.
* @param exceptionType The exception type to set for this exception.
*/
public MessagingException(int exceptionType) {
super();
mExceptionType = exceptionType;
}
/**
* Constructs a MessagingException with an exceptionType and a message.
* @param exceptionType The exception type to set for this exception.
*/
public MessagingException(int exceptionType, String message) {
super(message);
mExceptionType = exceptionType;
}
/**
* Return the exception type. Will be OTHER_EXCEPTION if not explicitly set.
*
* @return Returns the exception type.
*/
public int getExceptionType() {
return mExceptionType;
}
}