Module jakarta.mail

Package jakarta.mail

Class SendFailedException

java.lang.Object

java.lang.Throwable

java.lang.Exception

jakarta.mail.MessagingException

jakarta.mail.SendFailedException

All Implemented Interfaces:

Serializable

Direct Known Subclasses:

SMTPAddressFailedException, SMTPSenderFailedException, SMTPSendFailedException

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.

See Also:

• Transport.send(jakarta.mail.Message)
• Transport.sendMessage(jakarta.mail.Message, jakarta.mail.Address[])
• TransportEvent
• Serialized Form

Field Summary

Fields

Modifier and Type	Field	Description
protected Address[]	invalid	The invalid addresses.
protected Address[]	validSent	Valid addresses to which message was sent.
protected Address[]	validUnsent	Valid addresses to which message was not sent.

Constructor Summary

Constructors

Constructor	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

Modifier and Type	Method	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 jakarta.mail.MessagingException

getCause, getNextException, setNextException, toString

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Details

invalid

protected transient Address[] invalid

The invalid addresses.

validSent

protected transient Address[] validSent

Valid addresses to which message was sent.

validUnsent

protected transient Address[] validUnsent

Valid addresses to which message was not sent.

Constructor Details

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 message

e - 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 message

ex - the embedded exception

validSent - valid addresses to which message was sent

validUnsent - valid addresses to which message was not sent

invalid - the invalid addresses

See Also:

• MessagingException.getNextException()
• MessagingException.setNextException(java.lang.Exception)

Method Details

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;