实现带有用户身份验证的文件传输Web Service（1）

 

一、 理解Web Service
  
  　　首先让我们简单理解一下Web Service。
  
  　　Web services 实际上是基于XML的针对商业、应用程序的系统服务。实际上是建立在一系列已有的技术基础上的一个新的概念。使用它如同使用RPC（远程过程调用），不过它提供的接口是基于对象的。它与原有的组件模型，如com/dcom,corba,rmi等，最大的特点就是标准化（基于XML的一系列标准）带来的跨平台的通用性，基于http带来的畅通无阻的能力（跨越防火墙），对于Dot Net来说，配合Visual Studio.Net其中的Web Service还具有易用性的特点。用户即便不懂那些相关标准，只要会面向对象变成，对Web Service有个初步的了解就可以动手写Web Service了。
  
  　　如何建立一个Web service呢？下面的技术步骤获得了工业界普遍认同。
  
  　　1.服务提供者建立、组织和发布网络服务。它的手段是多样的，可以使用编程语言（例如Delphi，Java，C#等）、中间件或其它特殊平台来完成。
  
  　　2.服务提供者用WSDL (the Web Services Description Language )来提供服务描述。. WSDL文档向第三方提供服务描述。
  
  　　3.服务提供者向UDDI (Universal Description, Discovery, and Integration ) 注册表注册网络服务。UDDI使得开发者发布服务并且可以通过软件搜索其它人提供的服务。 用户将通过搜索UDDI 注册表来搜索服务。
  
  　　4. 客户端应用程序通过和网络服务绑定并且通过SOAP (the Simple Object Access Protocol )来激活网络服务相应的操作。SOAP 提供XML格式的参数和返回结果，并利用HTTP传送。所有网络服务都通过SOAP通讯。
  
  　　上面的第一步是核心，它决定了你的Web Service的用途和接口。第二步在Visual Studio.Net中被自动完成，大家当然也可以用WSDL.exe手动生成。第四步在客户端编程时Visual Studio提供了最大的便利。用户只要使用” Add Web Service Reference”或者“添加Web服务引用”（中文版），敲入网址，Visual Studio.Net就会自动生成调用Web Service的类，底层的SOAP对用户完全透明。
  
  　　但是，当用户需要考虑安全性时就不得不考虑一下soap了。记住，安全性是将来必须考虑的，在将来软件开发变为配置集成，软件产品变为服务，购买软件变为租用软件，大部分服务都基于网络时，你可能得考虑谁可以用你的服务，谁不可以用你的服务了，当然，我也比较赞同开放源代码和公开交流技术，我把自己辛苦钻研出来的东西写出来也表明了我的态度。但是，毕竟，我们还是要靠写软件吃饭的:)
  
  　　在web service中，用户名，密码可以通过soap头(soap header)进行传送。在web service的编写中，需要对soap头进行处理，不过这也不太难，大家认识到这一点然后看我下面的例子就可以学会如何利用它了。

 

 

 

 

 

 

 

 

 

 

实现带有用户身份验证的文件传输Web Service(2)

二、 代码实现
  
  　　首先，我们实现一个用于身份验证的类，文件名Authentication.cs为代码如下：
  
  using System;
  
  namespace useResData
  
  {
  
  　///
  
  　///实现带有用户身份验证的文件传输Web Service
  
  　///
  
  　public class Authentication: System.Web.Services.Protocols.SoapHeader
  
  　{
  
  　　public string Username;
  
  　　public string Password;
  
  　　public Boolean ValidUser(string in_Username,
  
  　　string in_Password)
  
  　　{
  
  　　　if((in_Username == "caomo") && (in_Password == "password"))
  
  　　　　{
  
  　　　　　return true;
  
  　　　　}
  
  　　　else
  
  　　　{
  
  　　　　return false;
  
  　　　}
  
  　　}
  
  　　public Authentication()
  
  　　{
  
  　　//
  
  　　// TODO: Add constructor logic here
  
  　　//
  
  　　}
  
  　}
  
  }
  
  　　Authentication类继承自System.Web.Services.Protocols.SoapHeader。且定义了两个成员变量，Username和Password，还定义了一个用户认证的函数ValidUser。它提供了对Username和Password检查的功能，你可以把它写得很复杂，诸如通过访问数据库来检查用户的有效性。我在这里只是简单检查了固定值的相等性。

 

 

 

 

 

 

 

 

 

实现带有用户身份验证的文件传输Web Service(3)

下面我们生成一个web service，起名叫FileServer,在FileServer.asmx中有如下代码：
  
  ＜%@ WebService Language="c#" Codebehind="FileServer.asmx.cs" Class="useResData.FileServer" %＞
  
  　　大家可以看到Codebehind技术是如何被使用的。在Visual Studio.Net中，自动生成的代码大量使用这样的语句。它使得设计页面和编写代码被划分开了。
  
  　　在FileServer.asmx.cs中，代码如下：
  
  using System;
  
  using System.Collections;
  
  using System.ComponentModel;
  
  using System.Data;
  
  using System.Diagnostics;
  
  using System.Web;
  
  using System.Web.Services;
  
  using System.IO;
  
  namespace useResData
  
  {
  
  　///
  
  　/// Summary description for FileServer.
  
  　///
  
  　public class FileServer : System.Web.Services.WebService
  
  　{private string rootdir;
  
  　　public FileServer()
  
  　　{
  
  　　//CODEGEN: This call is required by the ASP.NET Web Services Designer
  
  　　InitializeComponent();
  
  　　rootdir=Server.MapPath("/caomo/提供传输的文件");
  
  　　}
  
  
  
  　　#region Component Designer generated code
  
  　　///
  
  　　/// Required method for Designer support - do not modify
  
  　　/// the contents of this method with the code editor.
  
  　　///
  
  　　private void InitializeComponent()
  
  　　{
  
  　　}
  
  　　#endregion
  
  　　///
  
  　　/// Clean up any resources being used.
  
  　　///
  
  　protected override void Dispose( bool disposing )
  　
  　{
  
  　}
  
  　public Authentication header; //定义用户身份验证类变量header。
  
  　　[WebMethod(Description="need authentication!")]
  
  　　[System.Web.Services.Protocols.SoapHeader("header")]
  　　 //用户身份验证的soap头
  
  　public string GetFile(string filePath)
  
  　{
  
  　　if (header.ValidUser(header.Username,header.Password)) //用户身份验证
  
  　　{
  
  　　　FileStream myfile=File.OpenRead(rootdir+filePath);
  
  　　　BinaryReader br=new BinaryReader(myfile);
  
  　　　byte[] btBuf=new byte[myfile.Length];
  
  　　　long i=0;
  
  　　　while (br.PeekChar()>-1)
  
  　　　{
  
  　　　　btBuf[i]=br.ReadByte();
  
  　　　　i++;
  
  　　　}
  
  　　　myfile.Close();
  
  　　　return System.Convert.ToBase64String(btBuf);
  
  　　}
  
  　　else return null;//用户身份验证failed
  
  　}
  
  　　运行它。将会得到如图1所示页面：
  
  
  图 1
  
  　　大家应该注意到名为GetFile的服务是我给的代码中的Web Method，下面的“need authentication!”是由WebMethod定义中的Description="need authentication!"给出的。

 

 

实现带有用户身份验证的文件传输Web Service(4)

下面点击“GetFile”我们进入下一页，大家看到如图2所示页面，是不是与一般的web服务调用页面不一样？
  
  
  　　　　　　　　　　　图 2
  
  　　为了让大家看到带有用户验证和没有用户验证的区别，我们可以把带有用户身份验证的注释的代码行注释掉或删掉，大家进入的同一个页面会如图3所示：
  
  
  　　　　　　　　　　　　　　　　　图 3
  
  　　大家可以看到，没有验证功能时，可以通过IE自动生成的调用页面直接用http get实现调用，返回的结果是一个xml文件（soap响应文件）。如图4所示：
  
  
  　　　　　　　　　　　　　　　　　图 4
  
  　　文件被编码返回了，看看水平滚动条吧，这个文件的编码全在一行中。
  
  　　ok,就到此为止吧，至于文件传输部分的代码我就不多做解释了，值得注意的是，这个文件传输函数对文本形式的文件传输支持得很好，对二进制文件当大小大于4k时就会出现缓冲区溢出，如果谁有更好的办法不妨与作者 caomo@chinaren.com 联系。
  
  　　最后，关于客户端如何编写的问题，呵呵，由于作者时间有限，且听下回分解。大家可以先试试自己做