class="area">
目錄
概述
配置教程環境
創建 XSLT 模塊項目
創建 XML 架構
創建 WSDL 文件
創建 XSL 樣式表
創建和部署復合應用程序
測試 XSL 轉換服務
概述
在本教程中,您將了解 NetBeans Enterprise Pack 5.5.1 Beta 版中附帶的 XSLT Designer 的使用。XSLT Designer 用於開發、部署和測試 XSL 轉換服務。
XSL 轉換服務用作一種 Web 服務。它從外部客戶端接收消息,按照 XSL 樣式表對消息進行轉換,然後將消息發送回發起人或者將消息轉發給另一個 Web 服務。
在本教程中,您將創建一個簡單的 XSL 轉換服務,該服務接收消息、對消息進行轉換,然後將消息發送回調用它的 Web 服務。
前提條件
本教程假定您基本了解 NetBeans IDE,並且有使用 NetBeans IDE 編程的經驗。
系統要求
本教程假設您的系統符合 NetBeans Enterprise Pack 5.5.1 Beta 發行說明的“系統要求”部分指定的要求。
教程所需的軟件
注意:現在 NetBeans IDE 5.5.1 Release Candidate 已經發布。NetBeans Enterprise Pack 5.5.1 Beta 與這個 RC 版本的 IDE 結合使用。我們不打算發布 NetBeans Enterprise Pack 5.5.1 Beta 的任何進一步更新。我們的所有開發精力都集中在 NetBeans 6.0 和 SOA Pack 上。 開始之前,您必須在計算機上安裝以下軟件:
l NetBeans IDE 5.5.1 RC1(下載 IDE)
l NetBeans Enterprise Pack 5.5.1 Beta
配置教程環境
必須先正確配置和運行 JBI Runtime 和 Sun Java System Application Server 9,然後才能部署該應用程序。
要確認 JBI 服務器已啟動,請執行以下步驟:
1. 打開 Runtime 窗口。
2. 展開 Servers 節點。
3. 右鍵單擊 Sun Java System Application Server 9 節點,然後從彈出菜單中選擇 Start。如果 Start 選項不可用,並且 Sun Java System Application Server 節點旁邊有一個綠色三角形,則表示您的服務器已在運行。
4. 展開 Sun Java System Application Server 9 > JBI > Service Engines 並確保 XSLT 服務引擎正在運行。如果該服務引擎沒有運行,則右鍵單擊 com.sun.xsltse-1.0-2 節點,然後從彈出菜單中選擇 start。如果 start 選項不可用,則表示該服務引擎已在運行。
創建 XSLT 模塊項目
在 XSLT 模塊項目中創建 XSL 轉換服務。
要創建新的 XSLT 模塊項目,請執行以下操作:
1. 從 IDE 的主菜單中,選擇 File > New Project。
2. 在 Categories 下,選擇 Service Oriented Architecture。
3. 在 Projects 下,選擇 XSLT Module。
4. 單擊 Next。
5. 在 Project Name 字段中,鍵入 HelloXSLTransformation。
6. 修改項目位置或接受默認設置。
7. 單擊 Finish。
8. 現在 Projects 窗口包含 HelloXSLTransformation 項目節點。
接下來,我們將創建兩個 XML 架構 (.xsd) 文件,一個 Web 服務描述 (.wsdl) 文件和一個 XSL 樣式表 (.xsl) 文件。要運行 XSL 轉換服務,您至少需要一個 XML 架構文件、一個 WSDL 文件和一個 XSL 樣式表文件。在本教程中,我們將創建兩個 XML 架構文件。
創建 XML 架構
我們將創建兩個 XML 架構:HelloXSLTIncoming.xsd 和 HelloXSLTOutgoing.xsd。我們將使用前者作為傳入消息的基礎,後者作為傳出消息的基礎。
要創建用於傳入消息的 XML 架構,請執行以下操作:
1. 在 Projects 窗口中,右鍵單擊 HelloXSLTransformation > Transformation Files 節點,然後選擇 New > File/Folder。
2. 在 New File 對話框的 Categories 下,選擇 XML。
3. 在 File Types 下,選擇 XML Schema。
4. 單擊 Next。
5. 在 File Name 字段中,鍵入 HelloXSLTIncoming。
6. 單擊 Finish。一個新的節點 HelloXSLTIncoming.xsd 將出現在 HelloXSLTransformation 項目的 Transformation Files 節點下,並且新的架構在 XML Schema Editor 中打開。
7. 在 Schema 視圖的第一列中,右鍵單擊 Elements,然後從彈出菜單中選擇 Add Element。將打開 Element 對話框。
8. 在 Name 字段中,鍵入 name。
9. 在 Type 下,選擇 Inline Simple Type 單選按鈕。
10. 單擊 OK。
11. 要查看您創建的架構的源代碼,請單擊 XML Schema Editor 工具欄中的 Source 按鈕。您會看到以下代碼:
以下是引用片段:
targetNamespace="http://xml.netbeans.org/schema/HelloXSLTIncoming"
xmlns:tns="http://xml.netbeans.org/schema/HelloXSLTIncoming"
elementFormDefault="qualified">
要創建用於傳出消息的 XML 架構,請執行以下操作:
1. 重復上面的步驟 1-4。
2. 在 File Name 字段中,鍵入 HelloXSLTOutgoing。
3. 單擊 Finish。一個新的節點 HelloXSLTOutgoing.xsd 將出現在 HelloXSLTransformation 項目的 Transformation Files 節點下,並且新的架構將在 XML Schema Editor 中打開。
4. 在 Schema 視圖的第一列中,右鍵單擊 Elements,然後從彈出菜單中選擇 Add Element。將打開 Element 對話框。
5. 在 Name 字段中,鍵入 greeting。
6. 在 Type 下,選擇 Inline Simple Type 單選按鈕。
7. 單擊 OK。
8. 要查看您創建的架構的源代碼,請單擊 XML Schema Editor 工具欄中的 Source 按鈕。您應該會看到以下代碼:
以下是引用片段:
targetNamespace="http://xml.netbeans.org/schema/HelloXSLTOutgoing"
xmlns:tns="http://xml.netbeans.org/schema/HelloXSLTOutgoing"
elementFormDefault="qualified">
9. 單擊工具欄上的 Save All 按鈕。
您應該會在 HelloXSLTransformation 項目的 Transformation Files 節點下看到列出的兩個架構文件。
注意:XML Schema Editor 並不是本教程的主題。
創建 WSDL 文件
現在我們將創建一個 Web 服務描述文件,用於定義 XSL 轉換服務的 Web 接口。
要創建 WSDL 文件,請執行以下操作:
1. 在 Projects 窗口中,右鍵單擊 HelloXSLTransformation > Transformation Files 節點,然後選擇 New > File/Folder。
2. 在 New File 對話框的 Categories 下,選擇 XML。
3. 在 File Types 下,選擇 WSDL Document,然後單擊 Next。
4. 在 File Name 字段中,鍵入 HelloXSLTWSDL,然後單擊 Next。
5. 在 Input 下的 Element Or Type 列中,單擊省略號 (...) 按鈕。將打開 Select Element Or Type 對話框。
6. 選擇 HelloXSLTransformation > src/HelloXSLTIncoming.xsd > Elements > name 並單擊 OK。
7. 在 Output 的 Element Or Type 列中,單擊省略號 (...) 按鈕。將打開 Select Element Or Type 對話框。
8. 選擇 HelloXSLTransformation > src/HelloXSLTOutgoing.xsd > Elements > greeting 並單擊 OK。
9. 單擊 Next。
10. 在 Binding Type 字段中,選擇 SOAP。
11. 在 Binding Subtype 下,選擇 Document Literal,然後單擊 Finish。
您應該會在 HelloXSLTransformation 項目的 Transformation Files 節點下看到列出的 HelloXSLTWSDL.wsdl 文件。
注意:創建和編輯 WSDL 文件並不是本教程的主題。有關詳細信息,請參見 WSDL 編輯器開發者指南。