Plug v1.8.3 Plug.Conn.Adapter behaviour View Source
Specification of the connection adapter API implemented by webservers
Link to this section Summary
Callbacks
Sends a chunk in the chunked response.
Returns the HTTP protocol and its version.
Returns peer information such as the address, port and ssl cert.
Send an informational response to the client.
Push a resource to the client.
Reads the request body.
Sends the given status, headers as the beginning of a chunked response to the client.
Sends the given status, headers and file as a response back to the client.
Sends the given status, headers and body as a response back to the client.
Link to this section Types
http_protocol()
View Sourcehttp_protocol() :: :"HTTP/1" | :"HTTP/1.1" | :"HTTP/2" | atom()
peer_data()
View Sourcepeer_data() :: %{ address: :inet.ip_address(), port: :inet.port_number(), ssl_cert: binary() | nil }
Link to this section Callbacks
chunk(payload, arg2)
View Sourcechunk(payload(), Plug.Conn.status()) :: :ok | {:ok, sent_body :: binary(), payload()} | {:error, term()}
Sends a chunk in the chunked response.
If the request has method "HEAD"
, the adapter should
not send the response to the client.
Webservers are advised to return :ok
and not modify
any further state for each chunk. However, the test
implementation returns the actual body and payload so
it can be used during testing.
get_http_protocol(payload)
View Sourceget_http_protocol(payload()) :: http_protocol()
Returns the HTTP protocol and its version.
Returns peer information such as the address, port and ssl cert.
inform(payload, arg2, headers)
View Sourceinform(payload(), Plug.Conn.status(), headers :: Keyword.t()) :: :ok | {:error, term()}
Send an informational response to the client.
If the adapter does not support inform, then {:error, :not_supported}
should be returned.
Push a resource to the client.
If the adapter does not support server push then {:error, :not_supported}
should be returned.
Reads the request body.
Read the docs in Plug.Conn.read_body/2
for the supported
options and expected behaviour.
send_chunked(payload, arg2, arg3)
View Sourcesend_chunked(payload(), Plug.Conn.status(), Plug.Conn.headers()) :: {:ok, sent_body :: binary() | nil, payload()}
Sends the given status, headers as the beginning of a chunked response to the client.
Webservers are advised to return nil
as the sent_body,
as the body can no longer be manipulated. However, the
test implementation returns the actual body so it can
be used during testing.
send_file(payload, arg2, arg3, file, offset, length)
View Sourcesend_file( payload(), Plug.Conn.status(), Plug.Conn.headers(), file :: binary(), offset :: integer(), length :: integer() | :all ) :: {:ok, sent_body :: binary() | nil, payload()}
Sends the given status, headers and file as a response back to the client.
If the request has method "HEAD"
, the adapter should
not send the response to the client.
Webservers are advised to return nil
as the sent_body,
as the body can no longer be manipulated. However, the
test implementation returns the actual body so it can
be used during testing.
send_resp(payload, arg2, arg3, arg4)
View Sourcesend_resp(payload(), Plug.Conn.status(), Plug.Conn.headers(), Plug.Conn.body()) :: {:ok, sent_body :: binary() | nil, payload()}
Sends the given status, headers and body as a response back to the client.
If the request has method "HEAD"
, the adapter should
not send the response to the client.
Webservers are advised to return nil
as the sent_body,
as the body can no longer be manipulated. However, the
test implementation returns the actual body so it can
be used during testing.