Current section

Files

Jump to
grpc lib grpc transport http2.ex
Raw

lib/grpc/transport/http2.ex

defmodule GRPC.Transport.HTTP2 do
@moduledoc false
# A module providing functions for sending HTTP/2 requests.
alias GRPC.Transport.Utils
alias GRPC.Status
require Logger
def server_headers(%{codec: GRPC.Codec.WebText = codec}) do
%{"content-type" => "application/grpc-web-#{codec.name()}"}
end
def server_headers(%{codec: codec}) do
%{"content-type" => "application/grpc+#{codec.name()}"}
end
@spec server_trailers(integer, String.t()) :: map
def server_trailers(status \\ Status.ok(), message \\ "") do
%{
"grpc-status" => Integer.to_string(status),
"grpc-message" => URI.encode(message)
}
end
@doc """
Now we may not need this because gun already handles the pseudo headers.
"""
@spec client_headers(GRPC.Client.Stream.t(), keyword()) :: [{String.t(), String.t()}]
def client_headers(%{channel: channel, path: path} = s, opts \\ []) do
[
{":method", "POST"},
{":scheme", channel.scheme},
{":path", path},
{":authority", channel.host}
] ++ client_headers_without_reserved(s, opts)
end
@spec client_headers_without_reserved(GRPC.Client.Stream.t(), keyword()) :: [
{String.t(), String.t()}
]
def client_headers_without_reserved(%{codec: codec} = stream, opts \\ []) do
[
# It seems only gRPC implemenations only support "application/grpc", so we support :content_type now.
{"content-type", content_type(opts[:content_type], codec)},
{"user-agent", "grpc-elixir/#{opts[:grpc_version] || GRPC.version()}"},
{"te", "trailers"}
]
|> append_compressor(stream.compressor)
|> append_accepted_compressors(stream.accepted_compressors)
|> append_custom_metadata(stream.channel.headers)
|> append_encoding(opts[:grpc_encoding])
|> append_timeout(opts[:timeout])
|> append_custom_metadata(stream.headers)
|> append_custom_metadata(opts[:metadata])
# TODO: grpc-accept-encoding, grpc-message-type
# TODO: Authorization
end
defp content_type(custom, _codec) when is_binary(custom), do: custom
# Some gRPC implementations don't support application/grpc+xyz,
# to avoid this kind of trouble, use application/grpc by default
defp content_type(_, GRPC.Codec.Proto), do: "application/grpc"
defp content_type(_, codec = GRPC.Codec.WebText), do: "application/grpc-web-#{codec.name()}"
defp content_type(_, codec), do: "application/grpc+#{codec.name()}"
def extract_metadata(headers) do
headers
|> Enum.filter(fn {k, _} -> is_metadata(k) end)
|> Enum.into(%{}, &decode_metadata/1)
end
def decode_headers(headers) do
Enum.into(headers, %{}, fn {k, v} ->
if is_metadata(k) do
decode_metadata({k, v})
else
decode_reserved({k, v})
end
end)
end
def encode_metadata(metadata) do
metadata
|> Enum.filter(fn {k, _v} -> !is_reserved_header(to_string(k)) end)
|> Enum.reduce(%{}, fn {k, v}, acc ->
{new_k, new_v} = encode_metadata_pair({k, v})
Map.update(acc, new_k, new_v, fn old_v -> Enum.join([old_v, new_v], ",") end)
end)
end
defp append_encoding(headers, grpc_encoding) when is_binary(grpc_encoding) do
Logger.warn("grpc_encoding option is deprecated, please use compressor.")
[{"grpc-encoding", grpc_encoding} | headers]
end
defp append_encoding(headers, _), do: headers
defp append_compressor(headers, compressor) when not is_nil(compressor) do
[{"grpc-encoding", compressor.name()} | headers]
end
defp append_compressor(headers, _), do: headers
defp append_accepted_compressors(headers, [_] = compressors) do
encoding = Enum.map_join(compressors, ",", & &1.name())
[{"grpc-accept-encoding", encoding} | headers]
end
defp append_accepted_compressors(headers, _), do: headers
defp append_timeout(headers, timeout) when is_integer(timeout) do
[{"grpc-timeout", Utils.encode_timeout(timeout)} | headers]
end
defp append_timeout(headers, _), do: headers
defp append_custom_metadata(headers, metadata) when is_map(metadata) or is_list(metadata) do
Enum.to_list(encode_metadata(metadata)) ++ headers
end
defp append_custom_metadata(headers, _), do: headers
defp encode_metadata_pair({key, val}) when not is_binary(key) do
encode_metadata_pair({to_string(key), val})
end
defp encode_metadata_pair({key, val}) when not is_binary(val) do
encode_metadata_pair({key, to_string(val)})
end
defp encode_metadata_pair({key, val}) do
val = if String.ends_with?(key, "-bin"), do: Base.encode64(val), else: val
{String.downcase(to_string(key)), val}
end
defp decode_metadata({key, val}) do
val = if String.ends_with?(key, "-bin"), do: Base.decode64!(val, padding: false), else: val
{key, val}
end
defp decode_reserved({"grpc-message" = key, val}) do
{key, URI.decode(val)}
end
defp decode_reserved(kv), do: kv
defp is_reserved_header(":" <> _), do: true
defp is_reserved_header("grpc-" <> _), do: true
defp is_reserved_header("content-type"), do: true
defp is_reserved_header("te"), do: true
defp is_reserved_header(_), do: false
defp is_metadata("content-length"), do: false
defp is_metadata("user-agent"), do: false
defp is_metadata(key) do
!is_reserved_header(key)
end
end