クラス MailMessageSender

java.lang.ObjectSE
org.springframework.ws.transport.AbstractWebServiceMessageSender<MailDestinationDescriptor>
org.springframework.ws.transport.mail.MailMessageSender
実装済みのインターフェース一覧:
org.springframework.beans.factory.InitializingBean, WebServiceMessageSender
public class MailMessageSender extends AbstractWebServiceMessageSender<MailDestinationDescriptor> implements org.springframework.beans.factory.InitializingBean
Mail MimeMessage を使用する WebServiceMessageSender 実装。transport および store URI を設定する必要があります。

このメッセージ送信者によって作成された接続で WebServiceConnection.receive(WebServiceMessageFactory) を呼び出すと、receiveSleepTime プロパティで指定されたミリ秒間、ブロッキング呼び出しとなります。これにより、サーバーはレスポンスメッセージを作成する時間を確保できます。デフォルトでは、このプロパティは 1 分に設定されています。適切なリクエストレスポンスのやり取りが機能するには、このプロパティ値がサーバー側メッセージ受信側ポーリング戦略の pollingInterval プロパティ値より小さくなってはなりません。

このメッセージ送信者は、次の形式の URI をサポートしています。

mailto:<to>[?param-name=param-value][&param-name=param-value]*
ここで、:、?、& は文字そのものを表します。to は RFC 822 メールボックスを表します。有効な param-name には以下が含まれます。
パラメーター名
param-name 説明
subject リクエストメッセージの件名。

メール URI の例: mailto:[email protected]
 mailto:[email protected]@?subject=SOAP%20Test

WebServiceMessageSender.UriSource.APPLICATION の場合、デフォルトのチェックでは任意の mailto: URI を受け入れます。WebServiceMessageSender.UriSource.REMOTE の場合、デフォルトのチェックでは MailDestinationDescriptor に整形式のメールボックス (解析可能な To、抽出可能なホスト、基本的なヘッダー挿入ガード) が必要です。メールボックスホストセグメント内の localhost および *.localhost は拒否します。ドメイン許可リスト、ヘッダールール、その他のメール固有の検証には WebServiceMessageSender.DestinationPolicy を使用してください。

導入:
1.5.0
関連事項:

  • フィールドの詳細

    • DEFAULT_RECEIVE_TIMEOUT

      public static final long DEFAULT_RECEIVE_TIMEOUT
      受信操作のデフォルトのタイムアウト。1000 * 60 ミリ秒（つまり 1 分）に設定します。
      関連事項:

  • コンストラクターの詳細

    • MailMessageSender

      public MailMessageSender()

  • 方法の詳細

    • setFrom

      public void setFrom(StringSE from) throws jakarta.mail.internet.AddressException
      リクエストメッセージを送信するときに使用する差出人アドレスを設定します。
      例外:
      jakarta.mail.internet.AddressException

    • setJavaMailProperties

      public void setJavaMailProperties(PropertiesSE javaMailProperties)
      Session の JavaMail プロパティを設定します。

      これらのプロパティを使用して新しい Session が作成されます。このメソッドまたは setSession(Session) のいずれかを使用します。両方は使用しないでください。

      このインスタンスのデフォルト以外のプロパティは、指定された JavaMail プロパティをオーバーライドします。

    • setReceiveSleepTime

      public void setReceiveSleepTime(long receiveSleepTime)
      受信呼び出しに使用するスリープ時間をミリ秒単位で設定します。デフォルトは 1000 * 60 ミリ秒、つまり 1 分です。

    • setSession

      public void setSession(jakarta.mail.Session session)
      おそらく JNDI からプルされた JavaMail Session を設定します。

      デフォルトはデフォルトなしの新しい Session で、このインスタンスのプロパティを介して完全に構成されます。

      事前設定された Session を使用している場合、このインスタンスのデフォルト以外のプロパティは Session の設定を上書きします。

      関連事項:

    • setStoreUri

      public void setStoreUri(StringSE storeUri)
      レスポンスメッセージの取得に使用する JavaMail ストア URI を設定します。通常は [imap|pop3]://user:password@host:port/INBOX の形式をとります。このプロパティの設定は必須です。

      例: imap://john:[email protected]/INBOX

      関連事項:
      • Session.getStore(URLName)

    • setTransportUri

      public void setTransportUri(StringSE transportUri)
      レスポンスメッセージの送信に使用する JavaMail トランスポート URI を設定します。通常、smtp://user:password@host:port の形式をとります。このプロパティの設定は必須です。

      例: smtp://john:[email protected]

      関連事項:
      • Session.getTransport(URLName)

    • afterPropertiesSet

      public void afterPropertiesSet() throws ExceptionSE
      次で指定:
      インターフェース org.springframework.beans.factory.InitializingBean 内の afterPropertiesSet 
      例外:
      ExceptionSE

    • createConnection

      public WebServiceConnection createConnection(URISE uri) throws IOExceptionSE
      インターフェースからコピーされた説明: WebServiceMessageSender
      指定された URI に新しい WebServiceConnection を作成します。
      次で指定:
      インターフェース WebServiceMessageSender 内の createConnection 
      パラメーター:
      uri - 接続を開くための URI
      戻り値:
      新しい接続
      例外:
      IOExceptionSE - I/O エラーの場合

    • createDescriptor

      protected MailDestinationDescriptor createDescriptor(URISE uri, WebServiceMessageSender.UriSource uriSource)
      クラスからコピーされた説明: AbstractWebServiceMessageSender
      指定された uri と uriSource に対して WebServiceMessageSender.DestinationDescriptor を作成します。
      次で指定:
      クラス AbstractWebServiceMessageSender<MailDestinationDescriptor> の createDescriptor 
      パラメーター:
      uri - 確認する URI
      uriSource - URI のソース
      戻り値:
      適切な記述子

    • defaultChecks

      protected PredicateSE<MailDestinationDescriptor> defaultChecks(WebServiceMessageSender.UriSource uriSource)
      クラスからコピーされた説明: AbstractWebServiceMessageSender
      指定された WebServiceMessageSender.UriSource に適用するデフォルトのチェックを返します。
      次で指定:
      クラス AbstractWebServiceMessageSender<MailDestinationDescriptor> の defaultChecks 
      戻り値:
      適用されるデフォルトのチェック

    • remoteDefaultChecks

      protected boolean remoteDefaultChecks(MailDestinationDescriptor details)