集成spiderMonkey

集成spiderMonkey
文档 ：https://developer.mozilla.org/En/SpiderMonkey/JSAPI_User_Guide
https://developer.mozilla.org/en/How_to_embed_the_JavaScript_engine

一、hello world基本流程：
JS_NewRuntime
JS_NewContext
JS_SetOptions
JS_SetErrorReporter
JS_NewCompartmentAndGlobalObject ------创建global对象
JS_InitStandardClasses ---------------- 把运行时内置的函数、对象、常量等作为global object的属性导出
ok = JS_EvaluateScript(cx, global, script, strlen(script), filename, lineno, &rval); ----解释执行

if (rval == NULL | rval == JS_FALSE) // 判断运行状态
return 1;

str = JS_ValueToString(cx, rval); // 处理运行结果

二、暴漏c的函数（本地的wrapper是作为js的回调挂上去的）
本地wrapper的基本格式要求 typedef JSBool (*JSNative)(JSContext *cx, uintN argc, jsval *vp);
1、返回值是 JSBool（JS_TRUE 正常得到结果，JS_FALSE执行时出现异常）
2、第一个参数是 JSContext
3、第二个参数是 argc（js代码中传进来的参数个数）
4、第三个参数是 jsval *， 可以用来取得参数、this、返回值等
5、调用成功时 JS_SET_RVAL + return JS_TRUE
调用失败时 JS_ReportError + return JS_FALSE

三、常用技术
1、JS_ARGV(cx, vp) 指向参数数组的第一个元素
2、JS_RVAL(cx, vp) 指向返回值
3、JS_SET_RVAL(cx, vp, value) 设置返回值
4、JS_THIS_OBJECT(cx, vp) 取this对象
5、JS_THIS(cx, vp) jsVal版本的this
6、JS_CALLEE(cx, vp) 被调用的函数对象

四、例子
JSBool myjs_rand(JSContext *cx, uintN argc, jsval *vp)
{
JS_SET_RVAL(cx, vp, DOUBLE_TO_JSVAL(rand()));
return JS_TRUE;
}

/* A wrapper for the srand() function, from the C standard library.
This example shows how to handle optional arguments. */
JSBool myjs_srand(JSContext *cx, uintN argc, jsval *vp)
{
uint32 seed;
// 把输入的参数转变格式，存入输出中， 参数依次是cx，调用者传入参数个数，传入的参数，输出的格式，输出地址
if (!JS_ConvertArguments(cx, argc, JS_ARGV(cx, vp), "/u", &seed))
return JS_FALSE;

/* If called with no arguments, use the current time as the seed. */
if (argc == 0)
seed = time(NULL);

srand(seed);// 初始化一个种子

JS_SET_RVAL(cx, vp, JSVAL_VOID); /* return undefined */
return JS_TRUE;
}

/* A wrapper for the system() function, from the C standard library.
This example shows how to report errors. */
JSBool myjs_system(JSContext *cx, uintN argc, jsval *vp)
{
JSString* str;
char *cmd;
int rc;

if (!JS_ConvertArguments(cx, argc, JS_ARGV(cx, vp), "s", &str))
return JS_FALSE;

cmd = JS_EncodeString(cx, str); // js string 转成 c的char *
rc = system(cmd);
JS_free(cx, cmd);// 不用了，释放掉
if (rc != 0) {
/* Throw a JavaScript exception. */
JS_ReportError(cx, "Command failed with exit code %d", rc);// 抛出异常给js,js中可以用try catch检测到
return JS_FALSE;
}

JS_SET_RVAL(cx, vp, JSVAL_VOID); /* return undefined 没有返回值时也要显示的设置一下*/
return JS_TRUE;
}

//加入自定义函数
JSFunctionSpec my_functions[] = {
JS_FS("myprint", myprint, 0, 0, 0), // 依次是name, notive func, argc, tags, extra
JS_FS_END
};

JS_DefineFunctions(cx, objParent, my_functions);

五、暴漏对象 JS_InitClass + JS_DefineProperties

顺序：
1、属性id枚举
2、getter, constructer, destructer
3、class的template
4、class的函数表
5、JS_InitClass
6、JS_DefineProperties

网上找的一个例子：

***************************************************************************** getter, constructer, destructer******
// 属性Getter函数
enum{ EQFRONT, EQBACK, EQSIZE, EQEMPTY, EQARRAY};
JSBool MyClassGetter(JSContext *cx, JSObject *obj, jsval id, jsval *vp)
{
std::deque<int>* pQ = (std::deque<int>*)JS_GetPrivate(cx, obj);
if(!JSVAL_IS_INT(id)) return JS_TRUE;
switch(JSVAL_TO_INT(id))
{
case EQFRONT:
if(pQ->empty()) return JS_FALSE;
*vp = INT_TO_JSVAL( pQ->front() );
break;

case EQBACK:
if(pQ->empty()) return JS_FALSE;
*vp = INT_TO_JSVAL( pQ->back() );
break;

case EQSIZE:
*vp = INT_TO_JSVAL( pQ->size() );
break;

case EQEMPTY:
*vp = BOOLEAN_TO_JSVAL( pQ->empty() );
break;

case EQARRAY: //数组操作
{
//用JS_NewArrayObject生成数组
JSObject *objA = JS_NewArrayObject(cx, 0, NULL);
jsint idx = 0;

for(std::deque<int>::iterator itr=pQ->begin(); itr!=pQ->end(); ++itr)
{
jsval v = INT_TO_JSVAL(*itr);
//用JS_SetElement加入指定索引的数据
JS_SetElement(cx, objA, idx++, &v);
}
*vp = OBJECT_TO_JSVAL(objA);
break;
}
break;
}
return JS_TRUE;
}

// "构造"
JSBool MyClassConstructor(JSContext *cx, JSObject *obj, uintN argc,
jsval *argv, jsval *rval)
{
std::deque<int> *pQ = new std::deque<int>();
JS_SetPrivate(cx, obj, pQ);
return JS_TRUE;
}

// "析造"
void MyClassDestructor(JSContext *cx, JSObject *obj)
{
std::deque<int>* pQ = (std::deque<int>*)JS_GetPrivate(cx, obj);
delete pQ;
}

******************************************class template*****************************************
// 定义类
JSClass myClass={
"MyClass", // name
JSCLASS_HAS_PRIVATE, // tags
JS_PropertyStub, JS_PropertyStub, // 添加、删除属性的回调 默认是 JS_PropertyStub
MyClassGetter, JS_PropertyStub, // get set方法
JS_EnumerateStub, // 遍历属性
JS_ResolveStub, // 解析不存在的属性
JS_ConvertStub, // 转成原子类型
MyClassDestructor // 析构函数
};

*******************************************class的函数表***************************************
// 类方法
JSBool QPush(JSContext *cx, JSObject *obj, uintN argc,
jsval *argv, jsval *rval)
{
std::deque<int>* pQ = (std::deque<int>*)JS_GetPrivate(cx, obj);
if(JSVAL_IS_INT(argv[0]))
{
pQ->push_back(JSVAL_TO_INT(argv[0]));
}
return JS_TRUE;
}

JSBool QPop(JSContext *cx, JSObject *obj, uintN argc,
jsval *argv, jsval *rval)
{
std::deque<int>* pQ = (std::deque<int>*)JS_GetPrivate(cx, obj);
if(!pQ->empty())
{
pQ->pop_front();
}
return JS_TRUE;
}

JSFunctionSpec myClassMethod[]={
JS_FS("push", QPush, 1, 0, 0), // 依次是name, notive func, argc, tags, extra
JS_FS("pop", QPop, 0, 0, 0),
JS_FS_END
};

*****************************************JS_InitClass****************************
JSObject * newobj = JS_InitClass(cx, objParent, NULL, // cx， global obj， prototype，
&myClass, MyClassConstructor, 0, // 类构成模板，构造函数，构造函数参数个数
NULL, myClassMethod, // prototype中的属性和方法
NULL, NULL); // 构造函数的属性和方法

**************************************JS_DefineProperties************************
JSPropertySpec myClassProp[]={
{"front", EQFRONT, JSPROP_READONLY}, // names, c实现中的唯一id, flags, get函数， set函数
{"back", EQBACK, JSPROP_READONLY},
{"size", EQSIZE, JSPROP_READONLY},
{"empty", EQEMPTY, JSPROP_READONLY},
{"array", EQARRAY, JSPROP_READONLY},
{0}
};

JS_DefineProperties(cx, newobj, myClassProp);