- java.lang.Object
-
- java.lang.Throwable
-
- java.lang.Exception
-
- javax.mail.MessagingException
-
- javax.mail.SendFailedException
-
- All Implemented Interfaces:
- Serializable
public class SendFailedException extends MessagingException
This exception is thrown when the message cannot be sent.The exception includes those addresses to which the message could not be sent as well as the valid addresses to which the message was sent and valid addresses to which the message was not sent.
- Author:
- John Mani, Max Spivak
- See Also:
Transport.send(javax.mail.Message),Transport.sendMessage(javax.mail.Message, javax.mail.Address[]),TransportEvent, Serialized Form
-
-
Field Summary
Fields Modifier and Type Field and Description protected Address[]invalidprotected Address[]validSentprotected Address[]validUnsent
-
Constructor Summary
Constructors Constructor and Description SendFailedException()Constructs a SendFailedException with no detail message.SendFailedException(String s)Constructs a SendFailedException with the specified detail message.SendFailedException(String s, Exception e)Constructs a SendFailedException with the specified Exception and detail message.SendFailedException(String msg, Exception ex, Address[] validSent, Address[] validUnsent, Address[] invalid)Constructs a SendFailedException with the specified string and the specified address objects.
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method and Description Address[]getInvalidAddresses()Return the addresses to which this message could not be sent.Address[]getValidSentAddresses()Return the addresses to which this message was sent succesfully.Address[]getValidUnsentAddresses()Return the addresses that are valid but to which this message was not sent.-
Methods inherited from class javax.mail.MessagingException
getCause, getNextException, setNextException, toString
-
Methods inherited from class java.lang.Throwable
addSuppressed, fillInStackTrace, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace
-
-
-
-
Field Detail
-
invalid
protected transient Address[] invalid
-
validSent
protected transient Address[] validSent
-
validUnsent
protected transient Address[] validUnsent
-
-
Constructor Detail
-
SendFailedException
public SendFailedException()
Constructs a SendFailedException with no detail message.
-
SendFailedException
public SendFailedException(String s)
Constructs a SendFailedException with the specified detail message.- Parameters:
s- the detail message
-
SendFailedException
public SendFailedException(String s, Exception e)
Constructs a SendFailedException with the specified Exception and detail message. The specified exception is chained to this exception.- Parameters:
s- the detail messagee- the embedded exception- See Also:
MessagingException.getNextException(),MessagingException.setNextException(java.lang.Exception)
-
SendFailedException
public SendFailedException(String msg, Exception ex, Address[] validSent, Address[] validUnsent, Address[] invalid)
Constructs a SendFailedException with the specified string and the specified address objects.- Parameters:
msg- the detail messageex- the embedded exceptionvalidSent- valid addresses to which message was sentvalidUnsent- valid addresses to which message was not sentinvalid- the invalid addresses- See Also:
MessagingException.getNextException(),MessagingException.setNextException(java.lang.Exception)
-
-
Method Detail
-
getValidSentAddresses
public Address[] getValidSentAddresses()
Return the addresses to which this message was sent succesfully.- Returns:
- Addresses to which the message was sent successfully or null
-
getValidUnsentAddresses
public Address[] getValidUnsentAddresses()
Return the addresses that are valid but to which this message was not sent.- Returns:
- Addresses that are valid but to which the message was not sent successfully or null
-
getInvalidAddresses
public Address[] getInvalidAddresses()
Return the addresses to which this message could not be sent.- Returns:
- Addresses to which the message sending failed or null;
-
-
Document created the 11/06/2005, last modified the 18/08/2025
Source of the printed document:https://www.gaudry.be/en/java-api-javaee-rf-javax/mail/sendfailedexception.html
The infobrol is a personal site whose content is my sole responsibility. The text is available under CreativeCommons license (BY-NC-SA). More info on the terms of use and the author.
References
These references and links indicate documents consulted during the writing of this page, or which may provide additional information, but the authors of these sources can not be held responsible for the content of this page.
The author of this site is solely responsible for the way in which the various concepts, and the freedoms that are taken with the reference works, are presented here. Remember that you must cross multiple source information to reduce the risk of errors.