GoAhead_Developer’s Guide

1.Embedding GoAhead

当嵌入GoAhead到应用或者系统中，需要做两样调整：
1.使用已经存在的GoAhead 主程序，通过javascript和goforms扩展GoAhead。
2.自定义main主程序链接GoAhead Library。

1.1 The GoAhead Program

名为goahead的程序包含完整的HTTP Server特性的程序。可以修改goahead.c主程序定制自己相关的应用。

1.2 Embed the GoAhead Library

可以连接GoAhead库在应用程序中，从而使能监听HTTP请求。嵌入GoAhead库非常简单，只需要一行代码就可以搞定。

1.3 Linking with the GoAhead Library

1.在源文件中加入#include “goahead.h”
2.将GoAhead library加入到Makefile或者Windows 工程文件中。即增加libgo.lib（Windows平台）或libgo.a（Unix平台）
3.使用嵌入式APIs创建HTTP 服务

1.4 Full Control API

GoAhead library提供大量的API供用户使用，所以用户可以准确的控制web server在何时何地启动和配置。
下面的例子创建一个web Server ，使用”Server.conf”配置文件配置，server events直至程序终结。

1.5 Extending via Javascript

GoAhead的Javascript web 框架允许用户直接将Javascript 代码嵌入到HTM页面中从而定制满足需求的页面。在返回网页到浏览器前，JavaScript代码在服务端已经运行。

2. Creating GoAhead Handlers

GoAhead响应用户请求，通过将请求导向至对应的请求响应/处理程序(request handlers). 请求响应程序负责产生反馈内容或者将请求重定向到其他合适的响应程序。
GoAhead为标准内容类型和web框架提供了一系列handlers。用户同时可以自定义handler去处理HTTP请求。创建的handlers通过路由表配置。

2.1 Request Processing（请求过程）

当一个请求从客户端到达，GoAhead解析HTTP请求并决定该请求的最优路径。一条路径包含了如果处理该请求的全部内容，包括请求处理程序和请求认证。GoAhead顺序匹配每一条路径，选择第一次匹配的路径。

2.1.1 Matching a Handler

选择route的最后一步就是调用match()回调函数，如果返回true，则某handler被选择。如果返回false，该handler被跳过，路径选择流程将继续执行。

2.1.2 Running a Handler

一旦某路径被选择，GoAhead唤醒该处理程序服务回调函数去处理请求并产生反馈。此时，请求实体数据将被接收到和存入缓存。处理程序也许选择不处理返回0状态码的。在该情况下，路由引擎继续匹配路由表为了能找到合适的路由和处理程序相结合。

2.2 Generating Response

一个HTTP响应包括状态码，一系列HTTP响应头和可选的返回体。如果状态没有被设置，200状态码将被使用。如果没有自定义头被定义，一个最小标准的设置将被生成。

2.2.1 Setting Status and Headers

websSetStatus 设置响应状态。响应头设置websWriteHeaders. 举例：

websWriteBlock函数会将在后台写入到客户端的写入数据(written)缓存下来。

2.2.2 Genrating an Error Response

如果请求有错误，在websError中设置了状态和错误消息。websError中提供的响应文字代替其他响应body, 并且conn->error被设置，从而管道处理将被缩短，处理函数回调函数不再被调用。因此，如果你需要继续进行响应处理，而且需要返回一个非0状态，那么不要使用websError。而使用websSetStatus更合适些。

2.2.3 Aborting Requests

websError支持接收flags从而控制socket连接。如果带上WEBS_CLOSE 返回，当请求结束时，连接会被关闭。通常该连接会保持开放状态等待下一次的socket连接。

2.2.4 Redirecting

将请求导向另一个URI

2.2.5 Generating Response Body

最简单的方式就是通过websWrite产生响应。websWrite自动刷新请求的数据。该函数可能被阻塞，当反馈给客户端的数据无法被缓存时。查看main.bit配置文件内的限制：LimitBuffer 控制着内部缓存的大小。当所有的数据都被写入后，调用：websDone. 结束该请求。

websWrite(p, "Hello World\n");
websDone(wp);

2.3 Defining a Handler

调用websDefineHandler

static bool matchFoo(Webs *wp)
{
    /* Handle request */
    return 1;
}
static bool serviceFoo(Webs *wp)
{
    /* Do work here */
    return 1;
}
static void closeFoo() {
    /* Cleanup when goahead is exiting */
}
...
websDefineHandler("foo", matchFoo, serviceFoo, closeFoo, 0);

3.Creating Password Sotre Verifiers

通过定义password 验证程序，用户可以使用定制的password存储。websSetPasswordSroteVerify