对 goahead Web服务器的学习（一）

GoAhead WebServer是一个功能强大、可以在多个平台运行的嵌入式WebServer，至于其特性就不多说了，本篇以在ubuntu系统上构建简单的动态网页为例说明使用goahead进行web开发的一般步骤，至于goahead在其他平台上的移植，后面的文章里再专门详细介绍。

使用的版本为goahead-2.1.8，好吧，这个版本确实比较老了，官方已经结束对此版本的支持，目前官网最新的版本为4.0.1，可以前往下载—–下载链接，但是2.1.8版本代码量较少，更容易理清代码结构，比较适合新手入门。

先介绍下goahead用来构建动态网页的两个重要的过程：

ASP过程
GoForms过程（从3.X版本开始更新为GoActions过程，简化了使用，但调用方法基本不变）

asp过程用于在网页中动态显示内容，而goforms过程用于响应用户输入，更新设置或执行特定动作。

一般步骤：

构建web网页，一般为后缀.asp的asp网页文件，动态内容用特定的ASP过程名代替，使用<% %>将过程名包裹，也称一个占位符。

在某个.c文件中定义与ASP过程对应的C函数，函数原型static int AspName(int eid, webs_t wp, int argc, char_t argv)，然后在**main函数中的initWebs()函数中使用websAspDefine()将ASP过程和C函数关联起来。

类似地，某个.c文件中定义与GoForms过程对应的C函数，函数原型static void FormName(webs_t wp, char_t *path, char_t *query)，同样在main函数中的initWebs()函数中使用websFormDefine()将GoForms过程和C函数关联起来。

下面以在页面上实现一个可以输入姓名和年龄的网页为例

首先在web目录下创建一个asp文件，命名为MyTest.asp

<html>
<head>
<title>My Test</title>
<link rel="stylesheet" href="style/normal_ws.css" type="text/css">
<% language=javascript %>
</head><body>
<h1>My Test</h1>
<!- 创建一个form表单，goforms会解释为以/goforms开头的URIs ->
<form action=/goform/FormMyTest method=POST><table>
<tr>
<!- 在需要动态显示内容处用ASP过程名代替，格式如下，用<% %>包裹，页面执行到这里 ->
<!- 会跳转到与ASP过程关联的C函数执行内容显示到页面上，之后继续返回页面执行     -><td>Name:</td><td><input type="text" name="name" size=50 value="<% AspMyTest("name"); %>" ></td>
</tr>
<tr><td>Age:</td><td><input type="text" name="age" size=50 value="<% AspMyTest("age"); %>" ></td>
</tr>
<tr><td></td><td ALIGN="CENTER"> <input type="submit" name="apply" value="Apply"> <input type="submit" name="cancel" value="Cancel"></td>
</tr>
</table>
</form>
</body>
</html>

GoForms会绑定到以 /goform/开头的URI。当一个客户端请求一个URI /goform/NAME 时就会调用该动作处理程序，然后通过NAME查找GoForm。之后调用绑定到NAME的C函数，来为请求提供服务。

接下来定义一个用来关联ASP过程的C函数

为了方便我们就在LINUX/main.c中直接定义吧
先定义两个全局变量用来存储name和age：

char_t      g_test_name[32] = {0};
unsigned int g_test_age;

/* 与ASP过程绑定的C函数     */
static int AspMyTest(int eid, webs_t wp, int argc, char_t **argv)
{char_t  *name;char_t buffer[128];/* 判断参数是否过少 */if (ejArgs(argc, argv, T("%s"), &name) < 1) {websError(wp, 400, T("Insufficient args\n"));return -1;}/* 根据页面上input标签内的name属性判断将什么变量显示到页面上对应的文本框内 */if (!strcmp(name,T("name"))){   sprintf(buffer, "%s", g_test_name);return websWrite(wp, T("%s"),buffer);//websWrite()是goahead的API，可以将内容写回html页面}else if (!strcmp(name,T("age"))){sprintf(buffer, "%d", g_test_age);  return websWrite(wp, T("%s"),buffer);}else{return -1;}
}

接下来定义一个用来关联GoForms过程的C函数
同样定义在main.c中吧~

static void FormMyTest(webs_t wp, char_t *path, char_t *query)
{char_t *strval = NULL;strval = websGetVar(wp, T("name"), T(""));/* websGetVar()可以从页面取出文本框内的数据 */if (NULL != strval){/* 将从页面上取出的数据存入全局变量中 */strcpy(g_test_name, strval);}strval = websGetVar(wp, T("age"), T(""));if (NULL != strval){g_test_age = atoi(strval);}websHeader(wp);websFooter(wp);websDone(wp, 200);
}

在文件开始将两个函数声明一下

static int AspTestGet(int eid, webs_t wp, int argc, char_t **argv);
static void FormMyTest(webs_t wp, char_t *path, char_t *query);

在initWebs函数中将过程与C函数关联

使用websAspDefine()将ASP过程与C函数关联起来

websAspDefine(T("AspMyTest"), AspMyTest);

使用websFormDefine()将Goforms过程与C函数关联起来

websFormDefine(T("FormMyTest"), FormMyTest);

编译生成可执行文件

进入LINUX目录，执行make（因为本次在ubuntu下编译，所以不需要修改Makefile），编译完成后会生成可执行文件webs

执行程序测试效果

./webs &

浏览器中输入本机ip地址后跟网页文件名访问我们创建的网页，如
127.0.0.1/MyTest.asp

为便于验证，开启两个同样的网页，一个进行操作，另一个及时观察数据的变化。
输入网址后出现网页如下：

我们分别向两个输入框中输入随意内容，如”admin”，”21”，点击Apply按钮提交输入。（提交时会调用GoForms过程将输入的内容写入C函数中的全局变量）

然后我们重新打一个同样的网页，发现数据已经被成功提交并显示在当前页面上了。（界面显示时会调用ASP过程从全局变量取出来，显示到页面上）

结束