Commits on Sep 6, 2024

1. Add incoming and outgoing handlers for HTTP/2 …

   This PR adds the interfaces `http2-incoming-handler` and `http2-outgoing-handler` and the world `http2-proxy`, which exports and imports those interfaces, respectively.
   
   Additionally, it adds the variant `types.http-version` and a method `http-version()-> http-version` to both `types.incoming-request` and `types.incoming-response`.
   
   The motivation for these additions is that there are use cases that require specifically HTTP/2 to be used for both incoming and outgoing connections, so wasi-http should provide a way to enforce this requirement.
   
   Most notably, gRPC is specified as layered on top of HTTP/2, not HTTP more generally, so attempting to transport it over HTTP/1.1 or HTTP/3 would fail.
   
   An alternative API design would be to add a method  each to `types.{ outgoing-request, outgoing-response }` to opt in to HTTP/2. I think the design proposed here is better in two regards:
   
   1. It makes static analysis of an application's intent much easier: instead of having to check for use of a `set-http-version` method on outgoing requests/responses and then making assumptions about which version that might opt in to, the normal validations for targeted worlds is sufficient.
   2. It matches what other APIs are doing and should make it easier to implement them in terms of wasi-http.
   
   As an example of the latter point, Go's standard library uses the same approach: Go's [`net/http` package](https://pkg.go.dev/net/http@go1.23.0#hdr-HTTP_2) transparently supports multiple HTTP versions, and explicitly opting in to HTTP/2 is possible using the [`x/net/http2` package](https://pkg.go.dev/golang.org/x/net/http2).
   
   Similarly, the Rust ecosystem's Hyper crate supports [automatically choosing](https://docs.rs/hyper/latest/hyper/server/conn/index.html) an HTTP version, or using `http1` or `http2` modules specifically.
   
   In both cases, the other types in the HTTP APIs remain the same, as in this proposal.
   
   Signed-off-by: Till Schneidereit <till@tillschneidereit.net>

   

   tschneidereit committed Sep 6, 2024
   Configuration menu

   • View commit details
   • Copy full SHA for 408afa7
   • Browse repository at this point

   Copy the full SHA

   408afa7 View commit details

   Browse the repository at this point in the history