WebSerivce[创建分布式应用程序]

创建分布式应用程序

在本演练中，您将创建一个多层的分布式 Intranet 应用程序。此应用程序由三个逻辑层组成：数据层、业务对象层和用户界面层。数据层是 SQL Server 中的数据库。业务对象层处理如何访问数据以及如何将数据分发到客户端。用户界面层由基于 Web 的应用程序和传统的 Windows 应用程序组成。下图描述了此应用程序的结构。

您将创建的分布式应用程序的结构

将要生成的应用程序是具有查找和编辑功能的简单数据应用程序。您将生成一个既是 Windows 又基于 Web 的客户端，以显示 SQL Server Pubs 示例数据库中的 Authors 表。对于 Web 部分，您将通过 Web 窗体设计器创建一个与标准 HTML 3.2 浏览器兼容的 Web 页。在服务器上，Web 窗体代码将调用 XML Web services 以从数据库中检索包含作者信息的数据。对于 Windows 部分，您将生成一个 Windows 应用程序，它与同一个 XML Web services 通信以检索包含作者信息的数据集。使用 HTTP 和 XML 处理与此 XML Web services 的通信。

您将在同一个服务器上创建 XML Web services 和客户端应用程序，即使数据库驻留在另一个服务器上。应用程序服务器和数据库服务器必须驻留在同一个 Intranet 上。这种项目结构使您得以使用 Windows 身份验证来访问数据库和测试应用程序。同时，这种结构移除了资源访问的许多详细信息，使您能够看到 XML Web services 和客户端应用程序之间的交互。这种结构可能与您自己创建的应用程序所需的结构不完全一样。有关其他安全模型和结构的更多信息

系统要求

若要完成本演练，您需要：

对具有 Pubs SQL Server 示例数据库、配置了集成 Windows 身份验证的服务器的访问权限。Pubs 数据库是可以与 SQL Server 一起安装的示例数据库之一。
基本了解在 Visual Studio .NET 中数据是如何处理的。

分布式应用程序的创建过程

开发分布式应用程序的一个可能的方案是一次创建一层，多半是从数据层开始，然后移到中间层业务规则对象，最后创建用户界面层。在本演练中，已经生成了数据，它们可用于 SQL Server 中的 Pubs 数据库。因此，本演练将从创建业务对象，即 XML Web services 开始，然后生成两个用户界面：Web 窗体页和 Windows 窗体。

本演练的过程如下：

创建中间层业务对象

您创建的业务对象将在 Web 服务器上运行，提供分布式应用程序所需的性能和可伸缩性。另外，您将把业务对象实现为 XML Web services，这样客户端可以使用标准 Internet 协议从任何平台与您的业务对象进行通信。

在本演练中，XML Web services 组件将保存数据连接和数据集定义。然后将添加 XML Web services 方法以公开此数据集，这使其他应用程序能够查看和修改此数据集。

ASP.NET Web 服务项目模板是基于 Web 的项目，旨在创建将其自身的接口公开为 XML Web services 的中间层组件。

XML Web services 将公开两个方法。第一个方法 GetAuthors 将从数据库返回数据集。第二个方法 UpdateAuthors 将用用户的更改更新数据库。创建了若干私有成员来实现这些方法。它们包括数据集定义、数据适配器、数据连接和若干从数据库中检索数据和更新数据库的命令对象。下面的关系图描述了 XML Web services。

分布式应用程序的中间层

创建 ASP.NET Web 服务项目

在“文件”菜单上，指向“新建”，然后单击“项目”以显示“新建项目”对话框。
根据要使用的语言，在“项目类型”窗格中选择“Visual Basic 项目”或“Visual C# 项目”，然后在“模板”窗格中选择“ASP.NET Web 服务”。
在“位置”框中，输入 Web 服务器（在您的开发计算机上）的名称和项目名称 http://ServerName/AuthorsWebService，然后单击“确定”。
提示如果 Web 服务器位于您的计算机上，则可以使用服务器名称 LOCALHOST。

提示如果在创建 ASP.NET Web 服务项目方面有困难
项目 AuthorsWebService 就添加到解决方案中。Service1.asmx 的“组件设计器”出现在开发环境中。
在解决方案资源管理器中，双击 Service1.asmx 以选择它。
在“属性”窗口中，将 Service1 的 Name 属性设置为 AuthorsService。
在解决方案资源管理器中，右击 Service1.asmx 文件，选择“重命名”，将此文件重命名为 AuthorsService.asmx，以便与服务名相匹配。
在此组件中，您将创建与数据存储区的连接并通过数据集获取数据实例。

创建和配置数据库连接和数据集架构

您将向 XML Web services 添加两个对象：一个 SqlDataAdapter 对象和一个 SqlConnection 对象。连接对象创建到数据库的新连接，而数据适配器则查询数据库并将结果发送到 DataSet 对象中。数据适配器还用用户对数据集所做的更改来更新数据库。通过使用这个到数据库的连接，将创建一个数据集来保存在数据库中存在的信息的实例。此数据集稍后将在本演练中用来显示 Windows 窗体和 Web 窗体页中的数据。

创建数据库连接和数据适配器

单击服务器资源管理器。
注意默认情况下，服务器资源管理器在开发环境的左侧显示为一个垂直选项卡。如果看不到此选项卡，请单击“视图”菜单，然后选择“服务器资源管理器”。
在服务器资源管理器中，右击“数据连接”节点，然后从快捷菜单中选择“添加连接”。
在“数据链接属性”对话框的“连接”选项卡中，输入安装有 pubs 数据库的 SQL Server 的名称。如果在本地计算机上有 SQL Server，请输入 (local)。
为登录信息选择“使用 Windows NT 集成安全设置”。
注意如果在您的系统上没有设置集成安全性，请与网络管理员联系。
从列表中选择 pubs 数据库。
单击“测试连接”验证您提供的信息，然后单击“确定”建立连接。
一个新节点出现在服务器资源管理器的“数据连接”节点中。
注意如果数据库连接失败，请与数据库管理员联系。
在服务器资源管理器中，展开新连接节点的节点，然后展开“表”节点。
找到 authors 节点并展开它以显示 authors 表中的字段。
使用 CTRL+鼠标单击，选择 au_id、au_lname、au_fname 和 city 字段。
将这些字段从服务器资源管理器拖放到设计图面上。SqlConnection 对象与 SqlDataAdapter 对象在设计器中成对出现。现在已建立了到数据库的连接，信息传输将由 SqlDataAdapter 对象处理。这些组件被配置为将包含 authors 表的数据集移入和移出数据库。
注意本演练使用 SqlDataAdapter 对象，此对象已针对使用 SQL Server 7.0 或更高版本进行了优化。也可以使用 OleDbDataAdapter 对象，这是因为它更通用，并提供对任何与 OLE DB 兼容数据源的 ADO.NET 访问权。如果要连接的数据库不是 SQL Server 数据库，则项目系统会创建一个 OleDbDataAdapter 对象和一个 OleDbConnection 对象。

注意在本演练中，已使用 authors 表中的一些列和所有的行填充了数据集。在成品应用程序中，通常通过创建只返回所需列和行的查询来优化数据访问。
需要配置项目的安全设置以便使用集成安全性。通过关闭匿名访问并打开模拟来执行此操作。
配置集成 Windows 身份验证

若要为项目配置集成 Windows 身份验证，需要使用“Internet 信息服务”工具更改项目文件并配置项目。

启动“Internet 信息服务”工具。可以从“控制面板”的“管理工具”中运行它。（有关启动此工具的更多信息，请参见 Windows 帮助文档。）
展开服务器的节点。
展开“默认 Web 站点”节点。
右击 AuthorsWebService 的节点并从快捷菜单中选择“属性”。
单击“目录安全性”选项卡。
单击“匿名访问和身份验证控制”节中的“编辑”按钮。
清除“匿名访问”复选框。
选中“集成 Windows 身份验证”复选框。现在已配置了 XML Web services 目录。
返回 Visual Studio 中的项目，在解决方案资源管理器中双击 Web.config 文件。
在 <system.web> 标记后面的行中添加下面的标记，以便为 XML Web services 配置集成安全性。
```
<identity impersonate="true"/>
```

创建数据集类定义

在解决方案资源管理器中，双击 AuthorsService 文件以在设计器中打开它。
从“数据”菜单中选择“生成数据集”。在“生成数据集”对话框中，选择“新建”并将数据集命名为“authors1”。不要选中标记为“将此数据集添加到设计器”的框。
注意将创建数据集架构文件 authors1.xsd 并将其添加到项目中。此架构文件包含 authors1 的类定义。该类（从 DataSet 类继承）包含 authors 表的类型化数据集定义。
从“文件”菜单中，选择“全部保存”。

从业务对象中公开 authors1 数据集

本演练的下一步是从业务对象公开刚创建的数据集对象。此操作使数据集可供 Windows 或 Web 应用程序使用。

将方法添加到 XML Web services

在解决方案资源管理器中，如果还没有在设计器中打开 AuthorsService，请双击它。
在“视图”菜单上单击“代码”。
添加一个名为 GetAuthors 的方法以向客户端传递一个数据集。
如下所示，此方法创建一个新的 authors1 数据集，并根据 authors 表使用 SqlDataAdapter 对象填充该数据集。然后此方法返回数据集。
```
// C#
    [WebMethod]
    public authors1 GetAuthors()
    {
    authors1 authors = new authors1();
    sqlDataAdapter1.Fill(authors);
    return authors;
    }
```
添加名为 UpdateAuthors 的方法，以便将更改从客户端传递回数据库。
如下所示，此方法有一个 authors1 数据集参数 (authorChanges)，该参数包含已更改的数据并通过 SqlDataAdapter.Update 方法更新数据库。Update 方法接受数据集中的更改。数据集返回给客户端。客户端然后用这个返回的数据集更新它自己的 authors1 数据集实例。有关 Update 方法和如何接受数据集更改的信息
```
// C#
    [WebMethod]
    public authors1 UpdateAuthors(authors1 authorChanges)
    {
    if (authorChanges != null)
    {
    sqlDataAdapter1.Update(authorChanges);
    return authorChanges;
    }
    else
    {
    return null;
    }
    }
```
注意在成品应用程序中，将向这些方法添加错误检查和异常处理功能。
从“文件”菜单中，选择“全部保存”。
从“生成”菜单中，选择“生成解决方案”。

在上一节中，您创建了一个中间层业务对象，该对象包含绑定到 SQL Server 数据库的数据集。您向中间层 AuthorsWebService XML Web services 中添加了代码，以便从数据源获取数据并用更改更新数据源。客户端通过 GetAuthors 和 UpdateAuthors XML Web services 方法访问这些函数。

创建用户界面

创建了用于数据访问的中间层业务对象并将其公开为 XML Web services 后，下一步是创建客户端界面。本演练中有两个方案：传统的 Windows 窗体和 Web 窗体页。两个方案在此示例中被创建为同一解决方案中的不同项目。

Windows 用户界面选项

Windows 界面使用客户机的功能来处理部分应用程序处理工作。通常，Windows 界面比基于 Web 的界面提供更完善的功能和更丰富的用户操作。服务器上的负载比 Web 前端的负载少，这是因为服务器不必执行所有的应用程序逻辑。另外，Windows 界面可以利用通过操作系统可用的资源，包括对文件系统和注册表的调用。

下列关系图突出显示要实现的客户端。

分布式应用程序中的 Windows 客户端

Windows 应用程序（由一个窗体 Windows 窗体组成）将包含一个对 AuthorsWebService 的 Web 引用。单击窗体上的“Load”（加载）按钮时，数据库中的数据将显示在 DataGrid 控件中。这一加载行为是通过调用 XML Web services 的 GetAuthors 方法实现的。DataGrid 控件允许直接编辑，并将数据更改直接传递到基础数据集。此窗体还会有一个“Save”（保存）按钮。此按钮的代码将调用 XML Web services 的 UpdateAuthors 方法，以便将更改保存回数据库。

创建 Windows 应用程序

在“文件”菜单上，指向“添加项目”，然后单击“新建项目”以打开“添加新项目”对话框。
根据要使用的语言，在“项目类型”窗格中选择“Visual C# 项目”或“Visual Basic 项目”，然后在“模板”窗格中选择“Windows 应用程序”。
将项目命名为 AuthorsWinClient，并为该项目选择一个位置。
AuthorsWinClient 项目随即添加到解决方案中。Form1 自动添加到项目中并且出现在 Windows 窗体设计器中。
为前面创建的 ASP.NET Web 服务项目添加 Web 引用：
1. 在解决方案资源管理器中，右击 AuthorsWinClient 项目，然后单击快捷菜单上的“添加 Web 引用”。
2. 在“添加 Web 引用”对话框顶部的“URL”框中，输入 XML Web services 项目的位置 (http://ServerName/AuthorsWebService/AuthorsService.asmx)，然后按 ENTER 键。如果在添加 Web 引用方面有困难
3. 单击“添加引用”。
4. 现在可以在应用程序中创建 authors1 数据集的实例。

将控件添加到窗体

从“工具箱”的“Windows 窗体”选项卡中将 DataGrid 控件拖到窗体上。
从“工具箱”的“Windows 窗体”选项卡中将 Button 控件拖到窗体上。将此按钮的 Name 属性设置为 LoadData，将它的 Text 属性设置为 Load。
从“工具箱”的“Windows 窗体”选项卡中将另一个 Button 控件拖到窗体上。将此按钮的 Name 属性设置为 SaveData，将它的 Text 属性设置为 Save。
从工具箱的“数据”选项卡中将 DataSet 对象拖到窗体上。出现“添加数据集”对话框。选择“类型化数据集”并从“名称”列表中选择“AuthorsWinClient.ServerName.authors1”。此操作将在组件栏中创建一个基于 authors1 数据集类定义的 DataSet 对象。
选择 DataSet 控件并将 Name 属性设置为 AuthorData。
选择 DataGrid 控件并从 DataSource 属性列表中选择 AuthorData。从 DataMember 属性列表中选择 authors。DataGrid 的列标题被设置为 authors 表的列名称。

为 LoadData 和 SaveData 按钮添加代码

在“视图”菜单上单击“设计器”。双击 LoadData 按钮为 Click 事件创建一个空事件处理程序。调用 XML Web services 方法的方法是先创建服务类的一个实例，然后调用服务方法。在这种情况下，调用 GetAuthors 方法。返回的数据集会与 AuthorData 数据集合并，XML Web services 的 Credentials 属性用于将您的身份传递给 XML Web services，该服务接着将它传递给数据库服务器。将如下所示的代码添加到方法中。
注意如果 XML Web services 不是在本地计算机上运行的，则需要用运行 XML Web services 的服务器名称替换代码示例中的 localhost。
```
/ C#
    private void LoadData_Click(object sender, System.EventArgs e)
    {
    AuthorsWinClient.localhost.AuthorsService ws =
    new AuthorsWinClient.localhost.AuthorsService();
    ws.Credentials = System.Net.CredentialCache.DefaultCredentials;
    AuthorData.Merge(ws.GetAuthors());
    }
```
在“视图”菜单上单击“设计器”。双击 SaveData 按钮为 Click 事件创建一个空事件处理程序。
如果数据集有改动，则将创建一个 authors1 类型的新数据集来仅保存更改的数据。然后，此数据集被传递到 XML Web services 的 UpdateAuthors 方法。此数据集与接受的更改一起返回，并且更新 AuthorData 数据集以反映这些新的更改。
注意在成品应用程序中，将需要在这一步中考虑数据并发问题。

将以下代码添加到方法中：

// C#
    private void SaveData_Click(object sender, System.EventArgs e)
    {
    if (AuthorData.HasChanges())
    {
    AuthorsWinClient.localhost.AuthorsService ws =
    new AuthorsWinClient.localhost.AuthorsService();
    ws.Credentials = System.Net.CredentialCache.DefaultCredentials;
    AuthorsWinClient.localhost.authors1 diffAuthors
    = new AuthorsWinClient.localhost.authors1();
    diffAuthors.Merge(AuthorData.GetChanges());
    diffAuthors = ws.UpdateAuthors(diffAuthors);
    AuthorData.Merge(diffAuthors);
    }
    }

运行应用程序

从“文件”菜单中，选择“全部保存”。
在解决方案资源管理器中选择“AuthorsWinClient”，右击并选择“设为启动项目”。
按 CTRL+F5 以运行应用程序。
显示出一个窗口，其中包含一个空表，表的标头来自 pubs 数据库中的 authors 表。
单击“加载”填充此表，做一些更改，然后单击 Save 保存所做的更改。

在上一节中，您在解决方案中添加了一个 Windows 窗体项目作为 Windows 界面。将 Windows 窗体连接到了在第一节中创建的 XML Web services，并使用 DataGrid 和 Button 控件创建了用于加载和更新数据的用户界面。在下一节中，您将为解决方案创建基于 Web 的用户界面。

Web 用户界面选项

Web 界面有助于应用程序访问各种不同的客户机和浏览器。所有用户界面处理都在 Web 服务器上而不是在客户端完成。您将使用 Web 窗体页来创建一个 Web 界面，与上一节中创建的 Windows 界面一样，此界面访问同一个中间层业务对象。下列关系图突出显示要实现的客户端。

分布式应用程序中的 Web 客户端

创建 Web 窗体应用程序

在“文件”菜单上指向“添加项目”，然后单击“新建项目”。
在“添加新项目”对话框中，在“项目类型”窗格中选择“Visual C# 项目”或“Visual Basic 项目”，然后在“模板”窗格中单击“ASP.NET Web 应用程序”。
在“位置”框中，输入 Web 服务器（在您的开发计算机上）的名称和项目名称 http://ServerName/AuthorsWebClient，然后单击“确定”。
新项目添加到解决方案资源管理器。一个名为 WebForm1.aspx 的 Web 窗体页添加到项目中并加载到设计器中。
为前面创建的 ASP.NET Web 服务项目添加 Web 引用：
1. 在解决方案资源管理器中，右击 AuthorsWebClient 项目，然后单击快捷菜单上的“添加 Web 引用”。
2. 在“添加 Web 引用”对话框顶部的“URL”框中，输入 XML Web services 项目的位置 (http://ServerName/AuthorsWebService/AuthorsService.asmx)，然后按 ENTER 键。
3. 单击“添加引用”。
4. 现在可以在应用程序中创建 authors1 数据集的实例。

将控件添加到 Web 页

从工具箱的“数据”选项卡中将 DataSet 对象拖到窗体上。出现“选择数据集”对话框。选择“TypedDataSet”并从“名称”列表中选择“AuthorsWebClient.ServerName.authors1”。一个 DataSet 对象被添加到组件栏中。
选择 DataSet 对象并将 Name 属性设置为 AuthorData。
从“工具箱”的“Web 窗体”选项卡中将 DataGrid 控件拖到窗体上。
在 DataGrid 控件的“属性”窗口中，将 DataSource 属性设置为 AuthorData，将 DataMember 属性设置为 authors。这些设置出现在这些控件的下拉列表中。DataGrid 的列标题被设置为 authors 表的列名称。
若要支持在 DataGrid 控件中就地编辑，需要添加一个“编辑、更新、取消”列，该列将包含一个“编辑”按钮。当用户单击此“编辑”按钮时，该行的内容将显示在文本框中，并且“编辑”按钮将被“更新”和“取消”按钮替换。添加此列的方法是：
1. 单击“属性”窗口底部的“属性生成器”链接，然后选择对话框中的“列”选项卡。
2. 在“可用列”窗格中展开“按钮列”项。
3. 选择“编辑、更新、取消”，然后单击 () 按钮。
4. 单击“确定”。

为“编辑”、“更新”和“取消”按钮添加代码

右击窗体并选择“查看代码”。在 Page_Load 事件中添加填充 DataGrid 控件的代码，如下所示。这些代码创建 XML Web services 的实例，填充 AuthorData 数据集，并将此数据集绑定到 DataGrid 控件。每当页在往返过程后返回用户时，网格都将包含来自数据库中数据的全新副本。XML Web services 的 Credentials 属性用于将您的身份传递给 XML Web services，该服务接着将它传递给数据库服务器。
注意   在本演练中，每当 Web 窗体页下载到客户端浏览器时，都会从数据库中检索 authors 表的新副本。这可能不能提供最佳性能。

// C#
private void Page_Load(object sender, System.EventArgs e)
{
   AuthorsWebClient.localhost.AuthorsService ws =
      new AuthorsWebClient.localhost.AuthorsService();
   ws.Credentials = System.Net.CredentialCache.DefaultCredentials;
   AuthorData.Merge(ws.GetAuthors());
   if (! Page.IsPostBack)
   {
      DataGrid1.DataBind();
   }
}
当用户单击“编辑”按钮时，将引发 DataGrid 控件的 EditCommand 事件。使用此事件更改 DataGrid 控件的 EditItemIndex 属性。EditItemIndex 属性指定的行将与所有数据一起显示在文本框中。
1. 为 EditCommand 事件创建事件处理程序。
  在 Visual Basic 中，右击页并选择“查看代码”。在代码编辑器的左下拉框中选择 DataGrid1。在右下拉框中选择“EditCommand”。
  - 或 -
  在 Visual C# 中，单击 DataGrid1 控件。在“属性”窗口中，单击“事件”按钮以显示 DataGrid 事件的列表。双击 EditCommand 事件。
2. 如下所示添加代码。
  // C#
  private void DataGrid1_EditCommand(object source,
  System.Web.UI.WebControls.DataGridCommandEventArgs e)
  {
  DataGrid1.EditItemIndex = e.Item.ItemIndex;
  DataGrid1.DataBind();
  }
为 CancelCommand 事件创建事件处理程序。（有关添加事件处理程序的信息，请参见第 2 步。）
当用户单击“取消”按钮时，将引发 DataGrid 控件的 CancelCommand 事件。使用此事件将 EditItemIndex 属性设置为 -1，以便将当前行再次显示为文本。如下所示添加代码。
// C#
private void DataGrid1_CancelCommand(object source,
System.Web.UI.WebControls.DataGridCommandEventArgs e)
{
DataGrid1.EditItemIndex = -1;
DataGrid1.DataBind();
}
当用户单击“更新”按钮时，将引发 DataGrid 控件的 UpdateCommand 事件。该方法负责用 DataGrid 控件中的更改更新 AuthorData 数据集，并通过 XML Web services 将这些更改传递回数据库。为 UpdateCommand 事件创建事件处理程序。（有关添加事件处理程序的信息，请参见第 2 步。）如下所示添加代码。
// C#
private void DataGrid1_UpdateCommand(object source,
System.Web.UI.WebControls.DataGridCommandEventArgs e)
{
   // Change the data in the dataset.
   for (int i=1; i <= AuthorData.authors.Columns.Count; i++)
   {
      TextBox t = (TextBox)(e.Item.Cells[i].Controls[0]);
      DataRow row = AuthorData.authors[e.Item.DataSetIndex];
      row[AuthorData.authors.Columns[i-1].Caption] = t.Text;
   }

   // Update the database.
   if (AuthorData.HasChanges())
   {
      AuthorsWebClient.localhost.AuthorsService ws =
         new AuthorsWebClient.localhost.AuthorsService();
      ws.Credentials = System.Net.CredentialCache.DefaultCredentials;
      AuthorsWebClient.localhost.authors1 diffAuthors =
         new AuthorsWebClient.localhost.authors1();
      diffAuthors.Merge(AuthorData.GetChanges());
      ws.UpdateAuthors(diffAuthors);
      AuthorData.Merge(diffAuthors);
   }
   DataGrid1.EditItemIndex = -1;
   DataGrid1.DataBind();
}

需要配置项目的安全设置以便使用集成安全性。通过关闭匿名访问并打开模拟来执行此操作。

配置集成 Windows 身份验证