Cowboy
cowboy指南:Nine Nines: Cowboy User Guide
Cowboy是一个小型、快速和现代化的Erlang/OTP HTTP服务器,这意味着我们可以很方便轻松地通过Cowboy来实现一个http服务器。
rebar和cowboy的教学后续更新
开始教学!
创建项目
准备内容
首先,我们需要准备开发ide(这里用了idea作为开发ide)、Erlang/OTP(这里用的OTP25.3)、rebar3(以及windows环境下会用到的rebar3.cmd)
附上部分内容下载地址:
erlang:Downloads - Erlang/OTP
rebar3:https://github.com/erlang/rebar3/archive/refs/heads/main.zip
rebar3需要依赖于erlang,所以需要先安装erlang并设置环境变量后再跑rebar3,windows情况下双击
bootstrap.bat
运行后就会在文件夹内生成rebar3和rebar3.cmd了
新建app
将rebar3和rebar3.cmd放到工作目录中,打开cmd在目录里执行rebar3 new app $app_name
(这里的$app_name是自己定的,我这边用了cowboy_test,所以后续都用cowboy_test表示app名字),
会发现生成了以自己设定的名字生成的文件夹,里面有一个rebar.config文件和一些其他文件,接下来我们把rebar3和rebar3.cmd移入文件夹内方便后续运行
idea用户可以顺便新建一下工作目录:File -> New -> Project from Existing Source,选择生成的文件夹,会自动勾选Rebar model,点击next后可以设置rebar路径,设置为rebar3所在的路径,之后一路next就可以啦
这时候我们就得到了一个全新的rebar构建的app
rebar配置
因为我们需要用到cowboy,所以我们需要将cowboy加入到依赖项中,共有两个地方需要添加:
rebar.config文件:在{deps, []}.的中括号里加上{cowboy, “2.10.0”},表示rebar需要下载cowboy依赖,也就是这一行变成:{deps, [{cowboy, “2.10.0”}]}. 后续有新增依赖的时候也是在列表中继续以元组的形式增加依赖
src/cowboy_test.app.src文件:在{applications, [kernel,stdlib]},的后面加上cowboy,表示app内会用到cowboy依赖,也就是这一行变成:{applications, [kernel,stdlib,cowboy]},
配置加好之后,我们需要编译下载添加的依赖:
没有idea:我们在工作目录中打开cmd,运行
rebar3 compile
,就可以下载依赖有idea:在Run -> Configurations里新加一个Erlang Rebar命令,command只需要compile,保存之后点击run即可完成编译
如果编译完成之后看到一个cowboy_test/_build文件夹,说明编译完成
cowboy启动
cowboy里最常用到的三个方法:
cowboy_router:compile/1(用于编译访问映射)
cowboy:start_clear/3(用于监听指定端口)
cowboy_req:reply/4(用于发送消息)
在项目启动时会执行cowboy_test_app:start/2,所以我们在这里加一个开启cowboy监听的函数start_cowboy/0
-module(cowboy_test_app).
start(_StartType