Package jakarta.mail.internet

Class AddressException

java.lang.Object

java.lang.Throwable

java.lang.Exception

jakarta.mail.MessagingException

jakarta.mail.internet.ParseException

jakarta.mail.internet.AddressException

All Implemented Interfaces:

Serializable

public class AddressException
extends ParseException

The exception thrown when a wrongly formatted address is encountered.

Author:

Bill Shannon, Max Spivak

See Also:

• Serialized Form

Field Summary

Fields

Modifier and Type	Field	Description
protected int	pos	The index in the string where the error occurred, or -1 if not known.
protected String	ref	The string being parsed.

Constructor Summary

Constructors

Constructor	Description
AddressException()	Constructs an AddressException with no detail message.
AddressException(String s)	Constructs an AddressException with the specified detail message.
AddressException(String s, String ref)	Constructs an AddressException with the specified detail message and reference info.
AddressException(String s, String ref, int pos)	Constructs an AddressException with the specified detail message and reference info.

Method Summary

Modifier and Type	Method	Description
int	getPos()	Get the position with the reference string where the error was detected (-1 if not relevant).
String	getRef()	Get the string that was being parsed when the error was detected (null if not relevant).
String	toString()	Override toString method to provide information on nested exceptions.

Methods inherited from class jakarta.mail.MessagingException

getCause, getNextException, setNextException

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

ref

protected String ref

The string being parsed.

pos

protected int pos

The index in the string where the error occurred, or -1 if not known.

Constructor Details

AddressException

public AddressException()

Constructs an AddressException with no detail message.

AddressException

public AddressException(String s)

Constructs an AddressException with the specified detail message.

Parameters:

s - the detail message

AddressException

public AddressException(String s,
 String ref)

Constructs an AddressException with the specified detail message and reference info.

Parameters:

s - the detail message

ref - the string being parsed

AddressException

public AddressException(String s,
 String ref,
 int pos)

Constructs an AddressException with the specified detail message and reference info.

Parameters:

s - the detail message

ref - the string being parsed

pos - the position of the error

Method Details

getRef

public String getRef()

Get the string that was being parsed when the error was detected (null if not relevant).

Returns:

the string that was being parsed

getPos

public int getPos()

Get the position with the reference string where the error was detected (-1 if not relevant).

Returns:

the position within the string of the error

toString

public String toString()

Description copied from class: MessagingException

Override toString method to provide information on nested exceptions.

Overrides:

toString in class MessagingException