SpiderMonkey－让你的C++程序支持JavaScript脚本

译序

有些网友对为什么D2JSP能执行JavaScript脚本程序感到奇怪，因此我翻译了这篇文章，原文在这里。这篇教程手把手教你怎样利用SpiderMonkey创建一个能执行JavaScript脚本的C++程序，并让JavaScript脚本操纵你的C++程序的内部数据、操作。从这篇教程能够看到在SpiderMonkey引擎的帮助下，让C++程序支持JavaScript脚本是一件非常easy的事，更棒的是SpiderMonkey也能够在Macintosh和Unix平台使用。
SpiderMonkey是Gecko（Firefox浏览器的内核）的JavaScript脚本引擎，具体文档请看这里。

下面为翻译内容。

－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－

本教程的目的是教你怎样用JavaScript做为脚本语言使你的C++程序自己主动化。

SpiderMonkey

SpiderMonkey是Mozilla项目的一部分，用C语言写成，是负责运行JavaScript脚本的引擎。另外另一个叫Rhino的Java引擎。

SpiderMonkey的最新版本号可在这里下载。它是以源码形式公布的，因此你必须自己编译它（译注：事实上网上有非常多编译好的二进制版本号，google一下js32.dll就可找到）。Visual C++用户能够在src文件夹下找到Workspace项目project文件来编译，编译结果会产生一个叫'js32.dll'的dll文件。

SpiderMonkey也能够在Macintosh和Unix上使用，想了解怎样在这些平台上进行编译请阅读Readme.html。

在C++中运行JavaScript程序

步骤1－创建JavaScript runtime（执行时实例）

初始化一个JavaScript runtime可用JS_NewRuntime方法，该方法将为runtime分配内存，同一时候还得指定一个字节数，当内存分配超过这个数字时垃圾收集器会自己主动执行。

JSRuntime *rt = JS_NewRuntime(1000000L);
if ( rt == NULL )

步骤2－创建context（上下文环境）

Context指明了脚本执行所需的栈大小，即分配给脚本执行栈的私有内存数量。每一个脚本都和它自己的context相关联。

当一个context正在被某个脚本或线程使用时，其它脚本或线程不能使用该context。只是在脚本或线程结束时，该context能够被下一个脚本或线程重用。

创建一个新context可用JS_NewContext方法。context必须关联到一个runtime，调用JS_NewContext方法时还必须指定栈的大小。

JSContext *cx = JS_NewContext(m_rt, 8192);
if ( cx == NULL )
JSClass globalClass =
JSObject *globalObj = JS_NewObject(cx, &globalClass, 0, 0);
JS_InitStandardClasses(cx, globalObj);[/code]

步骤4－运行脚本

运行脚本的一种途径是使用JS_EvaluateScript方法：

std::string script = "var today = Date(); today.toString();"
jsval rval;
uintN lineno = 0;
JSBool ok = JS_EvaluateScript(cx, globalObj, script.c_str(),
script.length(), "script", lineno, &rval);

在这个脚本中，假设运行正确的话当天数据会保存在rval中。rval包括最后一个运行函数的结果。JS_EvaluteScript返回JS_TRUE代表运行成功，返回JS_FALSE则代表有发生错误。

从rval得到对应的字符串值能够用以下的方法。在这里我不想解释全部细节，想获得更具体的信息请自己查API文档。

JSString *str = JS_ValueToString(cx, rval);
std::cout << JS_GetStringBytes(str);

步骤5－清理脚本引擎

程序结束前必须对脚本引擎做一些清理工作：
JS_DestroyContext(cx);
JS_DestroyRuntime(rt);

在C++中定义一个在JavaScript中用的类

这个样例中用到的类定义例如以下：

class Customer
// JSCustomer.h
class JSCustomer
// JSCustomer.cpp
JSClass JSCustomer::customerClass =
static JSBool JSGetProperty(JSContext *cx, JSObject *obj, jsval id, jsval *vp);
static JSBool JSSetProperty(JSContext *cx, JSObject *obj, jsval id, jsval *vp);
static JSBool JSConstructor(JSContext *cx, JSObject *obj, uintN argc,
jsval *argv, jsval *rval);
static void JSDestructor(JSContext *cx, JSObject *obj);

步骤2－初始化你的JavaScript对象

创建另外一个叫JSInit的静态方法，见以下的样例，该方法将在应用程序创建JavaScript runtime时被调用。

static JSObject *JSInit(JSContext *cx, JSObject *obj, JSObject *proto);

JSInit方法的实现大约例如以下：

JSObject *JSCustomer::JSInit(JSContext *cx, JSObject *obj, JSObject *proto)
JSBool JSCustomer::JSConstructor(JSContext *cx, JSObject *obj, uintN argc,
jsval *argv, jsval *rval)
void JSCustomer::JSDestructor(JSContext *cx, JSObject *obj)
static JSPropertySpec customer_properties[];
enum
JSPropertySpec JSCustomer::customer_properties[] =
JSBool JSCustomer::JSGetProperty(JSContext *cx, JSObject *obj, jsval id, jsval *vp)

JSBool JSCustomer::JSSetProperty(JSContext *cx, JSObject *obj, jsval id, jsval *vp)
static JSFunctionSpec customer_methods[];

在实现文件里例如以下初始化该数组：

JSFunctionSpec wxJSFrame::wxFrame_methods[] =
static JSBool computeReduction(JSContext *cx, JSObject *obj, uintN argc,
jsval *argv, jsval *rval);

该函数成功时返回JS_TRUE，否则返回JS_FALSE。注意真正的JavaScript方法的返回值保存在rval參数中。
该方法的一个实现样例：

JSBool JSCustomer::computeReduction(JSContext *cx, JSObject *obj, uintN argc,
jsval *argv, jsval *rval)
var c = new Customer();
c.name = "Franky";
c.age = 32;
var reduction = c.computeReduction();

别忘了在创建context时初始化JavaScript对象：

JSObject *obj = JSCustomer::JSInit(cx, global);

类常量

JavaScript类型

这一章解释在JavaScript中会用到的几种类型：Integer，String，Boolean，Double，Object和Function。

构建中。。。。。。

垃圾回收

构建中。。。。。。

下载

main.cpp演示怎样运行一个javascript程序。JSCustomer.h演示Customer的JavaScript类的定义。JSCustomer.cpp演示JSCustomer的实现。Customer.h是Customer C++类的定义。example.js示例脚本程序。