监听器
监听器是一组在端口上监听新连接的进程。传入的连接由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上。很多选项都是共享的。