net.rim.blackberry.api.mail
Class SendFailedException

java.lang.Object
  java.lang.Throwable
      java.lang.Exception
          net.rim.blackberry.api.mail.MessagingException
              net.rim.blackberry.api.mail.SendFailedException

public class SendFailedException
extends MessagingException

Thrown when a message cannot be sent.

The exception includes:

• Addresses to which the message could not be sent
• Valid addresses to which the message was sent
• Valid addresses to which the message was not sent

Category:

Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.

Since:

BlackBerry API 3.6.0

Constructor Summary
	SendFailedException() Constructs a new SendFailedException instance.
	SendFailedException(String s) Constructs a new SendFailedException with provided detail message.
	SendFailedException(String msg, Address[] validSent, Address[] validUnsent, Address[] invalid) Constructs a new SendFailedException instance with provided detail message and address objects.

Method Summary
	Address[]	getInvalidAddresses() Retrieves the invalid addresses to which this message could not be sent.
	Address[]	getValidSentAddresses() Retrieves the addresses to which this message was sent succesfully.
	Address[]	getValidUnsentAddresses() Retrieves the valid addresses to which this message was not sent.

Methods inherited from class java.lang.Throwable

getMessage, printStackTrace, toString

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

SendFailedException

public SendFailedException()

Constructs a new SendFailedException instance.

Category:

Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.

Since:

BlackBerry API 3.6.0

SendFailedException

public SendFailedException(String s)

Constructs a new SendFailedException with provided detail message.

Parameters:

s - Detail message for this exception.

Category:

Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.

Since:

BlackBerry API 3.6.0

SendFailedException

public SendFailedException(String msg,
                           Address[] validSent,
                           Address[] validUnsent,
                           Address[] invalid)

Constructs a new SendFailedException instance with provided detail message and address objects.

Parameters:

msg - Detail message for this exception.

validSent - List of valid addresses to which the message was sent.

validUnsent - List of valid addresses to which the message was not sent.

invalid - List of invalid message to which the message could not be sent.

Category:

Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.

Since:

BlackBerry API 3.6.0

Method Detail

getInvalidAddresses

public Address[] getInvalidAddresses()

Retrieves the invalid addresses to which this message could not be sent.

Returns:

List of invalid addresses.

Category:

Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.

Since:

BlackBerry API 3.6.0

getValidSentAddresses

public Address[] getValidSentAddresses()

Retrieves the addresses to which this message was sent succesfully.

Returns:

List of valid addresses to which the message was sent.

Category:

Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.

Since:

BlackBerry API 3.6.0

getValidUnsentAddresses

public Address[] getValidUnsentAddresses()

Retrieves the valid addresses to which this message was not sent.

Returns:

List of valid addresses to which the message was not sent.

Category:

Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.

Since:

BlackBerry API 3.6.0