这篇文章的标题有些拗口,笔者简单解释一下。
本文是一款介绍开源API服务器Medge的文章。Medge是一个HTTP服务器,而其作者目前将其定位为API服务器方向。
在Medge中,我们可以通过脚本语言Melang来编写和实现API逻辑。Melang是一种抢占式调度的协程语言,其每一个脚本任务都被视为一个协程运行在同一个单一线程内部,依据执行步长轮询调度。因此,在上层逻辑开发过程中,开发者无需考虑协程调度问题,也就无需考虑何时该调用某些特定函数让出CPU执行权。
下面我们进入正题,看一个完整的简单使用示例。
使用示例
当我们安装好Medge后,我们可以在命令行中输入
$ medge
来启动HTTP服务器。
我们使用如下命令参数来启动Medge:
$ medge -p 8080 -d /opt/medge/ -w 1
这里,
-p
是用于指定该HTTP服务器监听的TCP端口号,若不设置默认为80。本例中HTTP监听0.0.0.0:8080
。-d
是用于指定API服务的统一入口目录路径,本例中是/opt/medge
。我们稍后会对这个目录下的结构进行说明。若不指定本参数项,则默认为/opt/medge
。-w
是用于指定HTTP的工作进程数。若不指定默认为1
。
此时,服务器已经启动了,但是我们还没有给出API服务的具体处理逻辑。那么下面我们就来增加API服务。
上面提到了Medge的-d
参数指定了API服务的统一入口目录,下面我们就给出这一路径下的大致目录树结构:
|- /opt/medge/
|- service_1/
|- entry.m
|- ...
|- service_2/
|- entry.m
|- ...
可以看到,在/opt/medge
目录下,存在两个服务,即:service_1
和service_2
,且每个服务下都有一个同名脚本文件entry.m
。entry.m
是服务的入口文件,即当Medge收到HTTP请求,找到对应服务后,就会立刻执行该服务的entry.m
脚本进行处理。
在我们的这个示例中,我们仅演示一个API服务,因此本例中的目录树结构为:
|- /opt/medge/
|- 127.0.0.1:8080/
|- entry.m
|- index.m
这里,127.0.0.1:8080
是一个目录,之所以起这样的名字,是因为Medge中的服务名是以HTTP请求的Host命名和区分的。因为本例不存在使用域名发起HTTP请求,所以这里的目录名称就是这样一个IP+端口的形式。
下面,我们给出entry.m
和index.m
的脚本内容:
//entry.m
/*
* Implement a simple controller.
* There are three variable injected in this script task:
* 1. Req. Its prototype is:
* Req {
* method; //string e.g. GET POST DELETE ...
* version; //string e.g. HTTP/1.0 HTTP/1.1
* uri; //string e.g. /index/index
* args; //an key-value array, e.g. ["key":"val", ...]
* headers; //an key-value array, e.g. ["Content-Type":"application/json", ...]
* body; //string
* }
*
* 2. Resp. Its prototype is:
* Resp {
* version; //same as Req's version
* code; //integer e.g. 200
* headers; //same as Req's headers
* body; //same as Req's body
* }
*
*. 3. Basedir. A string of the base directory path. (Not used in this example)
*/
#include "@/index.m"
str = Import('str');
sys = Import('sys');
uri = str.slice(Req.uri, '/');
ctlr = str.capitalize(uri[0]);
o = $ctlr;
if (sys.has(o, uri[1]) != 'method') {
Resp.code = 404;
} else {
o.__action__ = uri[1];
Resp.body = o.__action__();
Resp.headers['Content-Length'] = str.strlen(Resp.body);
}
//index.m
Json = Import('json');
Index {
@index() {
Resp.headers['Content-Type'] = 'application/json';
return Json.encode(['code': 200, 'msg': 'OK']);
}
}
可以看到,entry.m
前面包含了一些注释信息,其中提到,每个请求都会向其对应服务的entry.m
脚本中注入3个变量:
Req
包含了请求有关的信息,如:方法、版本、资源路径、参数、请求头和请求体。Resp
包含了响应有关的信息,如:版本(默认与请求版本一致)、响应状态码(默认为200)、响应头和响应体。Basedir
是一个字符串,内容为Medge-d
参数指定的路径。
简单来说,本例中的entry.m
实现了一个非常简单的MVC框架中的控制器,它根据资源路径找到对应的处理类和类方法,并调用它们来处理HTTP请求。
本例中,我们将使用如下命令发起HTTP请求:
$ curl -v http://127.0.0.1:8080/index/index
所以,entry
中会先对资源路径/index/index
进行切片,获取第一个index
后将其首字母大写。随后使用这个修改后的字符串作为类名,查找当前脚本环境中是否存在一个名为Index
的类。找到后,调用其index
(即资源路径的第二个index)方法处理请求。
在执行curl
命令后,我们将看到其输出大致为:
* Trying 127.0.0.1:8080...
* Connected to 127.0.0.1 (127.0.0.1) port 8080 (#0)
> GET /index/index HTTP/1.1
> Host: 127.0.0.1:8080
> User-Agent: curl/7.81.0
> Accept: */*
>
* Mark bundle as not supporting multiuse
< HTTP/1.1 200 OK
< Content-Length: 23
< Content-Type: application/json
<
* Connection #0 to host 127.0.0.1 left intact
{"code":200,"msg":"OK"}
结束语
目前Medge还只是个实验性项目,其中还有很多功能有待实现,例如目前它只支持HTTP/1.0 HTTP/1.1的版本,且暂未支持https。除此之外,目前Melang脚本仅支持MySQL数据库,且还没有对应的http库函数或类供开发者使用。
感兴趣的小伙伴可以访问其Github仓库。
感谢阅读!