javax.mail: public class: MessagingException

javax.mail
public class: MessagingException [javadoc | source]

java.lang.Object
   java.lang.Throwable
      java.lang.Exception
         javax.mail.MessagingException

All Implemented Interfaces:
Serializable

Direct Known Subclasses:
StoreClosedException, ParseException, MessageRemovedException, NoSuchProviderException, SendFailedException, IllegalWriteException, AuthenticationFailedException, ReadOnlyFolderException, FolderClosedException, AddressException, MethodNotSupportedException, FolderNotFoundException, SearchException

The base class for all exceptions thrown by the Messaging classes

author: John - Mani

author: Bill - Shannon

Fields inherited from java.lang.Exception:
serialVersionUID

Constructor:

Constructor:
public MessagingException() { super(); initCause(null); // prevent anyone else from setting it } Constructs a MessagingException with no detail message.
public MessagingException(String s) { super(s); initCause(null); // prevent anyone else from setting it } Constructs a MessagingException with the specified detail message. Parameters: `s` - the detail message
public MessagingException(String s, Exception e) { super(s); next = e; initCause(null); // prevent anyone else from setting it } Constructs a MessagingException with the specified Exception and detail message. The specified exception is chained to this exception. Parameters: `s` - the detail message `e` - the embedded exception Also see: getNextException setNextException getCause

 public MessagingException() {
	super();
	initCause(null);	// prevent anyone else from setting it
}

Constructs a MessagingException with no detail message.

 public MessagingException(String s) {
	super(s);
	initCause(null);	// prevent anyone else from setting it
}

Constructs a MessagingException with the specified detail message.

Parameters:

s - the detail message

 public MessagingException(String s,
    Exception e) {
	super(s);
	next = e;
	initCause(null);	// prevent anyone else from setting it
}

Constructs a MessagingException with the specified Exception and detail message. The specified exception is chained to this exception.

Parameters:

s - the detail message

e - the embedded exception

Also see:

getNextException

setNextException

getCause

Method from javax.mail.MessagingException Summary:
getCause, getNextException, setNextException, toString

Methods from java.lang.Throwable:
fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

Methods from java.lang.Object:
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method from javax.mail.MessagingException Detail:
public synchronized Throwable getCause() { return next; } Overrides the `getCause` method of `Throwable` to return the next exception in the chain of nested exceptions.
public synchronized Exception getNextException() { return next; } Get the next exception chained to this one. If the next exception is a MessagingException, the chain may extend further.
public synchronized boolean setNextException(Exception ex) { Exception theEnd = this; while (theEnd instanceof MessagingException && ((MessagingException)theEnd).next != null) { theEnd = ((MessagingException)theEnd).next; } // If the end is a MessagingException, we can add this // exception to the chain. if (theEnd instanceof MessagingException) { ((MessagingException)theEnd).next = ex; return true; } else return false; } Add an exception to the end of the chain. If the end is not a MessagingException, this exception cannot be added to the end.
public synchronized String toString() { String s = super.toString(); Exception n = next; if (n == null) return s; StringBuffer sb = new StringBuffer(s == null ? "" : s); while (n != null) { sb.append(";\n nested exception is:\n\t"); if (n instanceof MessagingException) { MessagingException mex = (MessagingException)n; sb.append(mex.superToString()); n = mex.next; } else { sb.append(n.toString()); n = null; } } return sb.toString(); } Override toString method to provide information on nested exceptions.

Method from javax.mail.MessagingException Detail:

 public synchronized Throwable getCause() {
	return next;
}

getCause

Throwable

 public synchronized Exception getNextException() {
	return next;
}

Get the next exception chained to this one. If the next exception is a MessagingException, the chain may extend further.

 public synchronized boolean setNextException(Exception ex) {
	Exception theEnd = this;
	while (theEnd instanceof MessagingException &&
	       ((MessagingException)theEnd).next != null) {
	    theEnd = ((MessagingException)theEnd).next;
	}
	// If the end is a MessagingException, we can add this 
	// exception to the chain.
	if (theEnd instanceof MessagingException) {
	    ((MessagingException)theEnd).next = ex;
	    return true;
	} else
	    return false;
}

not

 public synchronized String toString() {
	String s = super.toString();
	Exception n = next;
	if (n == null)
	    return s;
	StringBuffer sb = new StringBuffer(s == null ? "" : s);
	while (n != null) {
	    sb.append(";\n  nested exception is:\n\t");
	    if (n instanceof MessagingException) {
		MessagingException mex = (MessagingException)n;
		sb.append(mex.superToString());
		n = mex.next;
	    } else {
		sb.append(n.toString());
		n = null;
	    }
	}
	return sb.toString();
}

Override toString method to provide information on nested exceptions.