之前寫過一篇文章,是關於在.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編譯會出現異常)
PS:原始碼都是VS2010的Proj
原文:http://www.cnblogs.com/sweetwxh/archive/2011/09/06/DotNet_JSEngine.html