Safe Haskell	None
Language	Haskell2010

Network.HTTP3.Server

Contents

Runner
Common configration
HTTP semantics
Internal

Description

A server library for HTTP/3.

Synopsis

run :: Connection -> Config -> Server -> IO ()
data Config = Config {
}
defaultConfig :: Config
allocSimpleConfig :: IO Config
freeSimpleConfig :: Config -> IO ()
defaultQEncoderConfig :: QEncoderConfig
ecMaxTableCapacity :: QEncoderConfig -> Size
ecHeaderBlockBufferSize :: QEncoderConfig -> Size
ecInstructionBufferSize :: QEncoderConfig -> Size
defaultQDecoderConfig :: QDecoderConfig
dcMaxTableCapacity :: QDecoderConfig -> Size
dcHuffmanBufferSize :: QDecoderConfig -> Size
data Hooks = Hooks {
- onControlFrameCreated :: [H3Frame] -> [H3Frame]
- onHeadersFrameCreated :: [H3Frame] -> [H3Frame]
- onControlStreamCreated :: Stream -> IO ()
- onEncoderStreamCreated :: Stream -> IO ()
- onDecoderStreamCreated :: Stream -> IO ()
}
defaultHooks :: Hooks
module Network.HTTP.Semantics.Server
runIO :: Connection -> Config -> (ServerIO Stream -> IO (IO ())) -> IO ()
data ServerIO a = ServerIO {
- sioMySockAddr :: SockAddr
- sioPeerSockAddr :: SockAddr
- sioReadRequest :: IO (a, Request)
- sioWriteResponse :: a -> Response -> IO ()
}

Runner

run :: Connection -> Config -> Server -> IO () Source #

Running an HTTP/3 server.

Common configration

data Config Source #

Configuration for HTTP/3 or HQ.

Constructors

Config
Fields confHooks :: Hooks confQEncoderConfig :: QEncoderConfig confQDecoderConfig :: QDecoderConfig confPositionReadMaker :: PositionReadMaker confTimeoutManager :: Manager

defaultConfig :: Config Source #

allocSimpleConfig :: IO Config Source #

Allocating a simple configuration with a handle-based position reader and a locally allocated timeout manager.

freeSimpleConfig :: Config -> IO () Source #

Freeing a simple configration.

defaultQEncoderConfig :: QEncoderConfig Source #

Default configuration for QPACK encoder.

>>> defaultQEncoderConfig
QEncoderConfig {ecMaxTableCapacity = 4096, ecHeaderBlockBufferSize = 4096, ecInstructionBufferSize = 4096}

ecMaxTableCapacity :: QEncoderConfig -> Size Source #

ecHeaderBlockBufferSize :: QEncoderConfig -> Size Source #

ecInstructionBufferSize :: QEncoderConfig -> Size Source #

defaultQDecoderConfig :: QDecoderConfig Source #

Default configuration for QPACK decoder.

>>> defaultQDecoderConfig
QDecoderConfig {dcMaxTableCapacity = 4096, dcHuffmanBufferSize = 2048, dcBlockedSterams = 100, dcMaxFieldSectionSize = 32768}

dcMaxTableCapacity :: QDecoderConfig -> Size Source #

dcHuffmanBufferSize :: QDecoderConfig -> Size Source #

data Hooks Source #

Hooks mainly for error testing.

Constructors

Hooks
Fields onControlFrameCreated :: [H3Frame] -> [H3Frame] onHeadersFrameCreated :: [H3Frame] -> [H3Frame] onControlStreamCreated :: Stream -> IO () onEncoderStreamCreated :: Stream -> IO () onDecoderStreamCreated :: Stream -> IO ()

defaultHooks :: Hooks Source #

Default hooks.

HTTP semantics

module Network.HTTP.Semantics.Server

Internal

runIO :: Connection -> Config -> (ServerIO Stream -> IO (IO ())) -> IO () Source #

data ServerIO a #

Constructors

ServerIO
Fields sioMySockAddr :: SockAddr sioPeerSockAddr :: SockAddr sioReadRequest :: IO (a, Request) sioWriteResponse :: a -> Response -> IO () `Response` MUST be created with `responseBuilder`. Others are not supported.