前言
之前写过一篇文章,是关于在.NET中,使用v8sharp作为v8Engine的Wraper, 从而在.NET中与Javascript互操作。不过v8Sharp有几个很大的问题,第一,在参数中传递中文字符串会产生乱码。第二,无法在.NET中,使用.NET对象作为参数传递给Javascript。这样的话,v8Sharp的实用价值就降低了不少。好在v8Engine相当出色,有众多的.NET开源Wrapper,于是,找到了这款Javascript.NET,可扩展性相当强的Wrapper。
v8Engine
v8Engine是Google Chrome使用的JS解释引擎, 其执行效率相当的高,根据我自己的测试,是高于IE8,FF3等浏览器所使用的JS引擎。目前的最新版本与IE9,FF4的执行效率不相上下。而且Javascript本身是C Style的编程语言,对于我们这种长期使用C、C++和C#的开发人员来说,比LUA等脚本语言更具亲和力。
Javascript.NET
之前提到了它的可扩展性相当强,是因为它很简单,无论是从源代码来看,还是从使用上来看,都相当的简单。自己仅需要简单的包装一下,即可实现大部分非常有用的功能。 官方网站的入门指引只提到了它可以执行JS代码,没有提到如何执行JS定义的方法,实际上在调用它的Run方法时,JS代码已经被编译进了上下文,如果把JS定义的方法预先编译一次,即可在以后通过函数名称直接调用JS方法。我恰好利用了这个特性对该类库进行了一些简单的包装,实现了.NET与JS的函数互调用。不过目前官方提供的最新版本存在一个Bug,在.NET中调用JS时(通过Run方法执行JS),会随机出现“(Unknown Location)”异常,实际是因为Stack overflow引起的,我稍微修改了一下官方的源代码,修正了这个问题,在后面提供的源代码中,Noesis.Javascript.dll已经是修正了该问题的编译版本。如果需要Noesis.Javascript.dll的源代码,请联系我。
How to use
我仅仅对Javascript.NET进行了一个简单的包装,在源代码中也提供了Example,这里就大概说明一下。
首先是配置文件,有如下几个属性:
- StartEngine:是否启动JS引擎,如果设置为False,则不会启动引擎,也无法调用类库中的任何方法(会抛出异常)。
- RelativePath:是否为相对路径,可以将JS文件放在应用程序根目录,或者放在任意位置,如果在根目录,则可以配置该属性为True,并填写脚本文件所在的文件夹名称即可,具体可以参考Example。
- ScriptPath:脚本文件路径,根据RelativePath填写目录名称或者完整物理路径。
- CreateGACMapping:是否创建全局程序集映射,该操作比较耗时,在启动脚本引擎时,大概需要5-10秒的时间创建映射,好处是在JS方法中,可以简单的通过命名空间+类名和程序集名称实例化.NET对象,具体参见下面的代码片段。
- CreateMappingAsyn:是否异步创建映射,设置为True以免阻塞主线程,在Mapping结束时,JS引擎会触发事件。具体参考Example代码。
1 JScriptManager.MappingComplete += (sender, e) =>
2 {3 Console.Write( " 映射创建完成 ");
4 };
JS的一般调用方法:
1 function normalMethod(msg)
2 {3 msg = " Hello,return from js: " + msg;
4 return msg;
5 }
C#代码:
1 string rtv = (string)JScriptManager.Call("normalMethod", msg);
2 Console.WriteLine(rtv);
传递.NET对象作为JS方法的参数:
1 function callDotNet(speaker)
2 {3 speaker.Print( " output from js " );
4 }
C#代码:
1 public class Speaker
2 {3 public void Print( string msg)
4 {
5 Console.WriteLine(msg);
6 }
7 }
1 JScriptManager.Call("callDotNet", new Speaker());
在JS中通过强命名方式实例化.NET对象(无需创建GAC映射):
1 function testCreateByFullName()
2 {3 var proc = $.Create( " System.Diagnostics.Process, System, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089 " , null );
4 proc.StartInfo.FileName = " calc " ;
5 proc.Start();
6 }
在JS中通过完全限定名+程序集名称创建.NET对象(需要GAC映射):
1 function testCreateByShortName()
2 {3 var proc = $.Create( " System.Diagnostics.Process " , " System " , null );
4 proc.StartInfo.FileName = " explorer " ;
5 proc.StartInfo.Arguments = " about:blank " ;
6 proc.Start();
7 }
在JS中调用.NET静态方法:
1 function testStaticMethod()
2 {3 var arg = new Array();
4 arg[ 0 ] =- 25 ;
5 var rtv = $.StaticMethod( " System.Math " , " mscorlib " , " Abs " ,arg);
6 return rtv;
7 }
在源代码中提供的Example分别包含了上述介绍的使用方法,最终运行的效果是在控制台输出两句字符串,并启动Windows自带的计算器和默认的浏览器。