使用UDDI的Web服務(wù)描述和發(fā)現(xiàn)（第二部分）

申請免費試用、咨詢電話：400-8352-114

使用UDDI的Web服務(wù)描述和發(fā)現(xiàn)（第二部分）

Scott Seely

Microsoft Corporation

2001年10月17日

簡介

在上一個專欄中，Karsten Januszewski 已經(jīng)帶我們訪問了 Microsoft? UDDI 小組。Karsten 概要介紹了 UDDI 的概念、用途和使用方法。在本文中，我們將介紹如何使用 Microsoft UDDI 注冊表注冊“Cold Rooster 收藏服務(wù)”。鑒于我們以前從未使用 UDDI 進行過注冊，現(xiàn)在就讓我們從頭講起。

用 UDDI 進行注冊

由于從未在 Microsoft UDDI 站點（英文）注冊過 Cold Rooster，所以首要任務(wù)就是在該站點創(chuàng)建一個帳戶。注冊帳戶要求使用 Passport 登錄。登錄后，您可以設(shè)置 UDDI 電子郵件聯(lián)系地址，將它連接到您的 Passport 帳戶或其他地址上。我選擇的地址是 crooster@microsoft.com，因為在我的小組里不止我一個人在使用 UDDI。原來 Cold Rooster 咨詢公司需要使用電子郵件時，我們已經(jīng)創(chuàng)建了這個電子郵件帳戶，這看來是個明智的選擇。

注冊屏幕還會提示輸入其他聯(lián)系信息，例如注冊者的姓名、聯(lián)系電話和通信地址。要完成注冊，您需要接受“使用規(guī)定”協(xié)議。請參閱 Terms of Use（英文）。

在注冊表中填好聯(lián)系信息，并接受“使用規(guī)定”后，UDDI 站點將向您發(fā)送一封電子郵件，確認您的聯(lián)系地址。單擊郵件中的鏈接，就可以管理您的 UDDI 帳戶了。管理工作涉及到向注冊表中添加公司數(shù)據(jù)、發(fā)布 tModel 以及編輯注冊詳細信息。圖 1 顯示了管理頁面。

圖 1：UDDI 管理頁面

在 UDDI 中添加公司

在 Microsoft UDDI 站點建立帳戶后，下一步就是向 UDDI 注冊表中添加 Cold Rooster 咨詢公司。我們可以通過 Web 頁面注冊公司，也可以使用 .NET SDK 或 COM SDK 調(diào)用 UDDI API 來注冊公司。我選擇使用 UI，因為我想一次注冊成功。如果將來要經(jīng)常更改接口內(nèi)容，就應(yīng)使該過程自動化以減少錯誤發(fā)生率。將公司添加到注冊表中，就可以使用戶根據(jù)我們的公司和所提供的 Web 服務(wù)的類型來找到我們。要在 UDDI 注冊表中添加 Cold Rooster 咨詢公司，請單擊管理頁面（圖 1）中的“Add a new business”鏈接。第一頁將要求提供公司名稱和說明。對于 Cold Rooster，我輸入：

Name：Cold Rooster 咨詢公司

Description：MSDN Architectural Samples 小組使用的虛擬公司

在 UDDI 注冊表中添加公司后，現(xiàn)在可以添加其他信息了：

Contacts：可以幫助客戶解決各種業(yè)務(wù)問題的人。我們將 MSDN Architectural Samples 小組的不同成員添加到聯(lián)系人列表中。

Services：該公司要提供的 tModel（WSDL 文件）。我們在 UDDI 條目中添加了“帳戶”、“登錄”和“報表”三種 tModel。

Identifiers：代表本公司的唯一的數(shù)據(jù)。例如，公司的注冊序號。因為 Cold Rooster 沒有上述數(shù)據(jù)，所以沒有填寫。

Business classifications：標(biāo)識公司所在的位置以及公司的業(yè)務(wù)。Cold Rooster 咨詢公司位于美國的華盛頓州。

Discovery URL：提供了可以查找公司詳細信息的位置。

首先完成簡單的項目，最后保存服務(wù)。

在 UDDI 中添加聯(lián)系信息

這非常簡單。就象填寫其他地址表格一樣，只要填寫不同聯(lián)系人的一般信息就可以了。潛在用戶可以根據(jù)說明和使用注釋來聯(lián)系貴公司，以便申請使用 Web 服務(wù)的許可、獲得支持或咨詢與業(yè)務(wù)相關(guān)的其他事項。圖 2 顯示了我的聯(lián)系信息表格的外觀。

圖 2：詳細的聯(lián)系信息頁

對公司進行分類

大多數(shù)公司可根據(jù)其業(yè)務(wù)范圍分類。對實體進行分類時，UDDI 分類有多種方法，包括：

North American Industry Classification System (NAICS-1997)（北美行業(yè)分類系統(tǒng)）

Universal Standard Products and Services Codes (UNSPSC-7.03)（通用標(biāo)準(zhǔn)產(chǎn)品和服務(wù)代碼）

ISO 3166 Geographic Taxonomy（ISO 3166 地理分類）

Standard Industrial Classification (SIC-1987)（標(biāo)準(zhǔn)行業(yè)分類）

GeoWeb Geographic Classification（GeoWeb 地理分類）

UDDI Types Taxonomy（UDDI 類型分類）

除了 UDDI 類型外，Cold Rooster 在所有分類中都進行了注冊。之所以未在 UDDI 類型分類中注冊公司，是因為它是專用于對 tModel 和服務(wù)信息進行分類的。

要了解需要注冊的內(nèi)容，就必須知道 Cold Rooster 的業(yè)務(wù)范圍和地理位置。Cold Rooster 咨詢公司位于美國華盛頓州的雷德蒙德。它提供基于工程的輔助性的計算機咨詢服務(wù)。而且，它擅長基于 Windows 和 Internet 的開發(fā)。知道了這些，我們需要分別按照六種分類方案為該公司正確分類。表 1 顯示了按照每種分類方案對該公司進行分類的情況。

分類方案 分類 NAICS

• 541511: Custom Computer Programming Services
• 541512: Computer Systems Design Services

• 81.11.16.07.00: Programming for C or C++
• 81.11.16.03.00: Programming for HTML
• 81.11.16.01.00: Programming for Microsoft? Visual Basic?
• 81.11.16.12.00: Programming or Proprietary Languages（也包括 C#）
• 81.11.21.06.00: Application Service Providers（提供 Web 服務(wù)）
• 81.11.21.03.00: World Wide Web (WWW) site design services

• US-WA (Washington, USA, World)

• 7371: Computer programming services
• 7372: Information retrieval services

• 518816 (Redmond, Washington, USA, North America, World)

表 1：UDDI 分類示例

公司分類完畢。下一步是添加三個 tModel。

添加 tModel

如果您沒有讀過上周的文章，那么請注意，tModel 就是一個類型模型。對于 Web 服務(wù)來說，tModel 通常就是 WSDL 文件的同義詞。它們使用同樣的方法定義 Web 服務(wù)所使用的類型以及消息和操作定義。給定一個 tModel，就可以知道何種 Web 服務(wù)操作是由實現(xiàn)該 tModel 的實體實現(xiàn)的，以及如何訪問這些操作。將 WSDL 文件注冊為 tModel，是因為這些 tModel 最終可能有多個實現(xiàn)。

服務(wù)器端的收藏 Web 服務(wù)包括三項 Web 服務(wù)：登錄、帳戶和報表。“登錄”Web 服務(wù)允許被授權(quán)者登錄并得到一個標(biāo)記。使用該標(biāo)記，被授權(quán)者可以訪問“帳戶”和“報表”Web 服務(wù)中的其他方法。要添加 WSDL 文件，需要將其部署在一個可以通過公共 Internet 訪問的服務(wù)器上。這里也需要使用 UDDI 分類。

要添加 tModel，請在管理頁面（圖 1）上單擊“Add a new tModel”。接著需要添加一些 tModel 的基本信息：名稱、說明以及 WSDL 文檔所在的位置。完成后，將 tModel 分類為 WSDL 文檔，并將信息發(fā)布到 UDDI 注冊表中。這真是輕而易舉。圖 3 顯示了“登錄”tModel 要填寫的詳細信息。

圖 3：“登錄”tModel 的詳細信息

在下一個屏幕上，可以添加服務(wù)分類和公司標(biāo)識。這里的數(shù)據(jù)和在公司信息中輸入的數(shù)據(jù)相同。作為服務(wù)分類，我們只使用了 UDDI 分類?？梢酝ㄟ^單擊一系列鏈接來指定這些信息：

用于 tModel 的類型

Web 服務(wù)的規(guī)范

WSDL 中說明的 Web 服務(wù)的規(guī)范

我在注冊 Cold Rooster 收藏服務(wù)時，對于 Logon.WSDL、Account.WSDL 和 Report.WSDL 就采用了這些步驟。完成 UDDI 注冊后，注冊表中的這些信息才可用。

定義服務(wù)

tModel 注冊完畢后，仍然需要添加服務(wù)以聲明存在這些服務(wù)。要添加服務(wù)，請回到管理頁面，這次您會看到您的公司已列在“Add a new business”（圖 1）中。選擇您的公司并滾動到“Services”。在此處單擊“Add a Service”。在第一頁填寫服務(wù)的詳細信息。對于“登錄”Web 服務(wù)，我填寫的內(nèi)容如下：

Name：登錄

Description：驗證被授權(quán)者并提供訪問標(biāo)記

完成后，再次將服務(wù)分類為“WSDL 中說明的 Web 服務(wù)規(guī)范”。接著將該服務(wù)綁定到已注冊的“登錄”tModel。在以下所示的“Define a new binding”字段中，我填寫的內(nèi)容如下：

Access point：https://Coldrooster.com/SSF/Logon.asp

URL type：http

Description：Cold Rooster 咨詢公司登錄 Web 服務(wù)的端點

要完成這一步，必須將服務(wù)與“收藏 Web 服務(wù)：登錄 tModel”聯(lián)系起來。在“Specification Signatures”下，選擇“Add specification signature”。要按名稱查看模型，請輸入“收藏 Web 服務(wù)”。這將調(diào)用收藏服務(wù)所保存的全部三個 tModel。選擇“收藏 Web 服務(wù)：登錄”并按下“Continue”。一個 Web 頁將顯示出來，您需要在上面編輯關(guān)于端點的詳細信息。我填寫的內(nèi)容如下：

Edit specification signature; Description：收藏 Web 服務(wù)的 Cold Rooster 實現(xiàn)：登錄 tModel

Instance details; Parameters：http://msdn.microsoft.com/library/?url=/library/en-us/dncold/html/ssfapiref.asp?frame=true

Instance details; Description：API 引用文檔

Overview document; Document location：http://msdn.microsoft.com/library/default.asp?url=/library/en-us/dncold/html/ssf1sec.asp

Overview document; Description：服務(wù)器端收藏安全信息

填寫完畢后，再次單擊“Continue”。接著，在返回到主公司數(shù)據(jù)視圖并向 UDDI 注冊表發(fā)布全部信息前，可以查看輸入的所有關(guān)于登錄服務(wù)的信息。對“帳戶”和“報表”Web 服務(wù)重復(fù)這一過程。

查找數(shù)據(jù)

根據(jù) GeoWeb 分類，今天（2001 年 10 月 8 日）只有一家公司列在雷德蒙德中：Cold Rooster 咨詢公司。使用 ISO 3166 分類再搜索一次。這次找到了九家公司。其他分類將產(chǎn)生其他的統(tǒng)計結(jié)果。對于其他的分類方案，其結(jié)果通常需要占用好幾頁。

現(xiàn)在數(shù)據(jù)是可以發(fā)現(xiàn)的，因此對存儲收藏 URL 的 Web 服務(wù)感興趣的人，在理論上可以找到并使用 Cold Rooster 解決方案。對于使用 Microsoft? Visual Studio? .NET 的用戶，使用 UDDI 查找 Web 服務(wù)并將其添加到自己的工程中將更加簡單。

第一次遇到“Add Web Reference”對話框（“Project”|“Add Web Reference”）時，會顯示一個對話框，允許您通過 Microsoft UDDI 服務(wù)器來查找 Web 引用（也稱為 WSDL 文件）。用于 Visual Studio 的端點是 http://uddi.microsoft.com/visualstudio/。當(dāng)告訴該端點查找所有以“cold”開頭的公司時，它只找到了我注冊的三個 Web 服務(wù)：帳戶、登錄和報表?？梢栽诖颂帲ㄓ⑽模┎榭创舜尾樵兊慕Y(jié)果。要將 Web 引用添加到“登錄”Web 服務(wù)中，只要單擊“Logon”以擴展該節(jié)點，然后單擊“Favorites Web Service: Logon”查看 WSDL。在這里，單擊“Add Reference”，就可以登錄到收藏 Web 服務(wù)了。

如果到現(xiàn)在您還沒有獲得收藏服務(wù)授權(quán)，請到 Favorites Service Admin Console（英文）申請一個。在 15-30 分鐘內(nèi)您將收到一個密碼。要使用 Visual Basic 連接到“登錄”Web 服務(wù)，則代碼編寫非常簡單：

Sub Main()
Dim svc As New com.coldrooster.www.Logon()
System.Console.WriteLine(svc.Logon("許可證持有者", "密碼"))
System.Console.WriteLine("按 Enter 鍵退出")
System.Console.ReadLine()
svc.Dispose()
End Sub

代碼將顯示 GUID 標(biāo)記，供用戶訪問收藏 Web 服務(wù)中可用的其他方法。編寫其他方法的代碼也同樣簡單。

總結(jié)

通過使用 UDDI 注冊公司、自定義 tModel 和 Web 服務(wù)，您可以幫助世界各地的開發(fā)人員找到您的 Web 服務(wù)。UDDI 注冊表允許您發(fā)布的不只是 Web 服務(wù)端點和公司數(shù)據(jù)。使用 UDDI 的用戶也可以使用該界面查找 Web 服務(wù)文檔和示例。Microsoft UDDI 注冊表是免費使用的。我們鼓勵用戶使用此注冊表注冊您的 Web 服務(wù)和公司。請花一些時間來熟悉 http://uddi.microsoft.com（英文）。您可能試圖查找 Cold Rooster 咨詢公司的信息，并瀏覽它以查看所有可用的信息。最后一點，現(xiàn)在可是使用 Visual Studio .NET 來連接收藏服務(wù)并進行實際操作的絕佳時機。

瀏覽：使用UDDI的Web服務(wù)描述和發(fā)現(xiàn)（第一部分）