收藏服務(wù)：第二階段功能規(guī)范

申請(qǐng)免費(fèi)試用、咨詢電話：400-8352-114

收藏服務(wù)：第二階段功能規(guī)范

Andy Boyd

MSDN Architectural Samples Team

2001 年 9 月

摘要：本文檔定義在項(xiàng)目的第二階段中收藏 Web 服務(wù)示例應(yīng)用程序?qū)?shí)現(xiàn)的功能。在收藏 Web 服務(wù)示例的第二階段中將添加 Passport 身份驗(yàn)證、高級(jí)客戶端和 ASP.NET 客戶端。

MSDN Architectural Samples Team 非常希望您能提供有關(guān)本規(guī)范的反饋，您可以訪問 MSDN Web 服務(wù) newsgroup（英文），并將反饋放在 news:microsoft.public.msdn.webservices 中。

實(shí)施概述

本文檔定義在項(xiàng)目的第二階段中收藏 Web 服務(wù)將實(shí)現(xiàn)的功能。在收藏 Web 服務(wù)示例的第二階段中將把 Passport 身份驗(yàn)證、高級(jí)客戶端和 ASP.NET 客戶端作為附加功能添加進(jìn)來。第二階段的目的是簡(jiǎn)化和擴(kuò)展服務(wù)，并使我們的收藏服務(wù)應(yīng)用程序能夠利用未來技術(shù)的優(yōu)勢(shì)，這其中包括 Microsoft .NET My Services（以前稱為 HailStorm）。

注意：本文是收藏服務(wù)示例 Web 應(yīng)用程序第二階段功能規(guī)范的草案。MSDN Architectural Samples Team 之所以提前提供此規(guī)范，其目的就是希望得到有關(guān)收藏服務(wù)的下一版本將要實(shí)現(xiàn)的功能的注釋、建議和反饋。

除了有關(guān)現(xiàn)有項(xiàng)目的注釋外，MSDN Architectural Samples Team 還希望得到有關(guān)以后示例的問題、一般注釋和建議。請(qǐng)通過 MSDN Web 服務(wù) newsgroup（英文）將您的問題和建議提交給我們。

1. 項(xiàng)目概覽和范圍

1.1 問題陳述

在第一階段的收藏服務(wù)發(fā)布后，虛構(gòu)的 Cold Rooster 咨詢公司希望為被授權(quán)者和最終用戶改善其站點(diǎn)的功能。通過滿足更多的 Web 服務(wù)需求，Cold Rooster 的目標(biāo)是吸引更多的被授權(quán)者并使最終用戶愿意使用其（我們的）服務(wù)托管他們的數(shù)據(jù)。收藏服務(wù)將繼續(xù)完善，努力使?jié)撛诘目蛻粜欧?Web 服務(wù)的品質(zhì)與實(shí)用性。此服務(wù)將繼續(xù)：

提高潛在客戶的 Web 站點(diǎn)的價(jià)值

展示我們開發(fā)與操作實(shí)踐的品質(zhì)

以合理的成本實(shí)現(xiàn)和部署

第一階段實(shí)現(xiàn)的收藏服務(wù)存在幾個(gè)缺點(diǎn)：

用戶數(shù)據(jù)局限于每個(gè)被授權(quán)者——即，一個(gè)站點(diǎn)的收藏?cái)?shù)據(jù)無法通過另一個(gè)站點(diǎn)訪問。

用戶需要為使用收藏服務(wù)的每個(gè)站點(diǎn)創(chuàng)建唯一的登錄信息，并且還要記住這些信息。

雖然 Web 服務(wù)可同時(shí)支持 Web 和高級(jí)客戶端，但示例收藏服務(wù)只建立了 Web 客戶端。

1.2 第二階段修訂和更新

在第二階段中，將在收藏服務(wù)中添加以下功能：

用戶身份驗(yàn)證將通過 Microsoft Passport Service 2.0 進(jìn)行處理。這可使用戶在訪問站點(diǎn)時(shí)自動(dòng)訪問收藏?cái)?shù)據(jù)而不必創(chuàng)建單獨(dú)的登錄帳戶。

用戶可以通過同一身份訪問所有被授權(quán)者。通過獲得使用此服務(wù)授權(quán)的任意站點(diǎn)，用戶都可以訪問同一收藏集（每個(gè)帳戶）。

收藏服務(wù)的功能將添加到 Cold Rooster 服務(wù)中心應(yīng)用程序中。在 ColdStorage Service（英文）方面工作的小組當(dāng)前正在開發(fā)此應(yīng)用程序。收藏服務(wù)在 Web 頁或 Microsoft? Windows? 應(yīng)用程序中都可正常運(yùn)行。

收藏服務(wù)的部分組件將被按照 .NET 標(biāo)準(zhǔn)重新編寫，以改善服務(wù)的性能和功能。當(dāng)前，要重新建立的組件包括：

報(bào)告 UI

管理 UI

站點(diǎn) UI

報(bào)告和 GetFavorites 數(shù)據(jù)將以純 XML（而非 HTML 編碼的 XML）格式進(jìn)行傳遞。

為示范服務(wù)的跨站點(diǎn)功能，將通過附加的單獨(dú)示例站點(diǎn)擴(kuò)展 Cold Rooster Web 站點(diǎn)，從而展示唯一用戶的概念。通過使用 Microsoft 及可能的非 Microsoft (Linux) 站點(diǎn)，附加的站點(diǎn)還將分別展示收藏服務(wù)遵循標(biāo)準(zhǔn)的情況。

1.3 范圍

在第二階段中，Cold Rooster 咨詢公司將實(shí)現(xiàn)并部署收藏 Web 服務(wù)，從而授權(quán) Web 站點(diǎn)開發(fā)商在后臺(tái)使用該服務(wù)管理他們客戶的收藏。用戶可以在任何獲得使用該服務(wù)授權(quán)的 Web 站點(diǎn)保存收藏，并且可以在任何獲得使用該服務(wù)授權(quán)的站點(diǎn)上訪問這些收藏。通過最終用戶的權(quán)限，被授權(quán)者可以替用戶添加、刪除、編輯和組織收藏。被授權(quán)者也可以替單個(gè)客戶檢索其存儲(chǔ)的所有收藏。收藏 Web 服務(wù)還可以生成被授權(quán)者每周使用情況以及常用收藏的報(bào)告。

除 Web 服務(wù)以外，還將實(shí)現(xiàn)并部署一些工具以協(xié)助服務(wù)的操作。這些工具包括管理被授權(quán)者的工具、報(bào)告生成器以及服務(wù)管理工具。Cold Rooster 咨詢公司還將為被授權(quán)者提供示例和文檔，以說明如何將收藏服務(wù)集成到 Web 站點(diǎn)或高級(jí)客戶端中。這些示例由三個(gè)示例 Web 站點(diǎn)、一個(gè)帶有源代碼的高級(jí)客戶端以及一套完整的服務(wù)軟件開發(fā)工具包 (SDK) 組成。

2. 概念模型

此部分描述與收藏服務(wù)進(jìn)行交互的參與者，并定義與理解使用案例和需求相關(guān)的主要概念。概念模型的大部分信息與第一階段是相同的。有關(guān)其詳細(xì)信息，請(qǐng)參閱Phase One Functional Specification（英文）。

2.1 子系統(tǒng)

本文檔使用以下術(shù)語標(biāo)識(shí)收藏服務(wù)中的邏輯子系統(tǒng)和數(shù)據(jù)存儲(chǔ)區(qū)。

表 1：收藏服務(wù)子系統(tǒng)和數(shù)據(jù)存儲(chǔ)區(qū)

名稱 說明 收藏服務(wù) 整個(gè)系統(tǒng) 收藏 Web 服務(wù) 此部分系統(tǒng)為客戶端應(yīng)用程序提供用戶收藏管理服務(wù)。 收藏 Web 站點(diǎn) 收藏服務(wù)的可瀏覽界面，提供有關(guān)服務(wù)、管理服務(wù)以及提供給被授權(quán)者的文檔的一般信息。對(duì)于第二階段，將包括三個(gè)示例 Web 站點(diǎn)以及 Cold Rooster 咨詢公司的主站點(diǎn)。 收藏許可證管理系統(tǒng) 由客戶帳戶代表和服務(wù)經(jīng)營(yíng)者用來創(chuàng)建和維護(hù)許可證的子系統(tǒng)。 收藏被授權(quán)者數(shù)據(jù)存儲(chǔ)區(qū) 保存有關(guān)被授權(quán)者信息的數(shù)據(jù)存儲(chǔ)區(qū)。在第二階段中，收藏服務(wù)仍將是內(nèi)部維護(hù)的數(shù)據(jù)庫(kù)；Passport 2.0 將只用于用戶身份驗(yàn)證。 收藏報(bào)告服務(wù) 此部分系統(tǒng)為客戶端應(yīng)用程序提供有關(guān)被授權(quán)者使用收藏 Web 服務(wù)情況的報(bào)告。 收藏統(tǒng)計(jì)系統(tǒng) 由管理者以及服務(wù)經(jīng)營(yíng)者用來查看有關(guān)收藏服務(wù)使用方面統(tǒng)計(jì)信息的子系統(tǒng)。 Web 客戶端應(yīng)用程序 由被授權(quán)者提供的 Web 站點(diǎn)，最終用戶可使用該站點(diǎn)查看、訪問和管理收藏。 Cold Rooster 服務(wù)中心 MSDN Architectural Samples ColdStorage 組正在開發(fā)的高級(jí)客戶端，該客戶端將被擴(kuò)展以包含收藏服務(wù)功能。

2.2 授權(quán)模型

此服務(wù)將被授權(quán)給希望在其 Web 站點(diǎn)中提供收藏服務(wù)功能的公司。此項(xiàng)服務(wù)的主要增值點(diǎn)是：它為最終用戶提供了以書簽形式標(biāo)記訂閱站點(diǎn)內(nèi)容的能力，并使被授權(quán)者可基于內(nèi)容需要、用戶配置文件或內(nèi)容/產(chǎn)品的推廣，為最終用戶提供或建議附加的收藏。雖然此服務(wù)的主要目的不在于獲得收益，但將根據(jù)收藏請(qǐng)求的數(shù)量以及使用服務(wù)合約的時(shí)間長(zhǎng)度向被授權(quán)者收取一定費(fèi)用。

表 2：收藏服務(wù)授權(quán)模型

每月收藏請(qǐng)求的數(shù)量 合約時(shí)間 0-999 1000-9,999 10,000-50,000 50,000+ 1 個(gè)月 49.95/月 149.95/月 249.95/月 499.95/月 6 個(gè)月 44.95/月 139.95/月 229.95/月 459.95/月 12 個(gè)月 39.95/月 129.95/月 209.95/月 399.95/月

高級(jí)客戶端將成為 Cold Rooster 咨詢公司站點(diǎn)的服務(wù)，同時(shí)也是服務(wù)的使用者（被授權(quán)者）。高級(jí)客戶端將以廣告模式維持其自身的生存，該模式基于 ColdStorage Project（英文）使用的廣告服務(wù)。高級(jí)客戶端不包含在服務(wù)自身的收益或授權(quán)模型中，它和示例 Web 客戶端將被作為研究示例提供給被授權(quán)者。

此外，被授權(quán)者需要支付因使用 Passport 作為其身份驗(yàn)證服務(wù)而產(chǎn)生的費(fèi)用。Passport 本打算對(duì)服務(wù)經(jīng)營(yíng)者按年度象征性地收取許可證使用費(fèi)用，但目前 Microsoft 正要取消此費(fèi)用。

3. 使用案例

以下使用案例說明了外部參與者（最終用戶和客戶端應(yīng)用程序等）執(zhí)行一般操作時(shí)收藏服務(wù)的行為。大部分使用案例與第一階段使用案例是相同的——因此，這里只介紹第二階段中新增的使用案例。有關(guān)其他使用案例的詳細(xì)信息，請(qǐng)參閱 Phase One Functional Specification（英文）。

3.1 服務(wù)器實(shí)用程序使用案例

此部分列出完整使用案例的一部分。

驗(yàn)證許可證

收藏服務(wù)驗(yàn)證所提供的被授權(quán)者標(biāo)識(shí)符是否對(duì)應(yīng)于使用服務(wù)所需的有效許可證。如果不是，則向客戶端返回錯(cuò)誤信息（客戶端錯(cuò)誤：無效被授權(quán)者）。

有效許可證已被激活，它沒有過期，并且沒有被掛起。

驗(yàn)證用戶 ID

收藏服務(wù)驗(yàn)證所提供的 Passport ID (PID)。由于實(shí)際用戶憑據(jù)的驗(yàn)證由 Passport 處理，所以服務(wù)將只確認(rèn)該 PID 是否存在。如果不存在，服務(wù)將向客戶端返回錯(cuò)誤（客戶端錯(cuò)誤：無 Passport ID）。

記錄操作

收藏服務(wù)保存一份記錄，其中包括調(diào)用者的 IP 地址和被授權(quán)者 ID、操作開始的日期和時(shí)間、操作完成所需時(shí)間、操作類型、應(yīng)答類型（成功、服務(wù)器錯(cuò)誤、客戶端錯(cuò)誤），以及執(zhí)行操作者的 PID。

添加新用戶

通過同時(shí)指定被授權(quán)者標(biāo)識(shí)符和 PID，客戶端應(yīng)用程序向收藏服務(wù)提交請(qǐng)求以添加新的用戶。

收藏服務(wù)驗(yàn)證許可證，然后驗(yàn)證用戶 ID。如果許可證和用戶 ID 都有效，收藏服務(wù)將在數(shù)據(jù)存儲(chǔ)區(qū)中創(chuàng)建新的用戶記錄。如果成功添加記錄，將向客戶端應(yīng)用程序返回成功應(yīng)答。如果用戶 ID 已存在于數(shù)據(jù)存儲(chǔ)區(qū)中，或由于發(fā)生某種內(nèi)部處理錯(cuò)誤使得服務(wù)無法創(chuàng)建新的用戶記錄，則向客戶端應(yīng)用程序返回錯(cuò)誤（客戶端錯(cuò)誤：用戶 ID 已存在于數(shù)據(jù)存儲(chǔ)區(qū)中；服務(wù)器錯(cuò)誤：無法存儲(chǔ)用戶）。檢查重復(fù)的用戶 ID 是否是由于未區(qū)分大小寫造成的。收藏服務(wù)記錄添加新用戶的操作。

登錄到服務(wù)

客戶端 Web 站點(diǎn)重定向到 Passport 身份驗(yàn)證站點(diǎn)以確認(rèn)用戶是否已被驗(yàn)證。

如果用戶已被驗(yàn)證，Passport 重定向回客戶端站點(diǎn)（指出該用戶已被驗(yàn)證）并傳送用戶的 PID。

用戶身份驗(yàn)證是通過 Passport Manager 對(duì)象執(zhí)行的。有關(guān)詳細(xì)信息，請(qǐng)參閱 http://www.passport.com/DevInfo/dev_signin.asp（英文）。

當(dāng)最終用戶第一次使用 Passport 進(jìn)行身份驗(yàn)證時(shí)，客戶端應(yīng)用程序?qū)⑼ㄟ^同時(shí)指定被授權(quán)者標(biāo)識(shí)符和 PID，向收藏服務(wù)提交請(qǐng)求以檢索用戶的收藏。有關(guān)詳細(xì)信息，請(qǐng)參閱使用案例檢索所有收藏。如果 PID 不存在于數(shù)據(jù)庫(kù)中，將添加新的用戶帳戶。

注銷服務(wù)

客戶端 Web 站點(diǎn)從用戶的計(jì)算機(jī)中刪除會(huì)話 Cookie，然后對(duì)自己進(jìn)行刷新。然后，客戶端 Web 站點(diǎn)將檢測(cè)到用戶尚未登錄，并顯示登錄選項(xiàng)。

3.2 收藏服務(wù)使用案例

被授權(quán)者從 Web 客戶端得到的益處在于，用戶可以書簽形式標(biāo)記被授權(quán)者站點(diǎn)的內(nèi)容，并且可以在任何地方訪問該內(nèi)容——即，用戶可以書簽形式標(biāo)記任何被授權(quán)者站點(diǎn)的內(nèi)容，并且可通過任意一個(gè)被授權(quán)者站點(diǎn)訪問它們。在 Web 客戶端中只包含快捷添加收藏的功能；但有償使用服務(wù)后，一個(gè)最大的好處就是可鼓勵(lì)用戶訪問被授權(quán)者的 Web 站點(diǎn)。

檢索所有收藏

如果用戶尚未登錄到 Passport，則從客戶端 Web 站點(diǎn)選擇登錄選項(xiàng)。如果用戶已經(jīng)登錄，客戶端 Web 站點(diǎn)通過站點(diǎn)被授權(quán)者 ID 和 PID 向收藏服務(wù)提交 GetFavorites 請(qǐng)求。服務(wù)驗(yàn)證許可證 ID 和 PID。如果兩者都有效，服務(wù)將以 XML 格式返回用戶的所有數(shù)據(jù)。如果發(fā)生某種內(nèi)部處理錯(cuò)誤，使得服務(wù)無法檢索收藏，則向客戶端應(yīng)用程序返回錯(cuò)誤（服務(wù)器錯(cuò)誤：無法檢索收藏）。收藏服務(wù)記錄該操作。

添加新的收藏

在特定 Web 站點(diǎn)上，如果用戶要添加收藏，他們就可以選擇“添加新的收藏”鏈接。此鏈接將顯示在可顯示和處理 URL 的任何頁上，包括文檔和 Internet Explorer 鏈接欄。選中后，客戶端 Web 站點(diǎn)將檢查以確認(rèn)用戶是否已登錄，然后客戶端應(yīng)用程序通過指定 PID、統(tǒng)一資源定位符 (URI)、類別 ID、該頁的助記名稱以及被授權(quán)者標(biāo)識(shí)符，向收藏服務(wù)提交請(qǐng)求以在用戶的收藏中添加該頁。（客戶端應(yīng)用程序可讓用戶選擇現(xiàn)有類別并輸入收藏名稱，或只簡(jiǎn)單指定用戶的根類別并將頁標(biāo)題作為助記名稱。）

收藏服務(wù)驗(yàn)證許可證，然后驗(yàn)證用戶 ID。如果許可證和 PID 有效，收藏服務(wù)將驗(yàn)證 URI、類別 ID 和助記名稱。如果 URI、類別 ID 和助記名稱無效，將返回錯(cuò)誤?？赡艿腻e(cuò)誤包括：

客戶端錯(cuò)誤：URI 至少要包含一個(gè)字符

客戶端錯(cuò)誤：URI 的語法無效

客戶端錯(cuò)誤：類別不存在

客戶端錯(cuò)誤：助記名稱至少要包含一個(gè)字符

客戶端錯(cuò)誤：類別中已存在該助記名稱

如果所有參數(shù)都有效，收藏服務(wù)將在數(shù)據(jù)存儲(chǔ)區(qū)中創(chuàng)建新的收藏。如果成功添加記錄，將向客戶端應(yīng)用程序返回新的收藏 ID。如果發(fā)生某種內(nèi)部處理錯(cuò)誤，使得服務(wù)無法創(chuàng)建新的用戶記錄，則向客戶端應(yīng)用程序返回錯(cuò)誤（服務(wù)器錯(cuò)誤：無法存儲(chǔ)收藏）。收藏服務(wù)記錄添加新收藏的操作。

管理收藏

登錄后，用戶從客戶端 Web 站點(diǎn)提供的 Web 控件中選擇“管理收藏”選項(xiàng)?？蛻舳?Web 站點(diǎn)將檢索所有收藏，然后按類別顯示收藏，并在同時(shí)顯示選項(xiàng)，用于手動(dòng)添加收藏、添加新的類別、刪除收藏、刪除類別、重命名收藏、重命名類別、移動(dòng)收藏和復(fù)制收藏。

手動(dòng)添加收藏

在“管理收藏”屏幕上，用戶可以手動(dòng)添加收藏。非被授權(quán)者收藏只能通過選擇此選項(xiàng)添加。用戶將被提示輸入收藏的 URL、助記名稱，同時(shí)在屏幕上還將顯示列表框，以便用戶選擇類別。根收藏文件夾為默認(rèn)位置。選中后，客戶端 Web 站點(diǎn)將檢查以確認(rèn)用戶是否已登錄，然后客戶端應(yīng)用程序通過指定 PID、URI、類別 ID、該頁的助記名稱以及被授權(quán)者標(biāo)識(shí)符，向收藏服務(wù)提交請(qǐng)求以在用戶的收藏中添加該頁。收藏服務(wù)驗(yàn)證許可證，然后驗(yàn)證用戶 ID。如果許可證和 PID 有效，收藏服務(wù)將驗(yàn)證 URI、類別 ID 和助記名稱。如果 URI、類別 ID 和助記名稱無效，將返回錯(cuò)誤?？赡艿腻e(cuò)誤包括：

客戶端錯(cuò)誤：URI 至少要包含一個(gè)字符

客戶端錯(cuò)誤：URI 的語法無效

客戶端錯(cuò)誤：類別不存在

客戶端錯(cuò)誤：助記名稱至少要包含一個(gè)字符

客戶端錯(cuò)誤：類別中已存在該助記名稱

如果所有參數(shù)都有效，收藏服務(wù)將在數(shù)據(jù)存儲(chǔ)區(qū)中創(chuàng)建新的收藏。如果成功添加記錄，將向客戶端應(yīng)用程序返回新的收藏 ID。如果發(fā)生某種內(nèi)部處理錯(cuò)誤，使得服務(wù)無法創(chuàng)建新的用戶記錄，則向客戶端應(yīng)用程序返回錯(cuò)誤（服務(wù)器錯(cuò)誤：無法存儲(chǔ)收藏）。收藏服務(wù)記錄“添加新收藏”操作。

其他功能

有關(guān)基本功能（如添加、刪除和重命名收藏和類別）的詳細(xì)信息，請(qǐng)參閱 Phase One Functional Specification（英文）。

3.3 收藏服務(wù)高級(jí)客戶端使用案例

高級(jí)客戶端除了將作為收藏服務(wù)的核心外，還將作為 Cold Rooter 咨詢公司的創(chuàng)收工具。高級(jí)客戶端將成為用戶收藏的主要管理工具，而不是自由添加收藏的交互工具（Web 控件就是這種交互工具）。

查看收藏

此項(xiàng)為高級(jí)客戶端的默認(rèn)視圖。高級(jí)客戶端將顯示兩個(gè)按類別排列的窗格，一個(gè)樹形視圖和一個(gè)葉對(duì)象視圖。

添加新的收藏

在高級(jí)客戶端中未啟用一次單擊即可添加的功能。此功能在 Web 客戶端中使用，它將和被授權(quán)者進(jìn)行交互。在高級(jí)客戶端中可通過單擊“添加收藏”按鈕，手動(dòng)添加收藏。

手動(dòng)添加收藏

此功能與 Web 客戶端使用案例中的功能相同。

導(dǎo)入收藏

此功能將使用 IShellUIHelper::ImportExportFavorites 接口把本地存儲(chǔ)的所有收藏或書簽導(dǎo)入到 Web 服務(wù)中。

導(dǎo)出收藏

此功能將把所有收藏服務(wù)的收藏和類別導(dǎo)入到 Internet Explorer 的“收藏”菜單中。

同步收藏

同步收藏同時(shí)執(zhí)行導(dǎo)入收藏和導(dǎo)出收藏操作。

添加新的類別

功能上與 Web 客戶端使用案例相同，高級(jí)客戶端將通過上下文菜單、Windows 菜單和工具欄選項(xiàng)啟用“添加類別”功能。

刪除收藏

功能上與 Web 客戶端使用案例相同，高級(jí)客戶端將通過上下文菜單、Windows 菜單和工具欄選項(xiàng)啟用“刪除收藏”功能。

刪除類別

功能上與 Web 客戶端使用案例相同，高級(jí)客戶端將通過上下文菜單、Windows 菜單和工具欄選項(xiàng)啟用“刪除類別”功能。

重命名收藏

功能上與 Web 客戶端使用案例相同，高級(jí)客戶端將通過上下文菜單、Windows 菜單和高級(jí)客戶端單擊并輸入方法啟用“重命名收藏”功能。

重命名類別

功能上與 Web 客戶端使用案例相同，高級(jí)客戶端將通過上下文菜單、Windows 菜單和高級(jí)客戶端單擊并輸入方法啟用“重命名類別”功能。

移動(dòng)收藏

功能上與 Web 客戶端使用案例相同，高級(jí)客戶端將通過上下文菜單、Windows 菜單和高級(jí)客戶端拖放方法啟用“移動(dòng)收藏”功能。拖放時(shí)，移動(dòng)收藏將作為默認(rèn)操作。當(dāng)使用鼠標(biāo)右鍵單擊收藏時(shí)，上下文菜單中將顯示“移動(dòng)收藏”選項(xiàng)；當(dāng)使用鼠標(biāo)右鍵單擊收藏并將其拖動(dòng)到新的類別時(shí)，上下文菜單中將顯示“移動(dòng)收藏”和“復(fù)制收藏”選項(xiàng)。

復(fù)制收藏

功能上與 Web 客戶端使用案例相同，高級(jí)客戶端將通過上下文菜單、Windows 菜單和高級(jí)客戶端拖放方法啟用“復(fù)制收藏”功能。拖放時(shí)，移動(dòng)收藏將作為默認(rèn)操作。當(dāng)使用鼠標(biāo)右鍵單擊收藏時(shí)，上下文菜單中將顯示“復(fù)制收藏”選項(xiàng)；當(dāng)使用鼠標(biāo)右鍵單擊收藏并將其拖動(dòng)到新的類別時(shí)，上下文菜單中將顯示“移動(dòng)收藏”和“復(fù)制收藏”選項(xiàng)。

3.4 授權(quán)使用案例

除了將接口更新為 ASP.NET 以外，收藏服務(wù)的注冊(cè)過程沒有變化。有關(guān)完整的授權(quán)服務(wù)的詳細(xì)信息，請(qǐng)參閱 Phase One Functional Specification（英文）。

3.5 報(bào)告使用案例

有關(guān)報(bào)告服務(wù)方面的唯一更改是服務(wù)將傳遞純 XML，而非 HTML 編碼的 XML。此更改不會(huì)反映在任何使用案例中。有關(guān)完整的報(bào)告的詳細(xì)信息，請(qǐng)參閱 Phase One Functional Specification（英文）。

4. 交付內(nèi)容

此部分列出收藏服務(wù)第二階段將交付的軟件和文檔。

4.1 Web 服務(wù)

將在 Internet 上部署以下 Web 服務(wù)：

收藏登錄服務(wù)處理被授權(quán)者的身份驗(yàn)證/授權(quán)。被授權(quán)者登錄服務(wù)仍將使用內(nèi)部數(shù)據(jù)庫(kù)，而非 Passport。

收藏 Web 服務(wù)處理用戶收藏管理。服務(wù)的用戶接口元素將使用 .NET 框架編寫。

收藏報(bào)告服務(wù)生成使用收藏服務(wù)情況的報(bào)告。

4.2 開發(fā)工具包

開發(fā)工具包將包含：

文檔，其中包括：

參考頁，描述所有 Web 服務(wù)提供的每個(gè)操作。

開發(fā)人員指南，解釋如何通過客戶端應(yīng)用程序使用 Web 服務(wù)。

測(cè)試指南，解釋如何在客戶端應(yīng)用程序中測(cè)試 Web 服務(wù)的使用情況。

有關(guān)訪問測(cè)試服務(wù)的指導(dǎo)以及測(cè)試服務(wù)限制的說明。

已知問題的列表，包括特定工具集的互用問題。

針對(duì)操作人員的疑難解答過程。

有關(guān)所提供的客戶支持的信息。

示例客戶端應(yīng)用程序：

兩個(gè)使用收藏 Web 服務(wù)的 Web 客戶端應(yīng)用程序。其中至少有一個(gè)服務(wù)用于非 Microsoft 的 Web 服務(wù)器，如 Apache。此示例用于展示基于標(biāo)準(zhǔn)的 XML Web 服務(wù)在不同平臺(tái)上的使用。

使用收藏 Web 服務(wù)的 Windows 高級(jí)客戶端應(yīng)用程序。ColdStorage 項(xiàng)目組正在開發(fā)的 Cold Rooster 服務(wù)中心將作為高級(jí)客戶端，并且其中將附帶實(shí)現(xiàn)收藏服務(wù)功能的附加頁。

4.3 收藏 Web 站點(diǎn)

收藏 Web 站點(diǎn)為收藏服務(wù)提供 Cold Rooster 咨詢公司示例用戶接口。除 Phase One Functional Specification（英文）中的功能外，還有兩個(gè)用于第二階段的附加示例站點(diǎn)（總共三個(gè)站點(diǎn)）。這三個(gè)示例站點(diǎn)都可以獨(dú)立的被授權(quán)者身份使用獨(dú)立的域名來訪問收藏服務(wù)。收藏服務(wù)功能將通過每個(gè)站點(diǎn)的 Passport 2.0 啟用，展示了查看收藏?cái)?shù)據(jù)只與用戶有關(guān)而與所訪問的被授權(quán)者站點(diǎn)無關(guān)這一功能。

4.4 收藏 Windows 客戶端

收藏 Windows 客戶端將作為 Cold Rooster 服務(wù)中心附加的選項(xiàng)卡，通過它可以在 Windows 控件中訪問收藏服務(wù)的所有用戶功能。高級(jí)客戶端將僅用于收藏管理工具，因此不會(huì)提供添加其他收藏的便捷方法，無論這些收藏來自于被授權(quán)者還是非被授權(quán)者站點(diǎn)。這樣對(duì)功能進(jìn)行限制是為了促使用戶使用被授權(quán)者 Web 站點(diǎn)添加收藏，從而使付費(fèi)的被授權(quán)者得到更多的實(shí)惠。高級(jí)客戶端擁有以下主要功能：

用于復(fù)制和移動(dòng)收藏和類別的高級(jí)客戶端拖放功能

所有主要收藏服務(wù)管理任務(wù)的上下文菜單

所有主要收藏服務(wù)管理任務(wù)的工具欄按鈕

所有收藏服務(wù)管理任務(wù)的 Windows 菜單選項(xiàng)

從瀏覽器導(dǎo)入、導(dǎo)出到瀏覽器以及同步收藏的按鈕

4.5 Internet 應(yīng)用程序

以下應(yīng)用程序?qū)⒉渴鹪?Cold Rooster 咨詢公司的內(nèi)部：

收藏許可證管理系統(tǒng)

收藏統(tǒng)計(jì)系統(tǒng)

5. 要求

此部分總結(jié)并按優(yōu)先級(jí)列出收藏服務(wù)第二階段所要滿足的要求。

每個(gè)要求都被指定一個(gè)優(yōu)先級(jí)。優(yōu)先級(jí)編號(hào)范圍為 1 到 3：

沒有它將無法運(yùn)行

應(yīng)該具有

最好具有

要求部分只顯示第二階段中獨(dú)有的功能或開發(fā)要求。有關(guān)基本的服務(wù)要求，請(qǐng)參閱 Phase One Functional Specification（英文）。

5.1 第二階段服務(wù)要求

用戶收藏管理

要求 優(yōu)先級(jí) 標(biāo)題 注釋 2-101 2 收藏 Web 客戶端檢測(cè) Passport 登錄并自動(dòng)啟用收藏服務(wù)。 無 2-102 2 收藏高級(jí)客戶端檢測(cè) Passport 登錄并自動(dòng)啟用收藏服務(wù)。 無 2-103 1 在 Cold Rooster 咨詢公司和示例站點(diǎn)的所有頁中顯示“登錄到 Passport”框。 無 2-104 1 在高級(jí)客戶端中提供“登錄到 Passport”功能。 無 2-105 1 用戶通過使用同一 Passport 帳戶，可以從所有預(yù)訂服務(wù)的站點(diǎn)中查看收藏。請(qǐng)參閱 2-603。 無

安全性

要求 優(yōu)先級(jí) 標(biāo)題 注釋 2-201 1 審核蹤跡 對(duì)于每個(gè)服務(wù)請(qǐng)求，存儲(chǔ)調(diào)用者的 IP 地址、站點(diǎn) ID、Passport 用戶 ID (PUID)、日期/時(shí)間戳、請(qǐng)求類型和應(yīng)答類型。

非功能性要求

要求 優(yōu)先級(jí) 標(biāo)題 注釋 2-401 1 所有主要服務(wù)組件都使用 .NET 框架編寫。 無 2-402 1 GetFavorites 數(shù)據(jù)以純 XML 格式傳遞。 無

報(bào)告

要求 優(yōu)先級(jí) 標(biāo)題 注釋 2-501 1 報(bào)告服務(wù)數(shù)據(jù)以純 XML 格式傳遞。 無

開發(fā)人員文檔和工具

要求 優(yōu)先級(jí) 標(biāo)題 注釋 2-601 2 Passport 的開發(fā)人員文檔 解釋此流程：注冊(cè)并使用 Passport 對(duì)用戶進(jìn)行身份驗(yàn)證，然后將該身份驗(yàn)證傳遞給 Web 服務(wù)。 2-602 1 服務(wù)開發(fā)人員文檔 解釋如何將 .NET 功能集成到 Web 服務(wù)和服務(wù)客戶端中。 2-603 1 示例 Web 站點(diǎn) 向 Web 站點(diǎn)開發(fā)人員展示如何將收藏服務(wù)集成到他們的客戶端應(yīng)用程序中。將提供三個(gè) Web 站點(diǎn)作為示例，以展示唯一用戶登錄功能。部分示例站點(diǎn)將基于非 Microsoft 平臺(tái)，以示范 Web 服務(wù)遵循工業(yè)標(biāo)準(zhǔn)的情況。 2-604 2 示例高級(jí)客戶端 向被授權(quán)者展示如何添加集成了收藏服務(wù)的高級(jí)客戶端功能。

高級(jí)客戶端功能

要求 優(yōu)先級(jí) 標(biāo)題 注釋 2-901 1 菜單欄 用于訪問所有功能的標(biāo)準(zhǔn) Windows 菜單欄。 2-902 1 鼠標(biāo)右鍵單擊顯示的上下文菜單 用鼠標(biāo)右鍵單擊瀏覽器（默認(rèn)為根類別）中的類別或空白區(qū)域應(yīng)該顯示選項(xiàng)：（手動(dòng)）添加收藏、添加類別、刪除收藏、復(fù)制收藏、移動(dòng)收藏、重命名收藏。 2-903 2 工具欄 應(yīng)為主要功能啟用工具欄按鈕，包括：（手動(dòng)）添加收藏、添加類別、刪除（收藏或類別）、復(fù)制收藏、移動(dòng)收藏、重命名收藏。 2-904 1 拖放 收藏和類別可被拖放到任何新的收藏或類別中。 2-905 3 拖放上下文菜單 用鼠標(biāo)右鍵單擊并拖動(dòng)，應(yīng)該顯示上下文菜單，以復(fù)制收藏或移動(dòng)收藏（默認(rèn)為移動(dòng)）。 2-906 3 從瀏覽器導(dǎo)入收藏 只需進(jìn)行一次單擊操作，客戶端就可實(shí)現(xiàn)以下功能：從瀏覽器導(dǎo)入所有用戶收藏、比較服務(wù)中現(xiàn)有的收藏并向列表中添加新的收藏。 2-907 3 將收藏導(dǎo)出到瀏覽器 只需進(jìn)行一次單擊操作，客戶端就可實(shí)現(xiàn)以下功能：導(dǎo)出服務(wù)中的所有收藏、比較瀏覽器中現(xiàn)有的收藏并向?yàn)g覽器收藏列表中寫入新的條目。 2-908 3 同步收藏 同時(shí)執(zhí)行從瀏覽器導(dǎo)入和導(dǎo)出收藏的操作。 2-909 1 廣告服務(wù) 在 .NET 存儲(chǔ)項(xiàng)目中使用的廣告服務(wù)控件將顯示在收藏服務(wù)客戶端的頁面中。此功能體現(xiàn)客戶端的收入模型。 2-909 2 更改視圖控件 下拉列表框顯示收藏的預(yù)配置視圖。視圖顯示取決于隨收藏收集的元數(shù)據(jù)和由服務(wù)提供的元數(shù)據(jù)。視圖包括：

• 顯示 Cold Rooster 收藏。
• 顯示 Cold Rooster 收藏和其他收藏。
• 按被授權(quán)者排列所有收藏。