[转].Net 中的许可证机制
实验环境:Visual Studio 2005 + .Net Framework 2.0
主要命名空间:System.ComponentModel
主要类:
System.ComponentModel.License(为所有许可证提供 abstract 基类。向组件的特定实例授予许可证)
System.ComponentModel.LicenseContext(指定何时可使用授权的对象,并且提供一种方法,用以获取为支持在其域内运行的许可证所需要的附加服务)
System.ComponentModel.LicenseException(表示当组件不能被授予许可证时引发的异常。)
System.ComponentModel.LicenseManager(提供属性和方法,用以将许可证添加到组件和管理 LicenseProvider)
System.ComponentModel.LicenseProvider(提供 abstract 基类以便实现许可证提供程序)
System.ComponentModel.LicenseProviderAttribute(指定要与类一起使用的 LicenseProvider)
许可证机制简介
.Net Framework中的许可证验证机制基于System.ComponentModel命名空间中的License、LicenseContext、LicenseException、LicenseManager、LicenseProvider和LicenseProviderAttribute六个类实现的。
License是一个抽象类,用于代表许可证主体;
LicenseContext中保存了许可证的上下文,其中UsageMode属性可以用来获取当前是运行时(runtime)还是设计模式(designtime);
LicenseException是许可证相关的异常,当许可证信息不可用时,在调用LicenseProvider(或其派生类)实例的GetLicense方法时将抛出此类型的异常;
LicenseManager是一个密封(sealed)类,LicenseManager提供了多个静态(static)方法用于验证许可证、获取许可证等操作;
LicenseProviderAttribute属性用于指定某一个类所采用的许可证提供程序(LicenseProvider)的具体类型;
LicenseProvider是一个抽象类,用于代表许可证验证机制提供程序。LicenseProvider的类型通过LicenseProviderAttribute属性提供给CLR,当调用LicenseManager的操作时,LicenseManager将根据LicenseProviderAttribute中所提供的LicenseProvider类型创建LicenseProvider实例,并进行相应操作。LicFileLicenseProvider基于文本文件的许可证机制。
LicFileLicenseProvider
LicFileLicenseProvider类是.Net Framework提供的一个简单的LicenseProvider实现。LicFileLicenseProvider类代表了.Net Framework提供的一种简单的基于文本文件的许可证验证机制。
通过上面的介绍,我们知道,要实现一套.Net中的许可证验证机制还需要一个类作为License的具体实现,而这个类在.Net Framework的类库中是无法找到的,但这个具体的实现类是肯定存在的。打开.Net Framework中自带的MSIL反汇编程序(ildasm.exe)打开System.dll查看,发现在LicFileLicenseProvider内部定义了一个私有类LicFileLicense,这个类就是License在这套许可证验证机制中的具体实现。
仍然在MSIL反汇编程序中,我们打开LicFileLicenseProvider类的GetLicense方法,在这个方法中会根据参数所传进来的目标类型的Type(在上面的图中就是MyClass的Type)查找到一个相应的扩展名为.lic的文本文件,并用FileStream读取其中的文本,然后调用IsKeyValid方法。
IL_0083: callvirt instance string [mscorlib]System.Type::get_FullName() // 获取目标类型的完整限定名 IL_0088: ldstr ".lic" // 在目标类型的完整限定名后面追加.lic组成许可证文件(.lic文件)的文件名 IL_008d: call string [mscorlib]System.String::Concat(string, string, string, string) IL_0092: stloc.s V_5 IL_0094: ldloc.s V_5 IL_0096: call bool [mscorlib]System.IO.File::Exists(string) IL_009b: brfalse.s IL_00db IL_009d: ldloc.s V_5 IL_009f: ldc.i4.3 IL_00a0: ldc.i4.1 IL_00a1: ldc.i4.1 IL_00a2: newobj instance void [mscorlib]System.IO.FileStream::.ctor(string, valuetype [mscorlib]System.IO.FileMode, valuetype [mscorlib]System.IO.FileAccess, valuetype [mscorlib]System.IO.FileShare) // 开始用FileStream读取许可证文件 IL_00a7: stloc.s V_6 IL_00a9: ldloc.s V_6 IL_00ab: newobj instance void [mscorlib]System.IO.StreamReader::.ctor(class [mscorlib]System.IO.Stream) IL_00b0: stloc.s V_7 IL_00b2: ldloc.s V_7 IL_00b4: callvirt instance string [mscorlib]System.IO.TextReader::ReadLine() IL_00b9: stloc.s V_8 IL_00bb: ldloc.s V_7 IL_00bd: callvirt instance void [mscorlib]System.IO.TextReader::Close() IL_00c2: ldarg.0 IL_00c3: ldloc.s V_8 IL_00c5: ldarg.2 IL_00c6: callvirt instance bool System.ComponentModel.LicFileLicenseProvider::IsKeyValid(string, class [mscorlib]System.Type) // 调用IsKeyValid方法,进一步验证许可证是否有效 |
在IsKeyValid方法中,我们就可以明白为什么这种验证方式相当简单了。查看IsKeyValid方法的代码,发现,这个方法中仅仅是判断.lic文件中的文本是否是以目标类型的完整文件名开始的。
IL_0006: callvirt instance string System.ComponentModel.LicFileLicenseProvider::GetKey(class [mscorlib]System.Type) IL_000b: callvirt instance bool [mscorlib]System.String::StartsWith(string) // 验证文本是否是以目标类型的完整限定名开始的 |
到这里,我们看到了LicFileLicenseProvider及LicFileLicense的运行机制。显然,在我们正式开发的时候这套验证机制是无法满足需求的,不过通过了解其中的逻辑,我们就可以很轻松的开发一套自己需要的许可证验证机制。
自定义许可证验证机制
创建一个新的项目,为了便于介绍我创建了一个控制台程序(LicTestConsole)。
向项目中添加许可证验证机制所需的类
License类的实现(SimpleLicense)
class SimpleLicense : License { private Type _Type; public SimpleLicense(Type type) { if (type == null) { throw (new NullReferenceException()); } _Type = type; } public override void Dispose() { // TODO: 根据需要插入垃圾回收的代码 } public override string LicenseKey { get { return (_Type.GUID.ToString()); } } } |
LicenseProvider类的实现(SimpleLicenseProvider)
public class SimpleLicenseProvider : LicenseProvider { public override License GetLicense(LicenseContext context, Type type, object instance, bool allowExceptions) { if (context.UsageMode == LicenseUsageMode.Runtime) { // 这里是验证运行时的许可证的逻辑 // 这里我采用了随机数(因为这样写代码较少),也就是说有时候能用有时候禁用,你可以根据自己具体的需要编写不同的验证逻辑 Random random = new Random(); if (random.Next(0, 2) == 1) { return (new SimpleLicense(type)); } else { throw (new LicenseException(type)); } } else if (context.UsageMode == LicenseUsageMode.Designtime) { // TODO: 如果你想限制编辑模式下的许可证(所谓的开发许可证),在这里添加相应的逻辑 } return (null); } } |
向项目中添加一个类(TestWorker),并给TestWorker类加上LicenseProviderAttribute属性
[LicenseProvider(typeof(SimpleLicenseProvider))] // 这里指定了这个类中进行许可证验证的过程应采用SimpleLicenseProvider public class TestWorker : IDisposable // 实现IDisposable接口,License的实例需要被显示的调用Dispose { private ArgType _ArgType = ArgType.None; License _License = null; // _License 用于保存许可证信息 public TestWorker(string[] args) { ProcessArgs(args); _License = LicenseManager.Validate(typeof(TestWorker), this); // 在这里调用LicenseManager进行许可证验证 // 如果验证失败Validate方法将会抛出 LicenseException 类型的异常 } private void ProcessArgs(string[] args) { if (args != null) { if (args.Length > 0) { foreach (string arg in args) { if (!string.IsNullOrEmpty(arg)) { _ArgType |= ProcessArg(arg); } } } else { _ArgType = ArgType.None; } } else { _ArgType = ArgType.None; } } protected virtual ArgType ProcessArg(string arg) { ArgType res = ArgType.None; // TODO: return (res); } public void DoTestWork() { OnDoTestWork(); } protected virtual void OnDoTestWork() { // TODO: } public void Dispose() { if (_License != null) { _License.Dispose(); // 调用_License的Dispose方法,显示释放资源 } } } |
修改Program中的代码,以捕获LicenseException类型的异常。
class Program { static void Main(string[] args) { try { TestWorker testWorker = new TestWorker(args); // 实例化 TestWorker 类的实例 testWorker.DoTestWork(); } catch (LicenseException) // 捕获到 LicenseException 类型的异常,说明许可证验证失败 { Console.WriteLine("License Deny !"); // 告诉你一声,你没这个权限 ^_^ } Console.Write("Press ENTER for exit"); Console.ReadLine(); } } [Flags] public enum ArgType { None = 0, } |