以文本方式查看主题

-  中文XML论坛 - 专业的XML技术讨论区  (http://bbs.xml.org.cn/index.asp)
--  『 Dot NET,C#,ASP,VB 』  (http://bbs.xml.org.cn/list.asp?boardid=43)
----  <展现 C#> (rainbow 翻译)- 第八章 用C#写组件  (http://bbs.xml.org.cn/dispbbs.asp?boardid=43&rootid=&id=11712)


--  作者:admin
--  发布时间:11/9/2004 2:25:00 AM

--  <展现 C#> (rainbow 翻译)- 第八章 用C#写组件


发信人: wuxq (很想好好休息), 信区: DotNET        
标  题: <展现 C#> (rainbow 翻译)- 第八章 用C#写组件
发信站: BBS 水木清华站 (Mon Apr 30 13:52:06 2001)

第八章    用C#写组件
    这一章关于用C#写组件。你学到如何写一个组件,如何编译它,且如何在一个客户
程序中使用它。更深入一步是运用名字空间来组织你的应用程序。
    这章由两个主要大节构成:
    。你的第一个组件
    。使用名字空间工作
8.1  你的第一个组件
    到目前为止,在本书中提到的例子都是在同一个应用程序中直接使用一个类。类和
它的使用者被包含在同一个执行文件中。现在我们将把类和使用者分离到组件和客户,
它们分别位于不同的二进制文件中(可执行文件)。
    尽管你仍然为组件创建一个 DLL,但其步骤与用C++写一个COM组件差别很大。你很
少涉及到底层结构。以下小节说明了如何构建一个组件以及使用到它的客户:
    。构建组件
    。编译组件
    。创建一个简单的客户应用程序
8.1.1  构建组件
    因为我是一个使用范例迷,我决定创建一个相关Web的类,以方便你们使用。它返回
一个Web网页并储存在一个字符串变量中,以供后来重用。所有这些编写都参考了.NET框
架的帮助文档。
    类名为RequestWebPage;它有两个构造函数——  一个属性和一个方法。属性被命
名为URL,且它储存了网页的Web地址,由方法GetContent返回。这个方法为你做了所有
的工作(见清单8.1)。
    清单 8.1   用于从Web服务器返回HTML网页的RequestWebPage 类
1: using System;
2: using System.Net;
3: using System.IO;
4: using System.Text;
5:
6: public class RequestWebPage
7: {
8:  private const int BUFFER_SIZE = 128;
9:  private string m_strURL;
10:
11:  public RequestWebPage()
12:  {
13:  }
14:
15:  public RequestWebPage(string strURL)
16:  {
17:   m_strURL = strURL;
18:  }
19:
20:  public string URL
21:  {
22:   get { return m_strURL; }
23:   set { m_strURL = value; }
24:  }
25:  public void GetContent(out string strContent)
26:  {
27:   // 检查 URL
28:   if (m_strURL == "")
29:    throw new ArgumentException("URL must be provided.");
30:
31:  WebRequest theRequest = (WebRequest) WebRequestFactory.Create(m_strURL)
;
32:   WebResponse theResponse = theRequest.GetResponse();
33:
34:   // 给回应设置字节缓冲区
35:   int BytesRead = 0;
36:   Byte[] Buffer = new Byte[BUFFER_SIZE];
37:
38:   Stream ResponseStream = theResponse.GetResponseStream();
39:   BytesRead = ResponseStream.Read(Buffer, 0, BUFFER_SIZE);
40:
41:   //使用 StringBuilder  以加速分配过程
42:   StringBuilder strResponse = new StringBuilder("");
43:   while (BytesRead != 0 )
44:   {
45:    strResponse.Append(Encoding.ASCII.GetString(Buffer,0,BytesRead));
46:    BytesRead = ResponseStream.Read(Buffer, 0, BUFFER_SIZE);
47:   }
48:
49:   // 赋给输出参数
50:   strContent = strResponse.ToString();
51:  }
52: }
    本应该利用无参数构造函数完成工作,但我决定在构造函数中初始化URL,这可能会
很有用。当后来决定要改变URL时——为了返回第二个网页,例如,通过URL属性的get和
set访问标志使它被公开了。
    有趣的事始于GetContent方法。首先,代码对URL实行十分简单的检查,如果它不适
合,就会引发一个ArgumentException 异常。之后,我请求WebRequestFactory ,以创
建一个基于传递给它的URL的WebRequest对象。
    因为我不想发送cookies、附加头和询问串等,所以立即访问WebResponse(第32行
)。如果你需要请求上述任何的功能,必须在这一行之前实现它们。
    第35和36行初始化一个字节缓冲区,它用于从返回流中读数据。暂时忽略StringBu
ilder 类,只要返回流中仍然有要读的数据,while循环就会简单地重复。最后的读操作
将返回零,因此结束了该循环。
    现在我想回到StringBuilder类。为什么用这个类的实例而不是简单地把字节缓冲区
合并到一个字符串变量?看下面这个例子:
    strMyString = strMyString + "some more text";
    这里很清楚,你正在拷贝值。常量 "some more text" 以一个字符串变量类型被加
框,且根据加法操作创建了一个新的字符串变量。接着被赋给了 strMyString。有很多
次拷贝,是吗?
    但你可能引起争论
    strMyString += "some more text";
    不要炫耀这种行为。对不起,对于C#这是一个错误的答案。其操作完全与所描述的
赋值操作相同。
    不涉及该问题的另外的途径是使用StringBuilder类。它利用一个缓冲区进行工作,
接着,在没有发生我所描述的拷贝行为的情况下,你进行追加、插入、删除和替换操作
。这就是为什么我在类中使用它来合并那些读自缓冲区中的内容。
    该缓冲区把我带进了这个类中最后重要的代码片段——第45行的编码转换。它只不
过涉及到我获得请求的字符集。
    最后,当所有的内容被读入且被转换时,我显式地从 StringBuilder请求一个字符
串对象并把它赋给了输出变量。一个返回值仍然会导致另外的拷贝操作。
8.1.2  编译组件
    到目前为止,你所做的工作与在正常应用程序的内部编写一个类没有什么区别。所
不同的是编译过程。你必须创建一个库而不是一个应用程序:
    csc /r:System.Net.dll /t:library /out:wrq.dll webrequest.cs
    编译开关/t:library  告诉C#编译,要创建一个库而不是搜寻一个静态 Main方法。
同样,因为我正在使用 System.Net名字空间,所以必须引用 (/r:)它的库,这个库就是
System.Net.dll。
    你的库命名为 wrq.dll,现在它准备用于一个客户应用程序。因为在这章中我仅使
用私有组件工作,所以你不必把库拷贝到一个特殊的位置,而是拷贝到客户应用程序目
录。
8.1.3  创建一个简单的客户应用程序
    当一个组件被写成且被成功地编译时,你所要做的就是在客户应用程序中使用它。
我再次创建了一个简单的命令行应用程序,它返回了我维护的一个开发站点的首页(见
清单8.2)。
    清单 8.2    用 RequestWebPage 类返回一个简单的网页
1: using System;
2:
3: class TestWebReq
4: {
5:  public static void Main()
6:  {
7:   RequestWebPage wrq = new RequestWebPage();
8:   wrq.URL = "http://www.alphasierrapapa.com/iisdev/";
9:
10:   string strResult;
11:   try
12:   {
13:    wrq.GetContent(out strResult);
14:   }
15:   catch (Exception e)
16:   {
17:    Console.WriteLine(e);
18:    return;
19:   }
20:
21:   Console.WriteLine(strResult);
22:  }
成员
    注意,我已经在一个try catch语句中包含了对 GetContent的调用。其中的一个原
因是GetContent可能引发一个 ArgumentException异常。此外,我在组件内部调用的.N
ET框架类也可以引发异常。因为我不能在类的内部处理这些异常,所以我必须在这里处
理它们。
    其余的代码只不过是简单的组件使用——调用标准的构造函数,存取一个属性,并
执行一个方法。但等一下:你需要注意何时编译应用程序。一定要告诉编译器,让它引
用你的新组件库DLL:
    csc /r:wrq.dll wrclient.cs
    现在万事俱备,你可以测试程序了。输出结果会滚屏,但你可以看到应用程序工作
。使用了常规的表达式,你也可以增加代码,以解析返回的HTML,并依据你个人的喜好
,提取信息。我预想会使用到这个类新版本的SSL(安全套接字层),用于ASP+网页中的
在线信用卡验证。
    你可能会注意到,没有特殊的using 语句用于你所创建的库。原因是你在组件的源
文件中没有定义名字空间。
8.2  使用名字空间工作
    你经常使用到名字空间,例如System 和System.Net。C#利用名字空间来组织程序,
而且分层的组织使一个程序的成员传到另一个程序变得更容易。
    尽管不强制,但你总要创建名字空间,以清楚地识别应用程序的层次。.NET框架会
给出构建这种分层的良好思想。
    以下的代码片段显示了在C#原文件中简单的名字空间 My.Test(点号表示一个分层
等级)的声明:
namespace My.Test
{
  //这里的任何东西属于名字空间
}
    当你访问名字空间中的一个成员时,也有必要使用名字空间标识符完全地验证它,
或者利用using标志把所有的成员引入到你当前的名字空间。本书前面的例子演示了如何
应用这些技术。
    在开始使用名字空间之前,只有少数有关存取安全的词。如果你不增加一个特定的
存取修饰符,所有的类型将被默认为internal 。当你想从外部访问该类型时,使用 pu
blic 。不允许其它的修饰符。
    这是关于名字空间充分的理论。让我们继续实现该理论——以下小节说明了当构建
组件应用程序时,如何使用名字空间
    。在名字空间中包装类
    。在客户应用程序中使用名字空间
    。为名字空间增加多个类
8.2.1  在名字空间中包装类
    既然你知道了名字空间的理论含义,那么让我们在现实生活中实现它吧。在这个和
即将讨论到的例子中,自然选择到的名字空间是Presenting.CSharp。为了不使你厌烦,
仅仅是把RequestWebPage包装到Presenting.CSharp中,我决定写一个类,用于 Whois查
找(见清单8.3)。
    清单 8.3   在名字空间中实现 WhoisLookup类
1: using System;
2: using System.Net.Sockets;
3: using System.IO;
4: using System.Text;
5:
6: namespace Presenting.CSharp
7: {
8: public class WhoisLookup
9: {
10:  public static bool Query(string strDomain, out string strWhoisInfo)
11:  {
12:   const int BUFFER_SIZE = 128;
13:
14:   if ("" == strDomain)
15:    throw new ArgumentException("You must specify a domain name.");
16:
17:   TCPClient tcpc = new TCPClient();
18:   strWhoisInfo = "N/A";
19:
20:   // 企图连接 whois  服务器
21:   if (tcpc.Connect("whois.networksolutions.com", 43) != 0)
22:     return false;
23:
24:   // 获取流
25:   Stream s = tcpc.GetStream();
26:
27:   // 发送请求
28:   strDomain += "\r\n";
29:   Byte[] bDomArr = Encoding.ASCII.GetBytes(strDomain.ToCharArray());
30:   s.Write(bDomArr, 0, strDomain.Length);
31:
32:   Byte[] Buffer = new Byte[BUFFER_SIZE];
33:   StringBuilder strWhoisResponse = new StringBuilder("");
34:
35:   int BytesRead = s.Read(Buffer, 0, BUFFER_SIZE);
36:   while (BytesRead != 0 )
37:   {
38:   strWhoisResponse.Append(Encoding.ASCII.GetString(Buffer,0,BytesRead));

39:   BytesRead = s.Read(Buffer, 0, BUFFER_SIZE);
40:   }
41:
42:   tcpc.Close();
43:   strWhoisInfo = strWhoisResponse.ToString();
44:   return true;
45:  }
46: }
47: }
    名字空间在第6行被声明,而且它用第7行和第47行的大括弧括住了WhoisLookup类。
要声明自己新的名字空间,实际要做的就是这些。
    在WhoisLookup类中当然具有一些有趣代码,特别是由于它说明了使用C#进行socke
t编程是多么的容易。在static Query method中经过 not-so-stellar域名检查之后,我
实例化了TCPClient类型的一个对象,它用来完成具有 Whois服务器的43端口上的所有通
讯。在第21行建立了服务器连接:
    if (tcpc.Connect("whois.networksolutions.com", 43) != 0)
    因为连接失败是预料到的结果,所以这个方法不能引发一个异常。(你还记住异常
处理的“要”和“不要”吗?) 返回值是一个错误代码,而返回零则说明连接成功。
    对于 Whois 查找,我必须首先发出一些信息给服务器——我要查找的域名。要完成
此项工作,首先获得一个引用给当前TCP连接的双向流(第25行)。接着附加上一个回车
/换行对 给域名,以表示询问结束。重新以字节数组打包,向Whois 服务器发送一个请
求(第30行)。
    余下的代码和RequestWebPage类极其相似。在该类中,我再次利用一个缓冲区从远
程服务器读入回应。当缓冲区完成读入后,连接被断开。返回的回应被转给了调用者。
我明确地调用 Close 方法的原因是我不想等待垃圾收集器毁坏连接。连接时间不要过长
,以免占用TCP端口这种稀有资源。
    在可以使用.NET 组件中的类之前,你必须把它作为一个库来编译。尽管现在有了一
个已定义的名字空间,该编译命令仍然没有变:
    csc /r:System.Net.dll /t:library /out:whois.dll whois.cs
    注意,如果你想该库按与C#源文件相同的方法命名,就没有必要规定 /out:开关。
规定该开关是一个良好的习惯,因为很多项目不会只由单个源文件组成。如果你规定了
多个源文件,该库以名单中的第一个命名。
8.2.2  在客户应用程序中使用名字空间
    由于你使用了名字空间开发组件,所以客户也要引入名字空间
    using Presenting.CSharp;
    或者给名字空间中的成员使用完全资格名(fully  qualified name),例如
    Presenting.CSharp.WhoisLookup.Query(...);
    如果你不期望在名字空间中引入的成员之间出现冲突,using  标志( directive)
是首选,特别是由于你具有很少的类型时。使用组件的客户程序样本在清单8.4中给出。

    清单  8.4  测试 WhoisLookup     组件
1: using System;
2: using Presenting.CSharp;
3:
4: class TestWhois
5: {
6:  public static void Main()
7:  {
8:   string strResult;
9:   bool bReturnValue;
10:
11:   try
12:   {
13:    bReturnValue = WhoisLookup.Query("microsoft.com", out strResult);
14:   }
15:   catch (Exception e)
16:   {
17:    Console.WriteLine(e);
18:    return;
19:   }
20:   if (bReturnValue)
21:    Console.WriteLine(strResult);
22:   else
23:    Console.WriteLine("Could not obtain information from server.");
24:  }
25: }
    第2行利用using 标志引入了Presenting.CSharp名字空间。现在,我无论什么时候
引用WhoisLookup ,都可以忽略名字空间的完全资格名了。
    该程序对 microsoft.com 域进行一次Whois 查找——你也可以用自己的域名代替m
icrosoft.com 。允许命令行参数传递域名,可使客户的用途更广。清单8.5 实现了该功
能,但它不能实现适当的异常处理(为了使程序更短)。
    清单  8.5  传递命令行参数给Query 方法
1: using System;
2: using Presenting.CSharp;
3:
4: class WhoisShort
5: {
6:  public static void Main(string[] args)
7:  {
8:   string strResult;
9:   bool bReturnValue;
10:
11:   bReturnValue = WhoisLookup.Query(args[0], out strResult);
12:
13:   if (bReturnValue)
14:    Console.WriteLine(strResult);
15:   else
16:    Console.WriteLine("Lookup failed.");
17:  }
18: }
    你所必须做的就是编译这个应用程序:
    csc /r:whois.dll whoisclnt.cs
    接着可以使用命令行参数执行该应用程序。例如,以 microsoft.com参数执行
    whoisclnt microsoft.com
    当查询运行成功时,就会出现 microsoft.com的注册信息。(清单8.6 显示了输出
的简略版本)  这是一个很方便的小程序,通过组件化的途径写成的,花不到一个小时
。如果用C++编写,要花多长时间?很幸运,我再也想不起当第一次用C++这样做时,花
了多长的时间。
    清单 8.6   有关 microsoft.com (简略) 的Whois 信息
D:\CSharp\Samples\Namespace>whoisclient
...
Registrant:
Microsoft Corporation (MICROSOFT-DOM)
  1 microsoft way
  redmond, WA 98052
  US
  Domain Name: MICROSOFT.COM
  Administrative Contact:
   Microsoft Hostmaster (MH37-ORG) msnhst@MICROSOFT.COM
  Technical Contact, Zone Contact:
   MSN NOC (MN5-ORG) msnnoc@MICROSOFT.COM
  Billing Contact:
   Microsoft-Internic Billing Issues (MDB-ORG)     msnbill@MICROSOFT.COM
  Record last updated on 20-May-2000.
  Record expires on 03-May-2010.
  Record created on 02-May-1991.
  Database last updated on 9-Jun-2000 13:50:52 EDT.
  Domain servers in listed order:
  ATBD.MICROSOFT.COM      131.107.1.7
  DNS1.MICROSOFT.COM      131.107.1.240
  DNS4.CP.MSFT.NET       207.46.138.11
  DNS5.CP.MSFT.NET       207.46.138.12
8.2.3  增加多个类到名字空间
    使WhoisLookup和RequestWebPage 类共存于同一个名字空间是多么的美妙。既然Wh
oisLookup已是名字空间的一部分,所以你只须使RequestWebPage 类也成为该名字空间
的一部分。
    必要的改变很容易被应用。你只需使用名字空间封装RequestWebPage 类就可以了:

namespace Presenting.CSharp
{
public class RequestWebPage
{
...
}
}
    尽管两个类包含于两个不同的文件,但在编译后,它们都是相同名字空间的一部分

    csc /r:System.Net.dll /t:library /out:presenting.csharp.dll whois.cs web
request.cs
    你不必要按照名字空间的名字给DLL命名。然而,这样做会有助你更容易你记住,当
编译一个客户应用程序时要引用哪一个库。
8.3  小结
    在这一章中,你学到了如何构建一个可以在客户程序中使用的组件。最初,你不必
关心名字空间,但后面第二个组件中介绍了该特性。名字空间在内外部均是组织应用程
序的好办法。
    C#中的组件很容易被构建,而且只要库和应用程序共存于相同的目录,你甚至不必
进行特殊的安装。当要创建必须被多个客户使用的类库时,步骤就有所改变——而下一
章将会告诉你为什么。

--

※ 来源:·BBS 水木清华站 smth.org·[FROM: 166.111.215.13]
上一篇
返回上一页
回到目录
回到页首
下一篇



W 3 C h i n a ( since 2003 ) 旗 下 站 点
苏ICP备05006046号《全国人大常委会关于维护互联网安全的决定》《计算机信息网络国际联网安全保护管理办法》
13,609.380ms