在.NET中使用Javascript作为脚本语言
之前写过一篇文章,是关于在.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代码。
监听Mapping结束事件:
JScriptManager.MappingComplete += (sender, e) => { Console.Write("映射创建完成"); };
JS的一般调用方法:
function normalMethod(msg) { msg="Hello,return from js:"+msg; return msg; }
C#代码:
string rtv = (string)JScriptManager.Call("normalMethod", msg); Console.WriteLine(rtv);
传递.NET对象作为JS方法的参数:
function callDotNet(speaker) { speaker.Print("output from js"); }
C#代码:
public class Speaker { public void Print(string msg) { Console.WriteLine(msg); } }
JScriptManager.Call("callDotNet", new Speaker());
在JS中通过强命名方式实例化.NET对象(无需创建GAC映射):
function testCreateByFullName() { var proc=$.Create("System.Diagnostics.Process, System, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089",null); proc.StartInfo.FileName="calc"; proc.Start(); }
在JS中通过完全限定名+程序集名称创建.NET对象(需要GAC映射):
function testCreateByShortName() { var proc=$.Create("System.Diagnostics.Process","System",null); proc.StartInfo.FileName="explorer"; proc.StartInfo.Arguments = "about:blank"; proc.Start(); }
在JS中调用.NET静态方法:
function testStaticMethod() { var arg=new Array(); arg[0]=-25; var rtv = $.StaticMethod("System.Math","mscorlib","Abs",arg); return rtv; }
在源代码中提供的Example分别包含了上述介绍的使用方法,最终运行的效果是在控制台输出两句字符串,并启动Windows自带的计算器和默认的浏览器。
源码下载
Javascript.NET Fix 源码(修正了Stack overflow的问题,编译的话,需要安装Python 2.6.1,Python 3.X编译会出现异常)