Cowboy 用户指南 (六) - Listeners

监听器

监听器是一组在端口上监听新连接的进程。传入的连接由Cowboy处理。连接握手，可以使用一种或另一种协议。

这一章是针对Cowboy的。有关监听器的更多信息，请参阅Ranch User Guide。

Cowboy提供了两种类型的监听器:一种监听clear TCP连接，另一种监听Secure TLS连接。它们都支持HTTP/1.1和HTTP/2协议。

Clear TCP 监听器

clear TCP监听器将接受给定端口上的连接。典型的HTTP服务器将监听端口80。然而，端口80在大多数平台上需要特殊的权限，所以一个常见的替代方案是端口8080。

下面的代码片段开始监听端口8080上的连接:

start(_Type, _Args) ->
    Dispatch = cowboy_router:compile([
        {'_', [{"/", hello_handler, []}]}
    ]),
    {ok, _} = cowboy:start_clear(my_http_listener,
        [{port, 8080}],
        #{env => #{dispatch => Dispatch}}
    ),
    hello_erlang_sup:start_link().

入门章节使用了一个clear TCP监听器。

通过clear listener端口连接到Cowboy的客户端应该使用HTTP/1.1或HTTP/2。

Cowboy支持两种方法来发起一个清晰的HTTP/2连接:通过升级机制(RFC 7540 3.2)或通过直接发送序言(RFC 7540 3.4)。

与HTTP/1.0的兼容性是由Cowboy的HTTP/1.1实现提供的。

Secure TLS 监听器

安全TLS监听器将接受给定端口上的连接。典型的HTTPS服务器将监听端口443。但是，端口443在大多数平台上需要特殊的权限，所以一个常见的替代方案是端口8443。

Cowboy提供的功能将确保TLS选项在安全性方面遵循HTTP/2 RFC。例如，某些TLS扩展或密码可能被禁用。这也适用于此监听器上的HTTP/1.1连接。如果不希望这样，可以直接使用Ranch来设置自定义侦听器。

start(_Type, _Args) ->
    Dispatch = cowboy_router:compile([
        {'_', [{"/", hello_handler, []}]}
    ]),
    {ok, _} = cowboy:start_tls(my_https_listener,
        [
            {port, 8443},
            {certfile, "/path/to/certfile"},
            {keyfile, "/path/to/keyfile"}
        ],
        #{env => #{dispatch => Dispatch}}
    ),
    hello_erlang_sup:start_link().

通过secure 监听器连接到Cowboy的客户端希望使用ALPN TLS扩展来表明他们了解哪些协议。当同时支持HTTP/2和HTTP/1.1时，Cowboy总是偏爱HTTP/2而不是HTTP/1.1。当客户端不支持这两种协议时，或者当ALPN扩展缺失时，Cowboy希望使用HTTP/1.1。

为了兼容，Cowboy还通过旧的NPN TLS扩展宣传对HTTP/2的支持。但是请注意，当Cowboy 2.0发布时，这种支持可能不会被默认启用。

与HTTP/1.0的兼容性是由Cowboy的HTTP/1.1实现提供的。

停止监听器

当伴随着应用程序一起启动监听器时，最好在应用程序停止时也停止监听器。这可以通过在应用程序的stop函数中调用 cowboy:stop_listener/1 来实现:

When starting listeners along with the application it is a good idea to also stop the listener when the application stops. This can be done by calling cowboy:stop_listener/1 in the application's stop function:

stop(_State) ->
    ok = cowboy:stop_listener(my_http_listener).

协议配置

HTTP/1.1和HTTP/2协议共享相同的语义;只是它们的框架不同。第一个是文本协议，第二个是二进制协议。

Cowboy没有将HTTP/1.1和HTTP/2的配置分开。所有的东西都在同一个map上。很多选项都是共享的。