h3

Documentation

Index

• Constants
• func RequestFromHeaders(headers []qpack.HeaderField) (*http.Request, string, error)
• type DataStreamer
• type Frame
  • func (f *Frame) Read(r io.Reader) error
  • func (f *Frame) Write(w io.Writer) (int, error)
• type ResponseWriter
  • func NewResponseWriter(stream quic.Stream) *ResponseWriter
  • func (w *ResponseWriter) DataStream() quic.Stream
  • func (w *ResponseWriter) Flush()
  • func (w *ResponseWriter) Header() http.Header
  • func (w *ResponseWriter) Write(p []byte) (int, error)
  • func (w *ResponseWriter) WriteHeader(status int)
• type SettingID
  • func (id SettingID) String() string
• type SettingsMap
  • func (s *SettingsMap) FromFrame(f Frame) error
  • func (s SettingsMap) ToFrame() Frame
• type StreamHeader
  • func (s *StreamHeader) Read(r io.Reader) error
  • func (s *StreamHeader) Write(w io.Writer) (int, error)

Constants

const (
	FRAME_DATA                = 0x00
	FRAME_HEADERS             = 0x01
	FRAME_CANCEL_PUSH         = 0x03
	FRAME_SETTINGS            = 0x04
	FRAME_PUSH_PROMISE        = 0x05
	FRAME_GOAWAY              = 0x07
	FRAME_MAX_PUSH_ID         = 0x0D
	FRAME_WEBTRANSPORT_STREAM = 0x41
)

Frame types

const (
	// https://datatracker.ietf.org/doc/html/draft-ietf-quic-http-34
	SETTINGS_MAX_FIELD_SECTION_SIZE = SettingID(0x6)

	// https://datatracker.ietf.org/doc/html/draft-ietf-quic-qpack-21
	SETTINGS_QPACK_MAX_TABLE_CAPACITY = SettingID(0x1)
	SETTINGS_QPACK_BLOCKED_STREAMS    = SettingID(0x7)

	// https://datatracker.ietf.org/doc/html/draft-ietf-masque-h3-datagram-05#section-9.1
	H3_DATAGRAM_05 = SettingID(0xffd277)

	// https://www.ietf.org/archive/id/draft-ietf-webtrans-http3-02.html#section-8.2
	ENABLE_WEBTRANSPORT = SettingID(0x2b603742)
)

Settings

const (
	STREAM_CONTROL                 = 0x00
	STREAM_PUSH                    = 0x01
	STREAM_QPACK_ENCODER           = 0x02
	STREAM_QPACK_DECODER           = 0x03
	STREAM_WEBTRANSPORT_UNI_STREAM = 0x54
)

Stream types

Functions

func RequestFromHeaders

func RequestFromHeaders(headers []qpack.HeaderField) (*http.Request, string, error)

Types

type DataStreamer

type DataStreamer interface {
	DataStream() quic.Stream
}

DataStreamer lets the caller take over the stream. After a call to DataStream the HTTP server library will not do anything else with the connection.

It becomes the caller's responsibility to manage and close the stream.

After a call to DataStream, the original Request.Body must not be used.

type Frame

type Frame struct {
	Type      uint64
	SessionID uint64
	Length    uint64
	Data      []byte
}

HTTP/3 frame

func (*Frame) Read

func (f *Frame) Read(r io.Reader) error

func (*Frame) Write

func (f *Frame) Write(w io.Writer) (int, error)

type ResponseWriter

type ResponseWriter struct {
	// contains filtered or unexported fields
}

func NewResponseWriter

func NewResponseWriter(stream quic.Stream) *ResponseWriter

func (*ResponseWriter) DataStream

func (w *ResponseWriter) DataStream() quic.Stream

func (*ResponseWriter) Flush

func (w *ResponseWriter) Flush()

func (*ResponseWriter) Header

func (w *ResponseWriter) Header() http.Header

func (*ResponseWriter) Write

func (w *ResponseWriter) Write(p []byte) (int, error)

func (*ResponseWriter) WriteHeader

func (w *ResponseWriter) WriteHeader(status int)

type SettingID

type SettingID uint64

func (SettingID) String

func (id SettingID) String() string

type SettingsMap

type SettingsMap map[SettingID]uint64

func (*SettingsMap) FromFrame

func (s *SettingsMap) FromFrame(f Frame) error

func (SettingsMap) ToFrame

func (s SettingsMap) ToFrame() Frame

type StreamHeader

type StreamHeader struct {
	Type uint64
	ID   uint64
}

HTTP/3 stream header

func (*StreamHeader) Read

func (s *StreamHeader) Read(r io.Reader) error

func (*StreamHeader) Write

func (s *StreamHeader) Write(w io.Writer) (int, error)