Class SMTPAddressFailedException

  • All Implemented Interfaces:
    java.io.Serializable

    public class SMTPAddressFailedException
    extends jakarta.mail.SendFailedException
    This exception is thrown when the message cannot be sent.

    The exception includes the address to which the message could not be sent. This will usually appear in a chained list of exceptions, one per address, attached to a top level SendFailedException that aggregates all the addresses.

    Since:
    JavaMail 1.3.2
    See Also:
    Serialized Form
    • Field Summary

      Fields 
      Modifier and Type Field Description
      protected jakarta.mail.internet.InternetAddress addr  
      protected java.lang.String cmd  
      protected int rc  
      • Fields inherited from class jakarta.mail.SendFailedException

        invalid, validSent, validUnsent
    • Constructor Summary

      Constructors 
      Constructor Description
      SMTPAddressFailedException​(jakarta.mail.internet.InternetAddress addr, java.lang.String cmd, int rc, java.lang.String err)
      Constructs an SMTPAddressFailedException with the specified address, return code, and error string.
    • Method Summary

      All Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      jakarta.mail.internet.InternetAddress getAddress()
      Return the address that failed.
      java.lang.String getCommand()
      Return the command that failed.
      int getReturnCode()
      Return the return code from the SMTP server that indicates the reason for the failure.
      • Methods inherited from class jakarta.mail.SendFailedException

        getInvalidAddresses, getValidSentAddresses, getValidUnsentAddresses
      • 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 Detail

      • addr

        protected jakarta.mail.internet.InternetAddress addr
      • cmd

        protected java.lang.String cmd
      • rc

        protected int rc
    • Constructor Detail

      • SMTPAddressFailedException

        public SMTPAddressFailedException​(jakarta.mail.internet.InternetAddress addr,
                                          java.lang.String cmd,
                                          int rc,
                                          java.lang.String err)
        Constructs an SMTPAddressFailedException with the specified address, return code, and error string.
        Parameters:
        addr - the address that failed
        cmd - the command that was sent to the SMTP server
        rc - the SMTP return code indicating the failure
        err - the error string from the SMTP server
    • Method Detail

      • getAddress

        public jakarta.mail.internet.InternetAddress getAddress()
        Return the address that failed.
        Returns:
        the address
      • getCommand

        public java.lang.String getCommand()
        Return the command that failed.
        Returns:
        the command
      • getReturnCode

        public int getReturnCode()
        Return the return code from the SMTP server that indicates the reason for the failure. See RFC 821 for interpretation of the return code.
        Returns:
        the return code