Cowboy 用户指南 (三) - Introduction

介绍

Cowboy是面向Erlang/OTP的小型、快速、现代的HTTP服务器

Cowboy的目标是提供一个完整的现代Web堆栈。这包括HTTP/1.1, HTTP/2, Websocket,Server-Sent Events和Webmachine-based REST。

Cowboy提供了内省和跟踪功能,使开发人员能够在任何时候准确地知道发生了什么。它的模块化设计也使开发人员能够轻松地添加工具。

Cowboy是一个高质量的工程。它有一个小的代码库,非常高效(在延迟和内存使用方面),并且可以很容易地嵌入到另一个应用程序中。

Cowboy是干净的Erlang代码。它包括数百个测试,其代码完全符合Dialyzer(静态分析器)。它也有很好的文档,功能参考,用户指南和大量的教程。

预备知识

建议初学者有Erlang知识来阅读本指南.

HTTP协议的知识是推荐的,但不是必需的,因为它将在整个指南中详细介绍。

支持平台

Cowboy 在Linux、FreeBSD、Windows和OSX上进行了测试和支持。

Cowboy也在其他平台上工作,但我们不能保证体验会是安全和顺利的。在部署到其他平台之前,建议您进行必要的测试和安全审计。

Cowboy是为Erlang/OTP 22.0及以上的版本开发的。

许可证

Cowboy使用ISC许可证。

版权所有(c) 2011-2019, Loïc霍金<essen@ninenines.eu>

允许任何人使用、复制、修改和/或发布本软件

在上述情况下,此授权书的目的,不论是否收费

版权声明和本许可声明出现在所有副本中。

本软件按“原样”提供,作者不作任何保证

关于本软件包括所有的默示保证

适销性和健身。在任何情况下,作者概不负责

任何特殊、直接、间接或后果性损害赔偿或任何损害赔偿

任何因丧失使用、资料或利润而引致的损失,不论是否在

合同行为、过失行为或其他侵权行为

或与本软件的使用或性能有关。

版本控制

Cowboy使用语义版本控制2.0.0。.

约定

在HTTP协议中,方法名区分大小写。所有的标准方法名都是大写的。

报头名称不区分大小写。当使用HTTP/1.1时,Cowboy将所有请求头名称转换为小写。HTTP/2要求客户端以小写形式发送。任何其他报头名称都将以小写形式提供,包括在查询请求信息或发送响应时。

这同样适用于任何其他不区分大小写的值。

  • 0
    点赞
  • 1
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
好的,以下是一个简单的使用erlangcowboy框架编写的websocket聊天室代码示例。 ```erlang %% 定义路由和处理函数 -module(chat_router). -behaviour(cowboy_router). -export([init/3]). -export([routes/2]). init(_Transport, _Req, _Opts) -> {ok, [], undefined}. routes(_Req, _State) -> {[ {'_', [ {"/websocket", cowboy_websocket_handler, [ {callback, chat_handler}, {origin, "*"} ]} ]} ], _Req, _State}. %% 定义websocket处理函数 -module(chat_handler). -behaviour(cowboy_websocket_handler). -export([init/3]). -export([websocket_init/3]). -export([websocket_handle/3]). -export([websocket_info/3]). -export([websocket_terminate/3]). init(_TransportName, Req, _Opts) -> {ok, Req, undefined}. websocket_init(_TransportName, Req, _Opts) -> {cowboy_websocket, Req, undefined}. websocket_handle({text, Message}, Req, _State) -> %% 处理收到的文本消息 cowboy_websocket:broadcast(Message, Req), {ok, Req, undefined}; websocket_handle(_Data, Req, _State) -> {ok, Req, undefined}. websocket_info({join, _Pid, _Ref}, Req, _State) -> %% 处理新用户加入聊天室 cowboy_websocket:broadcast("New user joined", Req), {ok, Req, undefined}; websocket_info({leave, _Pid, _Ref}, Req, _State) -> %% 处理用户离开聊天室 cowboy_websocket:broadcast("User left", Req), {ok, Req, undefined}; websocket_info(_Info, Req, _State) -> {ok, Req, undefined}. websocket_terminate(_Reason, Req, _State) -> {ok, Req, undefined}. ``` 以上代码定义了一个路由模块`chat_router`,其中`routes/2`函数指定了处理`/websocket`路径的`cowboy_websocket_handler`处理函数,并将其回调函数指定为`chat_handler`。`chat_handler`模块中的`websocket_handle/3`函数用于处理接收到的文本消息,并使用`cowboy_websocket:broadcast/2`函数将消息广播给所有连接的客户端。`websocket_info/3`函数用于处理新用户加入和离开聊天室的事件,同样使用`cowboy_websocket:broadcast/2`函数将事件广播给所有连接的客户端。 您可以将以上代码保存为`chat.erl`文件,并使用cowboy框架启动websocket服务器,例如: ```erlang %% 启动websocket服务器 -module(chat). -behaviour(application). -export([start/2, stop/1]). start(_Type, _Args) -> Dispatch = cowboy_router:compile([ {'_', [{"/websocket", chat_handler, []}]} ]), {ok, _} = cowboy:start_clear(http, [{port, 8080}], #{env => #{dispatch => Dispatch}}), chat_sup:start_link(). stop(_State) -> ok. ``` 以上代码定义了一个应用模块`chat`,其中`start/2`函数启动了一个cowboy服务器,监听8080端口,并将路由配置为处理`/websocket`路径,使用`chat_handler`处理函数。您可以将以上代码保存为`chat_app.erl`文件,并使用`rebar3`编译和启动应用程序: ```sh $ rebar3 compile $ rebar3 shell ``` 在erlang shell中,您可以使用以下命令连接到websocket服务器并发送消息: ```erlang %% 连接到websocket服务器 1> {ok, Conn} = websocket:connect("ws://localhost:8080/websocket"). {ok,{websocket,#Port<0.7>,<0.198.0>}} %% 发送消息 2> websocket:send_text(Conn, "Hello, World!"). ok ``` 在另一个erlang shell中,您可以使用以下命令连接到相同的websocket服务器并接收消息: ```erlang %% 连接到websocket服务器 1> {ok, Conn} = websocket:connect("ws://localhost:8080/websocket"). {ok,{websocket,#Port<0.7>,<0.203.0>}} %% 接收消息 2> websocket:recv_text(Conn). "New user joined" 3> websocket:recv_text(Conn). "Hello, World!" ```

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值