SHOW Signed

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:

JDE 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.

Since:

JDE 3.6.0

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.

SendFailedException

public SendFailedException(String s)

Constructs a new SendFailedException with provided detail message.

Parameters:

s - Detail message for this exception.

Since:

JDE 3.6.0

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.

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.

Since:

JDE 3.6.0

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.

Method Detail

getInvalidAddresses

public Address[] getInvalidAddresses()

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

Returns:

List of invalid addresses.

Since:

JDE 3.6.0

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.

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.

Since:

JDE 3.6.0

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.

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.

Since:

JDE 3.6.0

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.