javax.mail.internet
Класс InternetAddress

java.lang.Object
  расширенный javax.mail.Address
      расширенный javax.mail.internet.InternetAddress
Все Реализованные Интерфейсы:
java.io. Сериализуемый, java.lang. Cloneable

public class InternetAddress
расширяет Адрес
реализации java.lang. Cloneable

Этот class представляет интернет-адрес электронной почты, используя синтаксис RFC822. Типичный синтаксис адреса имеет форму "user@host.domain" или "Имя <user@host.domain>".

Автор:
Билл Шеннон, Джон Мани
См. Также:
Сериализированная Форма

Полевая Сводка
protected  java.lang.String адрес
           
protected  java.lang.String encodedPersonal
          RFC 2047 закодированная версия имени.
protected  java.lang.String персональный
          Имя.
 
Сводка конструктора
InternetAddress()
          Конструктор по умолчанию.
InternetAddress(java.lang.String address)
          Конструктор.
InternetAddress(java.lang.String address, boolean strict)
          Проанализируйте данную строку и создайте InternetAddress.
InternetAddress(java.lang.String address, java.lang.String personal)
          Создайте InternetAddress, данный адрес и имя.
InternetAddress(java.lang.String address, java.lang.String personal, java.lang.String charset)
          Создайте InternetAddress, данный адрес и имя.
 
Сводка метода
 java.lang.Object clone()
          Возвратите копию этого объекта InternetAddress.
 boolean equals(java.lang.Object a)
          Оператор равенства.
 java.lang.String getAddress()
          Получите адрес электронной почты.
 InternetAddress[] getGroup(boolean strict)
          Возвратите элементы группового адреса.
static InternetAddress getLocalAddress(Session session)
          Возвратите объект InternetAddress представление текущего пользователя.
 java.lang.String getPersonal()
          Получите имя.
 java.lang.String getType()
          Возвратите тип этого адреса.
 int hashCode()
          Вычислите хэш-код для адреса.
 boolean isGroup()
          Указывает, является ли этот адрес групповым адресом RFC 822.
static InternetAddress[] parse(java.lang.String addresslist)
          Проанализируйте данную запятую разделенная последовательность адресов в объекты InternetAddress.
static InternetAddress[] parse(java.lang.String addresslist, boolean strict)
          Проанализируйте данную последовательность адресов в объекты InternetAddress.
static InternetAddress[] parseHeader(java.lang.String addresslist, boolean strict)
          Проанализируйте данную последовательность адресов в объекты InternetAddress.
 void setAddress(java.lang.String address)
          Установите адрес электронной почты.
 void setPersonal(java.lang.String name)
          Установите имя.
 void setPersonal(java.lang.String name, java.lang.String charset)
          Установите имя.
 java.lang.String toString()
          Преобразуйте этот адрес в RFC 822 / RFC 2047 закодированный адрес.
static java.lang.String toString(Address[] addresses)
          Преобразуйте данный массив объектов InternetAddress в запятую разделенная последовательность строк адреса.
static java.lang.String toString(Address[] addresses, int used)
          Преобразуйте данный массив объектов InternetAddress в запятую разделенная последовательность строк адреса.
 java.lang.String toUnicodeString()
          Возвращает должным образом отформатированный адрес (синтаксис RFC 822) символов Unicode.
 void validate()
          Проверьте того этого адреса, соответствует правилам синтаксиса RFC 822.
 
Методы, наследованные от class java.lang. Объект
finalize, getClass, notify, notifyAll, wait, wait, wait
 

Полевая Деталь

адрес

protected java.lang.String address

персональный

protected java.lang.String personal
Имя.


encodedPersonal

protected java.lang.String encodedPersonal
RFC 2047 закодированная версия имени.

Это поле и personal поле отслеживает друг друга, так, если подкласс устанавливает одно из этих полей непосредственно, это должно установить другой в null, так, чтобы это было соответственно повторно вычислено.

Деталь конструктора

InternetAddress

public InternetAddress()
Конструктор по умолчанию.


InternetAddress

public InternetAddress(java.lang.String address)
                throws AddressException
Конструктор.

Проанализируйте данную строку и создайте InternetAddress. См. parse метод для деталей парсинга. Адрес анализируется, используя "строгий" парсинг. Этот конструктор не выполняет дополнительные проверки синтаксиса что InternetAddress(String address, boolean strict) конструктор делает когда strict true. Этот конструктор эквивалентен InternetAddress(address, false).

Параметры:
address - адрес в формате RFC822
Броски:
AddressException - если синтаксический анализ перестал работать

InternetAddress

public InternetAddress(java.lang.String address,
                       boolean strict)
                throws AddressException
Проанализируйте данную строку и создайте InternetAddress. Если strict ложь, подробный синтаксис адреса не проверяется.

Параметры:
address - адрес в формате RFC822
strict - осуществите синтаксис RFC822
Броски:
AddressException - если синтаксический анализ перестал работать
С тех пор:
JavaMail 1.3

InternetAddress

public InternetAddress(java.lang.String address,
                       java.lang.String personal)
                throws java.io.UnsupportedEncodingException
Создайте InternetAddress, данный адрес и имя. Адрес, как предполагается, является синтаксически допустимым адресом RFC822.

Параметры:
address - адрес в формате RFC822
personal - имя
Броски:
java.io.UnsupportedEncodingException

InternetAddress

public InternetAddress(java.lang.String address,
                       java.lang.String personal,
                       java.lang.String charset)
                throws java.io.UnsupportedEncodingException
Создайте InternetAddress, данный адрес и имя. Адрес, как предполагается, является синтаксически допустимым адресом RFC822.

Параметры:
address - адрес в формате RFC822
personal - имя
charset - набор символов MIME для имени
Броски:
java.io.UnsupportedEncodingException
Деталь метода

клон

public java.lang.Object clone()
Возвратите копию этого объекта InternetAddress.

Переопределения:
clone в class java.lang.Object
С тех пор:
JavaMail 1.2

getType

public java.lang.String getType()
Возвратите тип этого адреса. Тип InternetAddress является "rfc822".

Определенный:
getType в class Address
Возвраты:
тип адреса
См. Также:
InternetAddress

setAddress

public void setAddress(java.lang.String address)
Установите адрес электронной почты.

Параметры:
address - адрес электронной почты

setPersonal

public void setPersonal(java.lang.String name,
                        java.lang.String charset)
                 throws java.io.UnsupportedEncodingException
Установите имя. Если имя будет содержать не символы US-ASCII, то имя будет закодировано, используя указанный набор символов согласно RFC 2047. Если имя содержит только символы US-ASCII, никакое кодирование не делается, и имя используется как есть.

Параметры:
name - имя
charset - Набор символов MIME, который будет использоваться, чтобы закодировать имя согласно RFC 2047
Броски:
java.io.UnsupportedEncodingException - если кодирование набора символов перестало работать.
См. Также:
setPersonal(String)

setPersonal

public void setPersonal(java.lang.String name)
                 throws java.io.UnsupportedEncodingException
Установите имя. Если имя будет содержать не символы US-ASCII, то имя будет закодировано, используя набор символов значения по умолчанию платформы. Если имя содержит только символы US-ASCII, никакое кодирование не делается, и имя используется как есть.

Параметры:
name - имя
Броски:
java.io.UnsupportedEncodingException - если кодирование набора символов перестало работать.
См. Также:
setPersonal(String name, String charset)

getAddress

public java.lang.String getAddress()
Получите адрес электронной почты.

Возвраты:
адрес электронной почты

getPersonal

public java.lang.String getPersonal()
Получите имя. Если имя кодируется согласно RFC 2047, оно декодируется и преобразовывается в Unicode. Если декодирование или сбои преобразования, необработанные данные возвращаются, как.

Возвраты:
имя

toString

public java.lang.String toString()
Преобразуйте этот адрес в RFC 822 / RFC 2047 закодированный адрес. Получающаяся строка содержит только символы US-ASCII, и следовательно почтово-безопасна.

Определенный:
toString в class Address
Возвраты:
возможно закодированная строка адреса

toUnicodeString

public java.lang.String toUnicodeString()
Возвращает должным образом отформатированный адрес (синтаксис RFC 822) символов Unicode.

Возвраты:
Unicode адресуют строку
С тех пор:
JavaMail 1.2

равняется

public boolean equals(java.lang.Object a)
Оператор равенства.

Определенный:
equals в class Address
Параметры:
a - Объект адреса

хэш-код

public int hashCode()
Вычислите хэш-код для адреса.

Переопределения:
hashCode в class java.lang.Object

toString

public static java.lang.String toString(Address[] addresses)
Преобразуйте данный массив объектов InternetAddress в запятую разделенная последовательность строк адреса. Получающаяся строка содержит только символы US-ASCII, и следовательно почтово-безопасна.

Параметры:
addresses - массив объектов InternetAddress
Возвраты:
запятая разделенная строка адресов
Броски:
ClassCastException, - если какой-либо объект адреса в данном массиве не является объектом InternetAddress. Отметьте, что это - RuntimeException.

toString

public static java.lang.String toString(Address[] addresses,
                                        int used)
Преобразуйте данный массив объектов InternetAddress в запятую разделенная последовательность строк адреса. Получающаяся строка содержит только символы US-ASCII, и следовательно почтово-безопасна.

'Используемый' параметр определяет число символьных позиций, уже приведенных в рабочее состояние в поле, в которое должна быть вставлена получающаяся строка последовательности адреса. Это используется, чтобы определить позиции разрыва строки в получающейся строке последовательности адреса.

Параметры:
addresses - массив объектов InternetAddress
used - число символьных позиций, уже используемых, в поле, в которое должна быть вставлена строка адреса.
Возвраты:
запятая разделенная строка адресов
Броски:
ClassCastException, - если какой-либо объект адреса в данном массиве не является объектом InternetAddress. Отметьте, что это - RuntimeException.

getLocalAddress

public static InternetAddress getLocalAddress(Session session)
Возвратите объект InternetAddress представление текущего пользователя. Весь адрес электронной почты может быть определен в "mail.from" свойстве. Если не набор, "mail.user" и "mail.host" свойства пробуют. Если те не устанавливаются, "user.name" свойство и InetAddress.getLocalHost метод пробуют. Игнорируются исключения безопасности, которые могут произойти, получая доступ к этой информации. Если не возможно определить адрес электронной почты, нуль возвращается.

Параметры:
session - Объект сеанса используется для поиска свойства
Возвраты:
адрес электронной почты текущего пользователя

синтаксический анализ

public static InternetAddress[] parse(java.lang.String addresslist)
                               throws AddressException
Проанализируйте данную запятую разделенная последовательность адресов в объекты InternetAddress. Адреса должны следовать за синтаксисом RFC822.

Параметры:
addresslist - запятая разделенные строки адреса
Возвраты:
массив объектов InternetAddress
Броски:
AddressException - если синтаксический анализ перестал работать

синтаксический анализ

public static InternetAddress[] parse(java.lang.String addresslist,
                                      boolean strict)
                               throws AddressException
Проанализируйте данную последовательность адресов в объекты InternetAddress. Если strict ложные, простые адреса электронной почты, разделенные пробелами, также позволяются. Если strict истина, многие (но не все) правил синтаксиса RFC822 осуществляются. В частности даже если strict истина, адреса, составленные из простых имен (без "@domain" части), позволяются. Такие "недопустимые" адреса весьма распространены в реальных сообщениях.

Нестрогий парсинг обычно используется, анализируя список почтовых адресов, вводимых человеком. Строгий парсинг обычно используется, анализируя заголовки адреса в почтовых сообщениях.

Параметры:
addresslist - запятая разделенные строки адреса
strict - осуществите синтаксис RFC822
Возвраты:
массив объектов InternetAddress
Броски:
AddressException - если синтаксический анализ перестал работать

parseHeader

public static InternetAddress[] parseHeader(java.lang.String addresslist,
                                            boolean strict)
                                     throws AddressException
Проанализируйте данную последовательность адресов в объекты InternetAddress. Если strict ложь, полные правила синтаксиса для отдельных адресов не осуществляются. Если strict истина, многие (но не все) правил синтаксиса RFC822 осуществляются.

Чтобы лучше поддерживать диапазон "недопустимых" адресов, замеченных в реальных сообщениях, этот метод осуществляет меньше правил синтаксиса чем parse метод, когда строгий флаг является ложью и осуществляет больше правил, когда строгий флаг является истиной. Если строгий флаг является ложью, и синтаксический анализ успешен в выделении адреса электронной почты или адресов, синтаксис самих адресов не проверяется.

Параметры:
addresslist - запятая разделенные строки адреса
strict - осуществите синтаксис RFC822
Возвраты:
массив объектов InternetAddress
Броски:
AddressException - если синтаксический анализ перестал работать
С тех пор:
JavaMail 1.3

проверить

public void validate()
              throws AddressException
Проверьте того этого адреса, соответствует правилам синтаксиса RFC 822. Текущая реализация проверяет многих, но не все, правила синтаксиса. Отметьте, что даже при том, что синтаксис адреса может быть корректным, нет никакой гарантии, что почтовый ящик того имени существует.

Броски:
AddressException - если адрес не допустим.
С тех пор:
JavaMail 1.3

isGroup

public boolean isGroup()
Указывает, является ли этот адрес групповым адресом RFC 822. Отметьте, что групповой адрес отличается чем адреса списка рассылки, поддерживаемые большинством почтовых серверов. Групповые адреса редко используются; см. RFC 822 для деталей.

Возвраты:
истина, если этот адрес представляет группу
С тех пор:
JavaMail 1.3

getGroup

public InternetAddress[] getGroup(boolean strict)
                           throws AddressException
Возвратите элементы группового адреса. У группы может быть нуль, один, или больше элементов. Если этот адрес не является группой, нуль возвращается. strict параметр управляет, анализируется ли групповой список, используя строгие правила RFC 822 или нет. Парсинг делается, используя parseHeader метод.

Возвраты:
массив объектов InternetAddress, или нуль
Броски:
AddressException - если групповой список не может быть проанализирован
С тех пор:
JavaMail 1.3


Представьте ошибку или функцию

Авторское право © 2009-2011, Oracle Corporation и/или его филиалы. Все права защищены. Использование подвергается срокам действия лицензии.

Сгенерированный на 10-February-2011 12:41


Spec-Zone.ru - all specs in one place



free hit counter