前言
之前寫過一篇文章,是關於在.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自帶的計算器和默認的瀏覽器。