从NUnit中理解.NET自定义属性的应用

摘要

.NET的自定义属性可以实现程序集元数据扩展,并能为框架设计和实现提供新的思路和解决办法。NUnit即是一个很好的例子。

 

1.属性概述

.NET的元数据体系是.NET Framework的亮点之一。利用元数据可以对程序集、模块、类型、方法、成员等进行某种特性描述,而这些描述将作为元数据被编译到程序集中,并通过.NET运行环境为其调用者所使用。这也即元数据扩展。

属性(Attribute)的定义和使用是元数据扩展的主要内容。这包括对.NET标准属性的使用和自定义属性。

:“属性”是汉化MSDN对本文所讨论的概念—Attribute的翻译,我也习惯这么说。这好像很容易和OO中的“属性”混淆。有些同类讨论中,将此翻译为“标签”、“标记”,请注意区分。

也许开发者对属性还感觉比较陌生,对其如何发挥作用也没有什么感性认识。但其实在日常的开发中,.NET开发者来已经在大量使用.NET的标准属性。如:

当要引用某个传统动态连接库中的函数时,我们常用到DllImportAttribute标准属性来注释某个函数的原型:

[DllImport(“user32.dll”)]

public static extern int MessageBoxA(int p,string m,string h,int t);

//…

又比如,在编写Web Service时会使用到WebServiceAttributeWebMethodAttribute属性。[WebService][WebMethod]会在生成WSDL时发挥作用,为我们生成相应的Web Service描述,下面的代码片段开发者是多么的熟悉:

[WebMethod]

public string HelloWorld()

//…

这些属性直接对程序集中的类型或类型成员进行注释,并且这样的注释可以影响相应程序集的编译、逻辑、运行等。.NET Framework带有很多标准的属性,并在MSDN中有详细的文档。

 

2.自定义属性

属性也可以自定义,即自行开发属性,对属性进行某种格式的定义,并利用属性来影响开发者自己开发的程序集。这也是.NET元数据扩展最直接的应用了。自定义的属性在编译时作为元数据被编译到程序集中,在运行时可以利用反射机制(Reflection)被读取。

.NET中的属性是以一个类的形式来定义的。几乎所有的属性都继承自System.Attribute,开发者自定义属性也需首先继承自该抽象类。

 

1System.Attribute是所有属性的基类

 

自定义属性可以用于对程序集中的元素进行标记和描述,并被编译到.NET程序集中,成为其元数据的一部分。而从属性和属性值的读取就是对.NET程序集元数据的读取,这会用到反射机制。具体如何编写自定义属性和如何读取属性的例子在MSDN中有很多,不再冗述了。

 

3.属性的应用

属性的以上的特性往往在设计一些框架时很有用:利用反射机制,作为属性的元数据可以反过来在运行期影响代码的运行配置项,或者为特殊的操作方法作以属性作标记,以便在运行时做特殊处理。属性的另一个很有诱惑力的应用是,可以用于构建管理项目程序集的工具:属性表现为某种注释,而注释内容可以在编译后从程序集中读取出来,从而可以通过属性内容的注释和读取来实现对程序集中各类型、方法的管理了。

3.1 NUnit中的属性应用

先看看属性在框架设计中的应用吧!最典型的例子就是NUnit。在NUnit的框架设计中将自定义属性的特性、以及.NET的反射机制发挥得淋漓尽致。以一个简化了的测试案例(TestCase)为例:在测试时,NUnit需要让其中3种不同的函数依次运行如下:

首先前运行测试前的环境准备函数;然后是0~n个测试函数;最后是测试环境清理函数。熟悉NUnit的开发者都知道,在NUnitTestCase中分别使用[SetUp][Test][TearDown]属性来进行标记。如下例:

//一个NUnit测试程序集中代码

[SetUp]

public void Init()

//…

[TearDown]

public void Destroy()

//…

[Test]

public void TestXXX()

//…

NUnit框架在运行时要从待测试程序集中读取出上述函数,并且要保证上述3种不同的函数以正确的先后顺序被依次调用。NUnit是这样实现的:

首先是开发了一套属性,用来标记测试案例(TestCase)中各种函数,如:[SetUp][Test][TearDown]。(NUnit的属性标记并不止用来标记程序集中的函数,但限于篇幅,这里只在先前作的简化环境中讨论)

NUnit在运行时利用反射机制运行已经被编译成程序集的测试案例(TestCase)中的函数。NUnit框架中有一系列的函数来完成这项工作,这些函数只负责运行测试案例程序集中特定属性标记所标记的函数。如:InvokeSetUp()就负责运行标记有[SetUp]的函数;InvokeTestCase()负责运行标记有[Test]的函数,即测试案例;InvokeTearDown()负责运行标记有[TearDown]的函数。然后NUnit利用这几个InvokeXXX()函数的调用先后来保证这3种函数运行的先后顺序。

//From TemplateTestCase in NUnit.Core namespace

//用于执行测试的Run函数

public override void Run(TestCaseResult testResult )

{

   //…

try{

        //…

     InvokeSetUp();//首先运行标有[SetUp]标记的函数

     //…

InvokeTestCase();//然后是[Test]

//…

}

catch(…)

//…

finally {

  //…

        InvokeTearDown();//最后是[TearDown]标记的函数

//…

}

//…

}

InvokeXXX()函数则利用反射机制运行相关函数,可以看看以下几个代码段:

//From TemplateTestCase in NUnit.Core namespace

private void InvokeSetUp()

{

MethodInfo method = FindSetUpMethod(fixture);//取得[SetUp]标记的函数反射实例

       if(method != null)

       {

              InvokeMethod(method,fixture);//运行该函数

       }

}

FindSetUpMethod(…)通过调用一个叫FindMethodByAttribute(…)的函数,利用反射机制来获得可调用该函数的MethodInfo,并最后通过InvokeMethod(MethodInfo,…)来运行。

//From Test class in NUnit.Core namespace

protected void InvokeMethod(MethodInfo method,object fixture)

{

if(method != null)

       {

       try

           {

                  method.Invoke(fixture,null);//调用由method实例反射的方法或构造函数

           }

           catch(…)

           //…

       }

}

仔细阅读源码可以看到因为NUnit使用反射机制来运行测试程序集中的测试案例,所以对[SetUp][Test][TearDown]函数的返回值、参数都有具体的要求,形成了一种规则耦合。这是为了方便反射实现、简化框架而作出的必要设计。

NUnit可以看到.NET元数据扩展中的自定义属性在框架设计中的应用,相信会有更多的框架类项目利用.NET自定义属性的特性。下面是本文涉及的几个类在NUnit中的关系(已经作了简化)。

 

2NUnit中几个利用属性定义和读取工作的类的简化类图

 

3.2 属性其他应用

优秀的构架启迪我们的思维,.NET属性元数据扩展的应用还远不止这些。利用其特性,还可以实现若干应用和框架设计。最近,我正在实现一个基于属性元数据扩展的项目代码管理工具,以后会与朋友们分享。

 

4.总结

利用.NET自定义属性实现元数据扩展,可以为在我们设计、构架时添加新的思路和解决办法。学习优秀框架(如:NUnit)是一个好办法。但读取元数据必将涉及到反射机制的使用,而反射机制的性能是较低的,这一点在设计、构架时须谨慎处理。

 

-end-

版权声明:本文内容由互联网用户自发贡献,该文观点与技术仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请发送邮件至 dio@foxmail.com 举报,一经查实,本站将立刻删除。

相关推荐


1.使用ajax调用varxhr;functioninvoke(){if(window.ActiveXObject){xhr=newActiveXObject("Microsoft.XMLHTTP");}else{xhr=newXMLHttpRequest();}//指定请求地址varurl="http://127.0.0.1:7777/hello?wsdl";//
               好不容易把WebService服务器端搭建起来,我们还需要客户端程序也同样跑起来才能够进行和服务器端程序的通信: 在这篇文章里面,我会先自己写代码去实现调用WebService服务器端程序,接下来,通过IDEA配置的方式来调用WebService服务端: 首先,我写了一个W
1新建一个工程项目用来做服务端增加一个MyService1类文件packagecom.zns.ws;importjavax.jws.WebMethod;importjavax.jws.WebService;importjavax.xml.ws.Endpoint;@WebServicepublicclassMyService1{publicstaticvoidmain(String[]args){
packagecom.transsion.util;importjava.io.BufferedReader;importjava.io.IOException;importjava.io.InputStreamReader;importjava.io.PrintWriter;importjava.net.URL;importjava.net.URLConnection;importcom.alibaba.druid.util.Base64;importcom.tra
再生产wsdl文件时重写描述文件1usingSystem;2usingSystem.Collections.Generic;3usingSystem.Linq;4usingSystem.Web;5usingSystem.Web.Services.Description;67namespaceStrongSoftManage.Web.App8{9publicclassSoapExtens:SoapExtensi
一般情况下,使用eclipse自带的jax-ws生成webservice会自动生成2个类:ContractConnector.java packagecom.wonders.webservice.contract;importjava.text.DecimalFormat;importjava.text.ParseException;importjava.text.SimpleDateFormat;importjava.util.Date;i
一、WebService概述1.1什么是WebService 基于Web的服务:服务器端整出一些资源让客户端应用访问(获取数据) 一个跨语言、跨平台的规范(抽象)所谓跨编程语言和跨操作平台,就是说服务端程序采用java编写,客户端程序则可以采用其他编程语言编写,反之亦然!跨操作系统平台则是指服务
一、什么是CXF?    ApacheCXF=Celtix+Xfire,开始叫ApacheCeltiXfire,后来更名为ApacheCXF了,以下简称为CXF。ApacheCXF是一个开源的webServices框架,CXF帮助您构建和开发webServices,它支持多种协议,比如:SOAP1.1,1,2 XML/HTTP、RESTful或者CORBA。  
工具IDEA一、构建项目1、选择SpringInitializr2、填写项目信息3、勾选webService4、勾选Thymeleaf5、项目建立完成,启动类自动生成二、写个Controller启动服务。浏览器访问/hello接口。 
1.环境win764位,vs20102.新建一个asp.netweb应用程序(同上一篇)3.添加一个web引用,引用上一篇创建的服务。注意不是服务引用。如下图 
WebService之WSDL文件讲解   恩,我想说的是,是不是经常有人在开发的时候,特别是和第三方有接口的时候,走的是SOAP协议,然后用户给你一个WSDL文件,说按照上面的进行适配,嘿嘿,这个时候,要是你以前没有开发过,肯定会傻眼,那如果你想学习的话,就认真的看下面的讲解咯:一、WSDL概述  
在websrvice发布文件的webconfig中加入<httpRuntimemaxRequestLength="102400"/> <webServices>     <protocols>       <addname="HttpPost"/>       <addname="HttpGet"/>     </protocols>   
 代码比较简单,按照如下来操作即可,只是jar包有很多问题,比如找不到classnotFondspring、以及找不到xfile.xml、以及xfile.xml中的一个参数问题,以及2.0 spring。jar和spring1.6.2冲突问题,总之这个小demo报了一堆错误,其实都是jar的问题,为了让大家减少这方面的错误,所以我提供
 一、soapUI简介SOAP:   WebService通过Http协议发送请求和接收结果时,发送的请求内容和结果内容都采用XML格式封装,并增加了一些特定的HTTP消息头,以说明HTTP消息头的内容格式,这些特定的HTTP消息头和XML内容格式就是SOAP协议。SOAP提供了标准的RPC方法来调用WebService。 
参考,感谢https://blog.csdn.net/hj7jay/article/details/727224381.环境:win764位,jdk1.8.0_201 EclipseJavaEEIDEforWebDevelopers.Version:Mars.1Release(4.5.1)2.创建一个普通的java项目,名字是TheService在src目录下创建一个com.hyan.service包,在此包下创建
CXF实现RestfulWebService基础示例一、写在前面IDE:IDEA14JDK:1.7CXF:2.6.2示例来源:%CXF_HOME%\samples\jax_rs\basic发布方式:JAXRSServerFactoryBean的create()方法调用方式:URL的openStream()方法、HttpClient的executeMethod()方法二、服务端(Java项目)1.准备Jar包
封装helper类:classWebServiceHelper{///<summary>///1.get请求http方法///</summary>///<paramname="url">基础url</param>///<paramname="method">请求方法</param>///<paramnam
.net客户端调用java或.netwebservice进行soapheader验证最近项目中有业务需要跨平台调用web服务,客户端和服务器之间采用非对称加密来保证数据的安全性,webservice的安全验证基于soapheader。借此机会,顺便整理一下调用.netwebservice和javawebservice的验证方式,记录下来。
Node.jshttps://www.cnblogs.com/goldlong/p/8027997.htmlQQ音乐apihttps://juejin.im/post/5a35228e51882506a463b172#heading-11?tdsourcetag=s_pcqq_aiomsgGit把本地仓库上传到GitHbubhttps://blog.csdn.net/zamamiro/article/details/70172900git删除本地仓库https://blog.cs
转载自:孤傲苍狼 WebService学习总结(三)——使用JDK开发WebService一、WebService的开发手段使用Java开发WebService时可以使用以下两种开发手段1、 使用JDK开发(1.6及以上版本)-->详见:本文2、使用CXF框架开发-->详见:其他文章二、使用JDK开发WebServi