appweb的JavaScript调用C函数的实现过程（以设置eth0 IP地址为例）

dglwx

上次帖了交叉编译appweb带matrixssl运行在我的ARM9+linux开发板后，有不少CUer对这个东西很感兴趣。今天贴出appweb的独到之处:EJS调用底层的C函数的实现代码：
appweb-src-2.4.1\doc\guide\appweb\users\ejs\extending.html
appweb-src-2.4.1-latest\appweb-src-2.4.1\doc\api\gen\appweb\overview.html

可以结合：   源码\samples\C++\simpleModule以及  源码\samples\C\simpleEsp目录里的文件来学习。

C++ 代码（ethernetModule.cpp）：  

1. 
   
2. #include        "ethernetModule.h"
   
3. 
   
4. #include <stdio.h>
   
5. #include <stdlib.h>
   
6. #include <string.h>
   
7. #include <errno.h>
   
8. #include <unistd.h>
   
9. 
   
10. #include <sys/types.h>
    
11. #include <sys/socket.h>
    
12. #include <netinet/in.h>
    
13. #include <arpa/inet.h>
    
14. 
    
15. #include <sys/ioctl.h>
    
16. #include <net/if.h>
    
17. 
    
18. 
    
19. static int set_ipaddr(const int sockfd, const char *ifname, char *ip);
    
20. static int set_netmask(const int sockfd, const char *ifname, char *netmask);
    
21. 
    
22. int mprEthernetModuleInit(void *handle)
    
23. {
    
24.         new EthernetModule(handle);
    
25.         return 0;
    
26. }
    
27. 
    
28. EthernetModule::EthernetModule(void *handle) : MaModule("ethernetModule", handle)
    
29. {
    
30.                //这里将我们的C函数setEthernet()与EJS（Embedded JavaScript）函数setEthernet()绑定,这样我们在ESP就可以调用底层的C函数了。
    
31.                 espDefineStringCFunction(0, "setEthernet", setEthernet, 0);   
    
32. }
    
33. 
    
34. EthernetModule::~EthernetModule()
    
35. {
    
36. }
    
37. 
    
38. int EthernetModule::parseConfig(char *key, char *value, MaServer *server,
    
39.         MaHost *host, MaAuth *auth, MaDir* dir, MaLocation *location)
    
40. {
    
41.         if (mprStrCmpAnyCase(key, "ethernetDirective") == 0)
    
42.                 return 1;
    
43.         return 0;
    
44. }
    
45. 
    
46. int EthernetModule::start()
    
47. {
    
48.         return 0;
    
49. }
    
50. 
    
51. void EthernetModule::stop()
    
52. {
    
53. }
    
54. 
    
55. /*
    
56. * Function                :        Set IP address, netmask for eth1
    
57. * Usage                :        setEthernet(ipaddr, netmask);
    
58. * Return value        :          MprVar status
    
59. */
    
60. 
    
61. static int setEthernet(EspRequest *ep, int argc, char **argv)
    
62. {
    
63.         char                    *ifname="eth1";
    
64.         char                    *ip, *netmask;
    
65.                int                     sockfd, ret;
    
66.                 struct                 in_addr        addr;       
    
67.                 MprVar                 status;
    
68.                 status = espCreateObjVar("setStatusObj", 0);
    
69. 
    
70.                 ip = argv[0];
    
71.                 netmask = argv[1];
    
72.                
    
73.                 if( (ret=inet_pton(AF_INET, ip, &addr)<=0) || (ret=inet_pton(AF_INET, netmask, &addr)<=0) )
    
74.                 {   
    
75.                         status = mprCreateIntegerVar(0);               
    
76.                         goto ret;
    
77.                 }
    
78. 
    
79.                 if((sockfd = socket(PF_INET, SOCK_STREAM, 0)) < 0)
    
80.                 {   
    
81.                         status = mprCreateIntegerVar(0);               
    
82.                         goto ret;
    
83.                 }
    
84. 
    
85.                 if ((!set_ipaddr(sockfd, ifname, ip)) || (!set_netmask(sockfd, ifname, netmask)) )
    
86.                 {   
    
87.                         status = mprCreateIntegerVar(0);               
    
88.                         goto ret;
    
89.                 }
    
90.                   
    
91.                 status = mprCreateIntegerVar(1);
    
92.                
    
93.                 ret:
    
94.                 espSetReturn(ep, status);
    
95.                 espDestroyVar(&status);
    
96. 
    
97.                 return 0;
    
98. }
    
99. 
    
100. 
     
101. static int set_ipaddr(const int sockfd, const char *ifname, char *ip)
     
102. {
     
103.         struct  sockaddr_in     addr;
     
104.         struct  ifreq           ifr;
     
105.                 int                ret = 1;  //set status:   0->Failture 1->Success
     
106. 
     
107.         bzero(&addr, sizeof(addr));
     
108.         addr.sin_family = AF_INET;
     
109.                 inet_aton(ip,&addr.sin_addr);
     
110. 
     
111.         strncpy(ifr.ifr_name, ifname, IFNAMSIZ-1);
     
112. 
     
113.         memcpy(&ifr.ifr_addr,(struct sockaddr *)&addr, sizeof(addr));
     
114. 
     
115.         if(ioctl(sockfd, SIOCSIFADDR, &ifr) == -1)
     
116.                                 ret = 0;
     
117. 
     
118.         return ret;
     
119. }
     
120. 
     
121. 
     
122. static int set_netmask(const int sockfd, const char *ifname, char *netmask)
     
123. {
     
124.         struct  sockaddr_in     addr;
     
125.         struct  ifreq           ifr;
     
126.                 int                ret = 1;  //set status:   0->Failture 1->Success
     
127. 
     
128.         bzero(&addr, sizeof(addr));
     
129.         addr.sin_family = PF_INET;
     
130.         inet_aton(netmask,&addr.sin_addr);
     
131. 
     
132.         strncpy(ifr.ifr_name, ifname, IFNAMSIZ-1);
     
133.         memcpy(&ifr.ifr_netmask,(struct sockaddr *)&addr, sizeof(addr));
     
134. 
     
135.         if(ioctl(sockfd, SIOCSIFNETMASK, &ifr) == -1)
     
136.                                 ret = 0;
     
137. 
     
138.         return ret;
     
139. }
     

复制代码

上层的EJS网页代码(ethernetSet.esp)：

1. 
   
2. <html>
   
3.         <head>
   
4.                 <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
   
5.                 <title>Set ethernet IP address</title>
   
6.       </head>
   
7.        
   
8.   
   
9.         <body>
   
10.         <%if(session['username']){%>           //判断用户是否登录，如果登录就显示该页
    
11.        
    
12.      <div class="mainTitle marginAuto" id="title">Ethernet IP Setting</div>
    
13.         <div class="mainBox marginAuto">
    
14.                 <div class="mainContent">
    
15.                 <div class="innerContent">
    
16. 
    
17.                                         <form method="POST" action="@@request['SCRIPT_NAME']" >  //提交表单
    
18.                                                 <table class="inputForm" border=0>
    
19.                                                         <tr>
    
20.                                                                 <td><b>IP Address</b></td>
    
21.                                                                 <td><input name="ip" type="text" value="@@form['ip']" onBlur="validIP(this,0);"></td>
    
22.                                                         </tr>
    
23.                                                         <tr>
    
24.                                                                 <td><b>Netmask</b></td>
    
25.                                                                 <td><input name="netmask" type="text" value="@@form['netmask']" onBlur="validIP(this,1)"></td>
    
26.                                                         </tr>
    
27.                                                 </table>
    
28.                                                 <input type="submit"  value="Submit">
    
29.                                                 <input type="reset" value="Reset">
    
30.                                   </form>
    
31. 
    
32.                                 <%        
    
33.                                         if (request["REQUEST_METHOD"] == "POST")   //处理提交的表单
    
34.                                         {
    
35.                                                 var ret;
    
36. //form['ip']为表单提交的值,并调用上面写的C代码来设置IP地址，这里底层的C函数能返回MprVar（Object）类型值，或string。
    
37.                                                 ret = setEthernet(form['ip'], form['netmask']);   
    
38.                                                 if(0 == ret)   
    
39.                                                         write("Set failure: Make sure the input IP address is a valid IPv4 address.</br>");
    
40.                                                 else
    
41.                                                 {
    
42.                                                         write("The set IP address: " + form['ip'] + "</br>");
    
43.                                                         write("The set netmask address: " + form['netmask'] + "</br>");
    
44.                                                 }  
    
45.                                         }
    
46.                                 %>
    
47. 
    
48.                  </div>
    
49.          </div>
    
50.      </div>
    
51. 
    
52.         <%
    
53.                 }
    
54.                 else
    
55.                 {
    
56.                         redirect("login.esp");  //如果没登录，就转到login.esp去登录。
    
57.                 }
    
58.         %>               
    
59. 
    
60.         </body>
    
61. </html>
    

复制代码

上面的C++函数需要编译成动态库，然后在appweb.conf里加载这个模块,使这个函数作为appweb的一部分，这样方能使用EJS调用底层的C函数。

dglwx

上面只给出了源代码，并没有给出实现的过程，这里还是一道奉上：

在appweb-src-2.4.1\samples\C++\simpleModule 拷贝一份，并更名为ethernetModule，将上面的ethernetModule.cpp 源代码放到该目录下，并将所有文件里的simpleModule改为ethernetModule（注意有大小写）。参考simpleModule改。

然后执行make，如果是交叉编译，他会到找上层Makefile中设置的交叉编译器来进行交叉编译。Make后会得到ethernetModule.so，将其更名为libethernetModule.so并放到appweb指定的动态库路径下，也可以通过LD_LIBRARY_PATH环境变量来指定。

修改appweb.conf （118行左右）为：

LoadModulePath "../lib/arm-atmel-linux/modules"
＃这个路径即为appweb寻找动态库的路径，也可以通过LD_LIBRARY_PATH环境变量来指定。

        LoadModule ethernetModule libethernetModule

<if SSL_MODULE>
        LoadModule ssl libsslModule

        <if MATRIXSSL_MODULE>
                LoadModule matrixSsl libmatrixSslModule
        </if>

        <if OPENSSL_MODULE>
                LoadModule openSsl libopenSslModule
        </if>
</if>

重启appweb,这时appweb就会像加载所有其他模块一样（如matrixssl）一样加载我们的ethernetModule.so（可以通过看logs/error.log检查是否加载成功）.这样就可以在ethernetSet.esp顺利的调用 ret = setEthernet(form['ip'], form['netmask']);

顺便提一句： appweb和我们的c/c++程序都是运行在同一个进程环境下，这样我们必须保证我们的C/C++代码不能出现任何错误（段错误）导致进程退出。有一次，我就在一行C代码里调用了exit(),结果每导致执行一次该页面，服务器就down掉一次，害得我郁闷了好几天。


PS： 这两天开始移植uclinux到我们的ARM7开发板，发现appweb已经加到uClinux源码包里了。看到appweb是那么的眼熟，寒个先........

[ 本帖最后由 dglwx 于 2008-11-26 08:46 编辑 ]

bitmilong

这么好的帖子,居然漏掉了加精华,真是不好意思

感谢分享

zhangyongblesky

您好，我最近在学习appweb，有些问题想请教你一下：
     1.麻烦您说一下esp是什么概念，它是一种脚本语言吗？与ejscript有区别吗？
     2.在esp中内嵌c语言，是可以添加任意功能的c代码程序吗？
麻烦您了，谢谢。