javax.mail.internet
public class InternetAddress extends Address implements Cloneable
Version: 1.4
Field Summary | |
---|---|
protected String | address
The string representation of the address. |
protected String | encodedPersonal
The RFC 2047 encoded version of the personal name. |
protected String | personal
The personal name. |
Constructor Summary | |
---|---|
InternetAddress()
Constructor for an empty address. | |
InternetAddress(String address)
Constructor with an RFC 822 string representation of the address.
| |
InternetAddress(String address, boolean strict)
Constructor with an RFC 822 string representation of the address. | |
InternetAddress(String address, String personal)
Constructor with an address and personal name.
| |
InternetAddress(String address, String personal, String charset)
Construct with an address and personal name.
|
Method Summary | |
---|---|
Object | clone()
Returns a copy of this address. |
boolean | equals(Object other) |
String | getAddress()
Returns the email address. |
InternetAddress[] | getGroup(boolean strict)
Returns the members of a group address. |
static InternetAddress | getLocalAddress(Session session)
Returns an InternetAddress object representing the current user.
|
String | getPersonal()
Returns the personal name. |
String | getType()
Returns the type of this address.
|
int | hashCode() |
boolean | isGroup()
Indicates whether this address is an RFC 822 group address.
|
static InternetAddress[] | parse(String addresslist)
Parses the given comma-separated sequence of RFC 822 addresses into
InternetAddresses. |
static InternetAddress[] | parse(String addresslist, boolean strict)
Parses the given comma-separated sequence of RFC 822 addresses into
InternetAddresses.
|
static InternetAddress[] | parseHeader(String addresslist, boolean strict)
Parses the given comma-separated sequence of RFC 822 addresses into
InternetAddresses.
|
void | setAddress(String address)
Sets the email address. |
void | setPersonal(String name, String charset)
Sets the personal name.
|
void | setPersonal(String name)
Sets the personal name.
|
String | toString()
Returns the RFC 822 / RFC 2047 string representation of this address.
|
static String | toString(Address[] addresses)
Converts the given array of InternetAddresses into a comma-separated
sequence of address strings.
|
static String | toString(Address[] addresses, int used)
Converts the given array of InternetAddresses into a comma-separated
sequence of address strings.
|
String | toUnicodeString()
Returns the RFC 822 string representation of this address.
|
void | validate()
Validate this address according to the syntax rules of RFC 822.
|
Parameters: address the address in RFC 822 format
Throws: AddressException if the parse failed
Parameters: address the address in RFC 822 format strict enforce RFC 822 syntax
Throws: AddressException if the parse failed
Since: JavaMail 1.3
Parameters: address the address in RFC 822 format personal the personal name
Parameters: address the address in RFC 822 format personal the personal name charset the charset for the personal name
null
.Throws: AddressException if a parse error occurs
Since: JavaMail 1.3
mail.from
mail.user
or
user.name
, and mail.host
user.name
and the hostname of
localhost as determined by InetAddress.getLocalHost
Parameters: session the session
InternetAddress
is "rfc822".Since: JavaMail 1.3
Parameters: addresslist the comma-separated addresses
Throws: AddressException if the parse failed
strict
is false, simple email addresses separated by
spaces are also allowed. If strict
is true, many (but not
all) of the RFC 822 syntax rules are enforced.
Even if strict
is true, addresses composed of simple
names (with no "@domain" part) are allowed.Parameters: addresslist the comma-separated addresses strict whether to enforce RFC 822 syntax
Throws: AddressException if the parse failed
strict
is false, simple email addresses separated by
spaces are also allowed. If strict
is true, many (but not
all) of the RFC 822 syntax rules are enforced.Parameters: addresslist the comma-separated addresses strict whether to enforce RFC 822 syntax
Throws: AddressException if the parse failed
Since: JavaMail 1.3
Parameters: name the personal name charset the charset to be used for any encoding UnsupportedEncodingException if charset encoding fails
Parameters: name the personal name
Throws: UnsupportedEncodingException if charset encoding fails
Parameters: addresses the InternetAddresses
Throws: ClassCastException if any of the specified addresses is not an InternetAddress
Parameters: addresses the InternetAddresses used the number of character positions already used, in the field into which the address string is to be inserted
Throws: ClassCastException if any of the specified addresses is not an InternetAddress
Throws: AddressException if the address is invalid
Since: JavaMail 1.3