メッセージ宛先参照は、EJB モジュール、アプリケーション・クライアント・モジュール、または動的 Web モジュール内に定義されているメッセージ宛先をポイントします。
デプロイメントでは、メッセージ宛先参照は、ターゲットの作動環境内の管理メッセージ宛先へ結び付けられます。
定義したそれぞれのメッセージ宛先参照ごとに、message-destination-ref 要素がそのアプリケーション・コンポーネントのデプロイメント記述子に追加されます。 メッセージ宛先参照は、それらが定義されているアプリケーション・コンポーネントにスコープされるので、ランタイム時は他のアプリケーション・コンポーネントからはアクセスできません。 その他のコンポーネントは、名前の競合なしに同じ名前でメッセージ宛先参照を定義できます。
メッセージ宛先リンク (message-destination-link 要素) は、メッセージ駆動型 Bean およびメッセージ宛先参照に定義できます。エンタープライズ Bean の message-destination-ref 要素の message-destination-link 要素は、ターゲット宛先にリンクするメッセージを生成します。message-destination-link 要素の値は、メッセージ宛先の名前です。
<message-destination-ref> <description></description> <message-destination-ref-name>MyDest_Ref</message-destination-ref-name> <message-destination-type>java.net.URL</message-destination-type> <message-destination-usage>Produces</message-destination-usage> <message-destination-link>MyDest</message-destination-link> </message-destination-ref>
メッセージ宛先参照の定義方法は、次のとおりです。