从JavaScript调用单个.NET方法
您可以使用SetGlobalFunctionAPI从JavaScript调用任何.NET 。例如：
var engine = new Jurassic.ScriptEngine();
engine.SetGlobalFunction("test", new Func<int, int, int>((a, b) => a + b));
Console.WriteLine(engine.Evaluate<int>("test(5, 6)"));
此代码将向控制台输出"11"。
请注意以下几点：
- 必须全部支持委托参数类型和返回类型。
- 在提供的委托中引发的异常无法在
JavaScript中捕获（除非它是JavaScriptException）。 - 由于安全限制，以上示例在
Silverlight中不起作用。要解决此问题，请将委托传递给公共方法。
从.NET调用JavaScript函数
您也可以从.NET调用JavaScript函数。
var engine = new Jurassic.ScriptEngine();
engine.Evaluate("function test(a, b) { return a + b }");
Console.WriteLine(engine.CallGlobalFunction<int>("test", 5, 6));
此代码将"11"输出到控制台。
将.NET类暴露给JavaScript
Building a property bag class
首先,让我们创建一个包含几个属性的类。
using Jurassic;
using Jurassic.Library;
public class AppInfo : ObjectInstance
{
public AppInfo(ScriptEngine engine)
: base(engine)
{
// Read-write property (name).
//类索引器可用于创建读写属性。
this["name"] = "Test Application";
// Read-only property (version).
//`DefineProperty`可用于创建只读属性
this.DefineProperty("version", new PropertyDescriptor(5, PropertyAttributes.Sealed), true);
}
}
在此示例中,有几件事要注意：
- 暴露给
JavaScript的类需要继承Jurassic.Library.ObjectInstance。 - 将
ScriptEngine传递给基类构造函数意味着该对象将没有原型。因此,常规功能(hasOwnProperty,toString)将不可用。 - 类索引器可用于创建读写属性。
-
DefineProperty可用于创建只读属性。
这是有关如何创建和使用新类的示例：
var engine = new Jurassic.ScriptEngine();
engine.SetGlobalValue("appInfo", new AppInfo(engine));
Console.WriteLine(engine.Evaluate<string>("appInfo.name + ' ' + appInfo.version"));
Building a class with static functions
下一步是使用静态函数创建一个类,类似于内置Math对象的工作方式。例如,假设您要使用log10函数创建一个新的Math2对象：
using Jurassic;
using Jurassic.Library;
public class Math2 : ObjectInstance
{
public Math2(ScriptEngine engine)
: base(engine)
{
this.PopulateFunctions();
}
[JSFunction(Name = "log10")]
public static double Log10(double num)
{
return Math.Log10(num);
}
}
请注意以下几点：
- PopulateFunctions 在类中搜索[JSFunction]属性,并为找到的每个属性创建一个函数。
- [JSFunction]属性允许JavaScript函数名称与.NET方法名称不同。
- 参数类型和返回类型必须在[支持的类型|支持的类型]列表中。
- 使用[JSProperty]属性装饰属性可将属性作为访问者公开给脚本。因此,您可以在CLR中编写带有支持者的属性,或在CLR代码中设置只读属性。
这是有关如何创建和使用新类的示例：
var engine = new Jurassic.ScriptEngine();
engine.SetGlobalValue("math2", new Math2(engine));
Console.WriteLine(engine.Evaluate<double>("math2.log10(1000)"));
Building an instance class
可以实例化的对象(例如内置的Number,String,Array和RegExp对象)需要两个.NET类,一个用于构造函数,一个用于实例。例如,让我们制作一个与.NET Random类类似的JavaScript对象(带有种子,因为JavaScript不支持该对象)：
using Jurassic;
using Jurassic.Library;
public class RandomConstructor : ClrFunction
{
public RandomConstructor(ScriptEngine engine)
: base(engine.Function.InstancePrototype, "Random", new RandomInstance(engine.Object.InstancePrototype))
{
}
[JSConstructorFunction]
public RandomInstance Construct(int seed)
{
return new RandomInstance(this.InstancePrototype, seed);
}
}
public class RandomInstance : ObjectInstance
{
private Random random;
public RandomInstance(ObjectInstance prototype)
: base(prototype)
{
this.PopulateFunctions();
this.random = new Random(0);
}
public RandomInstance(ObjectInstance prototype, int seed)
: base(prototype)
{
this.random = new Random(seed);
}
[JSFunction(Name = "nextDouble")]
public double NextDouble()
{
return this.random.NextDouble();
}
}
请注意以下几点：
- 您需要两个类-一个是构造函数(即调用new的函数对象),另一个是实例对象。
- ClrFunction基类需要三个参数：函数对象的原型,函数的名称和使用该函数创建的任何实例的原型。
- [JSConstructorFunction]属性标记使用新运算符时调用的方法。您也可以使用[JSCallFunction]标记直接调用该函数时所调用的方法。
- RandomInstance类具有两个构造函数-一个用于初始化原型,一个用于初始化所有其他实例。 PopulateFunctions只能从原型对象中调用。
这是有关如何创建和使用新类的示例：
var engine = new Jurassic.ScriptEngine();
engine.SetGlobalValue("Random", new RandomConstructor(engine));
Console.WriteLine(engine.Evaluate<double>("var rand = new Random(1000); rand.nextDouble()"));
这将向控制台输出"0.151557459100875"(由于我们使用的是种子,因此每次对nextDouble()的第一次调用都相同。)
这个例子涉及更多,但是它支持所有高级JavaScript概念：
- rand支持内置的Object函数(hasOwnProperty,toString等)。
- rand利用原型继承。在这种情况下,您具有以下原型链：
random instance (with no properties) -> random prototype (with nextDouble defined) -> object prototype -> null.
从自定义源加载脚本
如果要执行的脚本不在文件中，并且不想将其加载到字符串中，则可以创建一个custom ScriptSource。以下示例显示了如何完成此操作：
/// <summary>
/// Represents a string containing script code.
/// </summary>
public class StringScriptSource : ScriptSource
{
private string code;
/// <summary>
/// Creates a new StringScriptSource instance.
/// </summary>
/// <param name="code"> The script code. </param>
public StringScriptSource(string code)
{
if (code == null)
throw new ArgumentNullException("code");
this.code = code;
}
/// <summary>
/// Gets the path of the source file (either a path on the file system or a URL). This
/// can be <c>null</c> if no path is available.
/// </summary>
public override string Path
{
get { return null; }
}
/// <summary>
/// Returns a reader that can be used to read the source code for the script.
/// </summary>
/// <returns> A reader that can be used to read the source code for the script, positioned
/// at the start of the source code. </returns>
/// <remarks> If this method is called multiple times then each reader must return the
/// same source code. </remarks>
public override TextReader GetReader()
{
return new StringReader(this.code);
}
}
线程与并发
侏罗纪不是线程安全的。但是，它也不使用任何线程局部或全局状态。因此，只要确保没有一次从多个线程调用任何Jurassic对象，它将起作用。确保这一点的最简单方法是使用多个脚本引擎（每个线程一个是理想的）。由于非原始对象绑定到单个脚本引擎，因此每个脚本引擎都完全相互隔离。这确实使脚本引擎之间难以共享数据。共享数据的一种方法是将其序列化为字符串，然后在线程之间传递（JSON对象可用于序列化JavaScript对象）。
