Jx9 虚拟机

 一、Jx9 虚拟机的生命周期

• 加载 Jx9 脚本 jx9_compile() 或 jx9_compile_file()，加载编译成功后，Jx9 引擎将自动创建一个实例 （jx9_vm） 并且返回指向此虚拟机的指针用于后续调用。
  
• 如加载编译 Jx9 脚本时出现问题，也就是编译时出错，可调用jx9_config()方法获取编译错误原因。
  
• （可选） jx9_vm_config()，向脚本中传递参数（JX9_VM_CONFIG_ARGV_ENTRY）及注册虚拟机与脚本语言之间数据交互的回调函数（JX9_VM_CONFIG_OUTPUT）。
  
• （可选）jx9_create_function() ，用于注册可以从 Jx9 脚本调用的外部函数（通常是 C/C++ 实现的函数）。
  
• 执行Jx9 脚本 ，调用 jx9_vm_exec() 执行 Jx9 程序。
  
• jx9_vm_extract_variable() 用于提取在 Jx9 脚本中声明的另一个变量的内容。
  
• 重置虚拟机 使用 jx9_vm_reset()的虚拟机，然后返回到步骤 5，执行此操作零次或多次。
  
• 使用 jx9_vm_release() 销毁虚拟机。
  

 
二、Jx9 C/C++ API 参考

　　Jx9 - 可嵌入的脚本引擎 (symisc.net)
 
三、Jx9 虚拟机编写

1. //判断Jx9脚本文件是否存在
2. bool exists_jx9(string strJx9File) {
3.     struct stat buffer = { 0 };
4.     return (stat(strJx9File.c_str(), &buffer) == 0);
5. }

复制代码

1. //读取Jx9脚本文件
2. string read_jx9(string strJx9File)
3. {
4.     string strRet = _T("");
5.     size_t sJx9Size = 0;
6.     std::vector<char> vszBuffer;
7.     vszBuffer.clear();
9.     std::shared_ptr<std::iostream> pJx9Script =
10.         std::make_shared<std::fstream>(strJx9File, std::ios::in | std::ios::binary);
11.     pJx9Script->seekg(0, ios::end);
12.     sJx9Size = pJx9Script->tellg();
13.     pJx9Script->seekg(0);
14.     if (sJx9Size > 0)
15.     {
16.         vszBuffer.resize(sJx9Size);
17.         pJx9Script->read(&vszBuffer[0], sJx9Size);
18.         strRet.assign(vszBuffer.begin(), vszBuffer.end());
19.     }
20.     return strRet;
21. }

复制代码

1. //打印错误日志
2. void jx9_log(jx9* pEngine, int nResult)
3. {
4.     int nLen = 0;
5.     const char *zErrLog = nullptr;
6.     if (nResult != JX9_COMPILE_ERR) {
7.         return;
8.     }
9.     /* Extract error log */
10.     jx9_config(pEngine, JX9_CONFIG_ERR_LOG,
11.         &zErrLog, &nLen);
12.     if (nLen > 0) {
13.         /* zErrLog is null terminated */
14.         printf(zErrLog);
15.         printf("\n");
16.     }
17. }

复制代码

1. //回调函数
2. int Jx9_callback(
3.     const void *pOutput,
4.     unsigned int nOutputLen,
5.     void *pUserData /* Unused */)
6. {
7.     return JX9_OK;
8. }

复制代码

1. int main(int argc, char** argv)
2. {
3.     int nRes = -1;
4.     string strError = _T("");
5.     string strJx9File = _T("");
6.     string strJx9Script = _T("");
7.     if (argc < 2) {
8.         printf("参数不够！");
9.         return 1;
10.     }
12.     printf("——————————Jx9 begin——————————\n");
13.     strJx9File = string(argv[1]);
15.     jx9* pEngine = nullptr; /* JX9 engine handle*/
16.     jx9_vm* pVm = nullptr;  /* Compiled JX9 program */
17.     c_jx9_fun jx9Fun;
19.     //判断Jx9脚本是否存在
20.     if (!exists_jx9(strJx9File))
21.     {
22.         strError = "Jx9 脚本文件不存在！";
23.         goto main_end;
24.     }
26.     //读取Jx9脚本内容
27.     strJx9Script = read_jx9(strJx9File);
28.     if (strJx9Script.empty()) {
29.         strError = "Jx9 脚本文件为空！";
30.         goto main_end;
31.     }
33.     //初始化引擎
34.     nRes = jx9_init(&pEngine);
35.     if (nRes != JX9_OK) {
36.         strError = "Jx9 引擎初始化失败！";
37.         goto main_end;
38.     }
40.     //编译脚本
41.     nRes = jx9_compile(pEngine, strJx9Script.c_str(), strJx9Script.length(), &pVm);
42.     if (nRes != JX9_OK) {
43.         //
44.         jx9_log(pEngine, nRes);
45.         strError = "Jx9 引擎编译脚本失败！";
46.         goto main_end;
47.     }
49.     //注册回调函数
50.     nRes = jx9_vm_config(pVm,
51.         JX9_VM_CONFIG_OUTPUT,
52.         Jx9_callback,        /* Output Consumer callback */
53.         0                   /* Callback private data */
54.     );
55.     if (nRes != JX9_OK) {
56.         strError = "Jx9 注册回调函数失败！";
57.         goto main_end;
58.     }
60.     //开始执行
61.     nRes = jx9_vm_exec(pVm, 0);
62.     if (nRes != JX9_OK) {
63.         strError = "Jx9 执行失败！";
64.         goto main_end;
65.     }
66.     strError = "Jx9 执行成功！";
67. main_end:
68.     //释放
69.     if (pVm) {
70.         jx9_vm_release(pVm);
71.     }
72.     if (pEngine) {
73.         jx9_release(pEngine);
74.     }
75.     jx9_lib_shutdown();
77.     printf(strError.c_str());
78.     return 1;
79. }<br>

复制代码

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！