Spec-Zone .ru
спецификации, руководства, описания, API


javax.mail
Транспорт класса

java.lang.Object
  расширенный javax.mail.Service
      расширенный javax.mail.Transport

public abstract class Transport
расширяет Службу

Абстрактный class, который моделирует транспорт сообщения. Подклассы обеспечивают фактические реализации.

Отметьте это Transport расширяется Service class, который обеспечивает много общепринятых методик для того, чтобы они назвали транспорты, соединяясь с транспортами, и слушая события соединения.

Автор:
Джон Мани, Макс Спивэк, Билл Шеннон
См. Также:
Service, ConnectionEvent, TransportEvent

Полевая Сводка
 
Поля, наследованные от class javax.mail. Служба
debug, session, url
 
Сводка конструктора
Transport(Session session, URLName urlname)
          Конструктор.
 
Сводка метода
 void addTransportListener(TransportListener l)
          Добавьте слушателя для событий Transport.
protected  void notifyTransportListeners(int type, Address[] validSent, Address[] validUnsent, Address[] invalid, Message msg)
          Уведомьте весь TransportListeners.
 void removeTransportListener(TransportListener l)
          Удалите слушателя для событий Transport.
static void send(Message msg)
          Отправьте сообщение.
static void send(Message msg, Address[] addresses)
          Отправьте сообщение указанным адресам, игнорируя любых получателей, определенных в сообщении непосредственно.
abstract  void sendMessage(Message msg, Address[] addresses)
          Отправьте сообщение указанному списку адресов.
 
Методы, наследованные от class javax.mail. Служба
addConnectionListener, close, connect, connect, connect, connect, finalize, getURLName, isConnected, notifyConnectionListeners, protocolConnect, queueEvent, removeConnectionListener, setConnected, setURLName, toString
 
Методы, наследованные от class java.lang. Объект
clone, equals, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

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

Транспорт

public Transport(Session session,
                 URLName urlname)
Конструктор.

Параметры:
session - Объект сеанса для этого Транспорта.
urlname - URLName возражают, чтобы использоваться для этого Транспорта
Деталь метода

передаться

public static void send(Message msg)
                 throws MessagingException
Отправьте сообщение. Сообщение будет отправлено всем адресам получателя, определенным в сообщении (как возвращено из Message метод getAllRecipients), использование сообщения транспортирует соответствующий каждому адресу. send вызовы метода saveChanges метод на сообщении прежде, чем отправить это.

Если какой-либо из адресов получателя обнаруживается, чтобы быть недопустимым Транспортом во время представления сообщения, SendFailedException бросается. Клиенты могут получить больше детали об отказе, исследуя исключение. Отправляется ли сообщение все еще успешно каким-либо допустимым адресам, зависит от Транспортной реализации. См. SendFailedException для большего количества деталей. Отметьте также, что успех не подразумевает, что сообщение было передано окончательному получателю, поскольку отказы могут произойти на более поздних этапах поставки. Как только Транспорт принимает сообщение для поставки получателю, об отказах, которые происходят позже, нужно сообщить пользователю через другой механизм, такой как возврат недоставленного сообщения.

В типичном использовании SendFailedException отражает ошибку, обнаруженную сервером. Детали SendFailedException будут обычно содержать сообщение об ошибке от сервера (такого как сообщение об ошибке SMTP). Адрес может быть обнаружен как недопустимый для множества причин - адрес, возможно, не существует, у адреса может быть недопустимый синтаксис, адрес, возможно, превысил свою квоту и т.д.

Отметьте это send статический метод, который создает и управляет его собственным соединением. Любое соединение, связанное с любым Транспортным экземпляром, используемым, чтобы вызвать этот метод, игнорируется и не используется. Этот метод должен только быть вызван, используя форму Transport.send(msg);, и никогда не должен вызываться, используя переменную экземпляра.

Параметры:
msg - сообщение, чтобы передаться
Броски:
SendFailedException - если сообщение не могло бы быть отправлено некоторым или ни одному из получателей.
MessagingException
См. Также:
Message#saveChanges, Message#getAllRecipients, send(Message, Address[]), SendFailedException

передаться

public static void send(Message msg,
                        Address[] addresses)
                 throws MessagingException
Отправьте сообщение указанным адресам, игнорируя любых получателей, определенных в сообщении непосредственно. send вызовы метода saveChanges метод на сообщении прежде, чем отправить это.

Параметры:
msg - сообщение, чтобы передаться
addresses - адреса, которым можно отправить сообщение
Броски:
SendFailedException - если сообщение не могло бы быть отправлено некоторым или ни одному из получателей.
MessagingException
См. Также:
Message#saveChanges, send(Message), SendFailedException

sendMessage

public abstract void sendMessage(Message msg,
                                 Address[] addresses)
                          throws MessagingException
Отправьте сообщение указанному списку адресов. Соответствующий TransportEvent, указывающий на состояние поставки, поставляют любому TransportListener, зарегистрированному на этом Транспорте. Кроме того, если какой-либо из адресов недопустим, SendFailedException бросается. Отправляется ли сообщение все еще, succesfully к любым допустимым адресам зависит от Транспортной реализации.

В отличие от помех send метод, sendMessage метод не вызывает saveChanges метод на сообщении; вызывающая сторона должна сделать так.

Параметры:
msg - Сообщение, которое будет отправлено
addresses - массив адресов, чтобы отправить это сообщение
Броски:
SendFailedException - если отправление отказавшего из-за недопустимых адресов.
MessagingException - если соединение мертво или не в соединенном состоянии
См. Также:
TransportEvent

addTransportListener

public void addTransportListener(TransportListener l)
Добавьте слушателя для событий Transport.

Реализация по умолчанию, обеспеченная здесь, добавляет этого слушателя внутреннего списка TransportListeners.

Параметры:
l - события Listener for Transport
См. Также:
TransportEvent

removeTransportListener

public void removeTransportListener(TransportListener l)
Удалите слушателя для событий Transport.

Реализация по умолчанию, обеспеченная здесь, удаляет этого слушателя из внутреннего списка TransportListeners.

Параметры:
l - слушатель
См. Также:
addTransportListener(javax.mail.event.TransportListener)

notifyTransportListeners

protected void notifyTransportListeners(int type,
                                        Address[] validSent,
                                        Address[] validUnsent,
                                        Address[] invalid,
                                        Message msg)
Уведомьте весь TransportListeners. Транспортные реализации, как ожидают, будут использовать этот метод, чтобы широковещательно передать TransportEvents.

Обеспеченная реализация по умолчанию ставит событие в очередь в очередь внутреннего события. Поток диспетчера события исключает события из очереди от очереди и диспетчеризирует их зарегистрированному TransportListeners. Отметьте, что диспетчеризация события происходит в отдельном потоке, таким образом избегая потенциальных проблем мертвой блокировки.



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

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

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

free hit counter