Oracle SOA Suite Enterprise Service Bus

Transcription

1 Oracle SOA Suite Enterprise Service Bus Oracle 統合製品管理

2 Oracle ESB ヘッダーのサポート Slide 2

3 ユース ケース ESB ヘッダーのサポート ファイル JMS AQ MQ B2B アプリケーション ヘッダー変換 XSL 変換を使用 XSL 変数 新しい XPath の Get/Set Header 関数 最小の GUI サポート ヘッダー ベースのルーティング フィルタ式を使用 Slide 3

4 一方向の起動 リクエスト ヘッダー アウトバウンド ヘッダー ルーティング サービス リクエスト ヘッダー アウトバウンド ヘッダー 伝播 Slide 4

5 リクエスト / リプライの双方向の起動 インバウンド レスポンス ヘッダー レスポンス ヘッダー ルーティング サービス レスポンス ヘッダー インバウンド レスポンス ヘッダー パススルー Slide 5

6 ヘッダー変換 XSLT 拡張関数によるサポート ユーザーによるリクエスト ヘッダーおよびインバウンド レスポンス ヘッダーの読込み / 取得可 ユーザーによるアウトバウンド ヘッダーおよびレスポンス ヘッダーの書込み / 設定可 すべての拡張関数の名前空間 e.tip.esb.server.headers.esbheaderfunctions Slide 6

7 ヘッダー変換用拡張関数 1. String getrequestheader (String xpathexpression,string namespacedecl) 2. void setoutboundheader (String xpathexpression,string value, String namespacedecl) 3. String getinboundresponseheader (String xpathexpression,string namespacedecl) 4. void setresponseheader (String xpathexpression,string value, String namespacedecl) ここで xpathexpression : 取得 / 設定するXPath 式 value : xpathexpressionに設定する値 namespacedecl : 接頭辞 = 名前空間 形式による名前空間の宣言 Slide 7

8 ヘッダー変換例 例 : インバウンド ファイル アダプタ メッセージからヘッダー filename を読み込む場合 // Declare extension function s namespace in the XSL file as <xsl:stylesheet version="1.0. xmlns:ehdr= b.server.headers.esbheaderfunctions exclude-result-prefixes= > // Read filename from the header <xsl:variable name="get_infilename" select="ehdr:getrequestheader( '/fhdr:inboundfileheadertype/fhdr:filename', 'fhdr= ) /> Slide 8

9 ヘッダー変換例 例 : アウトバウンド ファイル アダプタ メッセージにヘッダー filename を書き込む場合 // Declare extension function s namespace in the XSL file as <xsl:stylesheet version="1.0. xmlns:ehdr= se rver.headers.esbheaderfunctions exclude-result-prefixes= > // Write filename from the header <xsl:variable name="set_outfilename" select="ehdr:setoutboundheader('/fhdr:outboundfileheadertype/fhdr :filename', $GET_INFILENAME, 'fhdr= Slide 9

10 ヘッダー ベースのルーティング XPath 拡張関数によるサポート リクエスト ヘッダーおよびインバウンド レスポンス ヘッダーによりユーザーによるフィルタの追加が可能 構文は 現行のフィルタ式と同じ { filterexprssion };{ namespacedeclaration } すべての拡張関数の名前空間 sb.server.headers.esbheaderfunctions 次のXPath 拡張機能を追加 1. String getrequestheader(string xpathexpression) 2. String getinboundresponseheader(string xpathexpression) ここで xpathexpression : ヘッダーを読み込むためのXPath 式 Slide 10

11 ヘッダー ベースのルーティング例 例 : インバウンド ファイル アダプタ メッセージにより読み込んだ filename が Payload.xml であるかどうかを確認する場合 // Check if filename from the header is Payload.xml // Filter Expression will look like {ehdr:getrequestheader('/fhdr:inboundfileheadertype/fhdr:filename ) == Payload.xml };{ namespace ehdr= ders.esbheaderfunctions namespace fhdr= Slide 11

12 既知の制限事項 Set Header() 関数は 次のタイプの XPath 式のみをサポート 絶対パス - /Customer/Address/Zip 索引付け - /Customer/Address[2]/Zip アドレス [1] がターゲット ドキュメントに存在しない場合 これが作成される 次の構文で作成された JMS カスタム プロパティがサポート対象 Get Property[position()=1]/@name Set Property[@name="Country"]/@value XSL 内部で使用する Get および Set Header 関数には入力 出力を明確に定義する必要がある SOAP の限定サポート ヘッダー要素をヘッダーとして設定 ユーザーはヘッダー要素から始まる XPath 式を使用する必要あり 例 : /Header/Message/Priority ツールの限定サポート Slide 12

13 ファイル ヘッダーのデモ JDeveloper File to File 入力ファイルのファイル名が Mobile.xml の場合にのみフィルタのルーティングを実行 変換によりファイル名が出力アダプタに伝播 Slide 13

14 ファイル ヘッダーのデモ XPath フィルタ フィルタ式 ehdr:getrequestheader('/fhdr:inboundfileheadertype/fhdr:filename') = 'Mobile.xml' Slide 14

15 ファイル ヘッダーのデモ XSLT XSL 変数設計ビュー INFILENAME OUTFILENAME Slide 15

16 ファイル ヘッダーのデモ XSLT XSL 変数ソース ビュー INFILENAME OUTFILENAME <xsl:variable name="infilename select="ehdr:getrequestheader('/fhdr:inboundfileheadertype/fhdr:filename','f hdr= <xsl:variable name="outfilename select="ehdr:setoutboundheader('/fhdr:outboundfileheadertype/fhdr:filename', $INFILENAME, 'fhdr= Slide 16

17 ファイル ヘッダーのデモ ランタイム Slide 17

18 ファイル ヘッダーのデモについての指示 1 フォルダ training\sampledata にある ESBHeader.zip を解凍してフォルダ c:\temp に入れる 2 JDeveloper を起動する 3 既存の ESBSamples プロジェクトを選択する 4 C:\temp\ESBheader\HeaderSupportDemo\HeaderSupportDemo.jpr を開く 5 ESB サーバーに登録する 6 System TVox の下にある ESB Console の新しいサービスのメタデータを確認する 7 C:\temp\ESBheader\*.xml ファイルを C:\temp\ESBheader\in にコピーする 8 両方のファイルは削除されるが Out ディレクトリでは Mobile.xml のみが削除されることを確認する 9 インスタンス データを ESB Console に表示する 注意 : C:\temp location は両方のアダプタでハードコード化される 別の場所に解凍した後 ファイル アダプタのウィザードを実行して場所を変更することができる Slide 18

19 ヘッダー追加情報 アダプタ名前空間入力プロパティ出力プロパティ XPath の例 JMS /adapter/jms/ jmsadapterinboundheader.wsdl JMSCorrelationID JMSDeliveryMode JMSExpiration JMSMessageID JMSPriority JMSRedelivered JMSType JMSTimestamp JMSReplyTo jmsadapteroutboundheader.ws dl JMSDestinationName JMSDestinationProperties JMSCorrelationID JMSType JMSReplyTo ('/jhdr:jmsinboundhead ersandproperties/jhdr:j MSInboundHeaders/jhdr: JMSCorrelationID') = 'HIGH' ファイル /adapter/file/ fileadapterinboundheader.wsdl ファイル名ディレクトリ fileadapteroutboundheader.ws dl ファイル名 ('/fhdr:inboundfileheade rtype/fhdr:filename') = 'Mobile.xml' AQ SOAP /adapter/aq/inbound/ ap/envelope/ aqadapterinboundheader.wsd aqadapterinboundheader.xsd MessageId 優先順位相関試行回数 EnqueueTime OrigMessageId aqadapteroutboundheader.ws dl aqadapteroutboundheader.xsd 優先順位遅延有効期限相関 RecipientList ExceptionQueue カスタム カスタム ('/soap:header/ns1:count ry') = US' 他のアダプタの例 : OTN の BPEL サンプルおよびアダプタに関するページを参照 Slide 19