[Hack] C# Attribute使用约束

Attribute是C#中一个广泛使用的特性,通过使用Attribute对程序集中的类型进行标记,并通过Reflection实现一些特殊的需求,同时Attribute也可以在编译时储存一些静态信息。但是在使用Attribute时也有一些限制。

问题的提出

目前工作中主要是编写与维护一套在Unity中使用的Continuous Integration 框架。在这套框架中大量使用了Attribute来对集成的第三方SDK进行标记,来进行一些处理。最初的做法是一些SDK,通过约定静态方法,在CI的其他阶段进行调用

public class SDKA :SDKBase
{
    public static void ModifyConfig(ref Hashtable config)
    {
        //SDK do modify
    }
    ....
}

通过反射调用该方法的代码如下

    public void SDKsModifyConfig()
    {
        Type[] sdktypes = assembly.GetTypes();
        //过滤所有的的SDK类型
        ...
      foreach(var tsdk in sdktypes)
      {
          MethodInfo method = tsdk.GetMethod("ModifyConfig", BindingFlags.Public | BindingFlags.Static | BindingFlags.NonPublic);
          method.Invoke(null, config);
      }
      ...
    }

对于这种调用方式,不太好的地方是参与开发SDK的人员必须约定用于反射的方法名,以及该方法的参数。每次接入SDK编写一个SDK的类型都需重新编写,容易造成错误(error-prone)。

<escape></escape>

如果我们使用在基类定义方法,在子类覆盖的形式,这样可以避免发生错误,同时IDE的自动完成可以帮助我们完成代码。但是这样在反射的时候就需要有类的对象,而其实我们所需要的方法是针对与类的静态方法。

public class SDKBase
{
    public virtual void ModifyConfig(ref Hashtable config)
    {
    }
}
public class SDKA :SDKBase
{
    public override void ModifyConfig(ref Hashtable config)
    {
    }
}

使用Attribute

另一中解决方式是将这些方法定义在Attribute中。

public class CustomSDKAttribute :Attribute
{
    public void ModifyConfig(ref Hashtable config)
    {
    }
}
[CustomSDK]
public class SDKA :SDKBase
{
}

...
        foreach(var type in sdktypes)
        {
            if(Attribute.IsDefined(type,typeof(CustomSDKAttribute)))
            {
                var attrs = type.GetCustomAttributes(typeof(CustomSDKAttribute), true);
                CustomSDKAttribute sdkattr = attrs[0] as CustomSDKAttribute;
                sdkattr.ModifyConfig(ref config);
            }
        }

将需要反射的方法放在Attribute的定义中后我们在反射了类获得Attribute之后可以直接调用该方法,不需要再反射方法了。

对于不同的SDK的类型需要不同的实现,我们可以定义一个Attribute的基类,通过Attribute的子类来实现

[CustomSDK]
public class SDKA :SDKBase
{
}
[CustomSDK_Impl]
public class SDKB:SDKBase
{
}
public class CustomSDKAttribute :Attribute
{
    public virtual void ModifyConfig(ref Hashtable config)
    {
    }
}
public class CustomSDK_Impl :CustomSDKAttribute
{
    public override void ModifyConfig(ref Hashtable config)
    {
        //覆盖基类的实现
    }
}

Attribute的约束

我们知道在定义Attribute的时候可以给Attribute添加约束AttributeUsage

[AttributeUsage(AttributeTargets.Class,AllowMultiple =false)]

但是只能通过AttributeUsage约束Attribute添加到程序集对象的类型,并不能约束Attribute修饰的对象的继承链等其他特性。也就是不能使用泛型和where关键字。这样就会导致我们给SDK定义的Attribute可以被任意使用其他类型的对象上,这是我们不愿意看到的。

由于我们是使用反射来查找所有标记为该Attribute的类型,缺少了类型的继承链约束后,无疑会造成一些隐患。但是由于C#语言本身不提供Attribute的类型约束,在google之后通过一个非常trick的方式解决了Attribute的约束问题。

我们将Attribute的定义声明在需要约束的基类中,并且使用protected修饰符

public class SDKBase
{
    public static void ModifyConfig(ref Hashtable config)
    {
    }

    [AttributeUsage(AttributeTargets.Class, AllowMultiple = false)]
    protected class CustomSDKAttribute : Attribute
    {
        public virtual void ModifyConfig(ref Hashtable config)
        {

        }
    }
}

这样CustomSDKAttribute就只能在SDKBase的子类进行访问,下面的代码便会产生编译错误。

[CustomSDK]             //Error:未找到类型
public class TestClassA
{
}

这样就我们就相当与声明了where T:SDKBASE,对Attribute的使用进行了约束。

总结

使用Attribute定义的修饰符将Attribute修饰的对象加上约束。

对于将需要反射调用的方法存放在Attribute中还有一个好处是。在Unity开发中,如果我们只在Editor层面进行对这些方法的反射和调用,可以将该Attribute限定在编辑器环境,防止这部分代码污染最后编译的版本。

[System.Diagnostics.Conditional("UNITY_EDITOR")]

但是如果使用最初的反射方法的方式,这需要给所有的反射方法加上宏的限定,同时不一定可以使用System.Diagnostics.Conditional这个Attribute进行宏的约束。Conditional要求限定的方法必须是void的返回值。讲方法定义在Attribute中直接移除Attribute不受该约束限制

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 204,445评论 6 478
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,889评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 151,047评论 0 337
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,760评论 1 276
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,745评论 5 367
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,638评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,011评论 3 398
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,669评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,923评论 1 299
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,655评论 2 321
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,740评论 1 330
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,406评论 4 320
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,995评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,961评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,197评论 1 260
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,023评论 2 350
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,483评论 2 342

推荐阅读更多精彩内容