org.springframework.mail
Class MailSendException

java.lang.Object
  extended byjava.lang.Throwable
      extended byjava.lang.Exception
          extended byjava.lang.RuntimeException
              extended byorg.springframework.core.NestedRuntimeException
                  extended byorg.springframework.mail.MailException
                      extended byorg.springframework.mail.MailSendException
All Implemented Interfaces:
java.io.Serializable

public class MailSendException
extends MailException

Exception thrown when a mail sending error is encountered. Can register failed messages with their exceptions.

Version:
$Id: MailSendException.java,v 1.6 2004/03/18 02:46:05 trisberg Exp $
Author:
Dmitriy Kopylenko, Juergen Hoeller
See Also:
Serialized Form

Constructor Summary
MailSendException(java.util.Map failedMessages)
          Constructor for registration of failed messages, with the messages that failed as keys, and the thrown exceptions as values.
MailSendException(java.lang.String msg)
           
MailSendException(java.lang.String msg, java.lang.Throwable ex)
           
 
Method Summary
 java.util.Map getFailedMessages()
          Return a Map with the failed messages as keys, and the thrown exceptions as values.
 java.lang.String getMessage()
          Return the detail message, including the message from the nested exception if there is one.
 void printStackTrace(java.io.PrintStream ps)
          Print the composite message and the embedded stack trace to the specified stream.
 void printStackTrace(java.io.PrintWriter pw)
          Print the composite message and the embedded stack trace to the specified writer.
 
Methods inherited from class org.springframework.core.NestedRuntimeException
getCause
 
Methods inherited from class java.lang.Throwable
fillInStackTrace, getLocalizedMessage, getStackTrace, initCause, printStackTrace, setStackTrace, toString
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Constructor Detail

MailSendException

public MailSendException(java.lang.String msg)

MailSendException

public MailSendException(java.lang.String msg,
                         java.lang.Throwable ex)

MailSendException

public MailSendException(java.util.Map failedMessages)
Constructor for registration of failed messages, with the messages that failed as keys, and the thrown exceptions as values.

The messages should be the same that were originally passed to the invoked send method.

Method Detail

getFailedMessages

public java.util.Map getFailedMessages()
Return a Map with the failed messages as keys, and the thrown exceptions as values. Note that a general mail server connection failure will not result in failed messages being returned here: A message will only be contained here if actually sending it was attempted but failed.

The messages will be the same that were originally passed to the invoked send method, i.e. SimpleMailMessages in case of using the generic MailSender interface.

In case of sending MimeMessage instances via JavaMailSender, the messages will be of type MimeMessage.

Returns:
the Map of failed messages as keys and thrown exceptions as values, or an empty Map if no failed messages

getMessage

public java.lang.String getMessage()
Description copied from class: NestedRuntimeException
Return the detail message, including the message from the nested exception if there is one.

Overrides:
getMessage in class NestedRuntimeException

printStackTrace

public void printStackTrace(java.io.PrintStream ps)
Description copied from class: NestedRuntimeException
Print the composite message and the embedded stack trace to the specified stream.

Overrides:
printStackTrace in class NestedRuntimeException
Parameters:
ps - the print stream

printStackTrace

public void printStackTrace(java.io.PrintWriter pw)
Description copied from class: NestedRuntimeException
Print the composite message and the embedded stack trace to the specified writer.

Overrides:
printStackTrace in class NestedRuntimeException
Parameters:
pw - the print writer


Copyright (C) 2003-2004 The Spring Framework Project.