StormByte-Network 4.0.0
C++26 networking module of the StormByte suite
Loading...
Searching...
No Matches
StormByte::Network::HTTP Namespace Reference

Bounded HTTP client API; no HTTP server or HTTP/3. More...

Classes

struct  Header
 One header occurrence, preserving duplicates and received order. More...
struct  Request
 Fully buffered request. More...
struct  Response
 Fully buffered final response; informational responses are consumed, 3xx is returned unchanged, and body bytes are not decompressed. More...
class  Receiver
 Borrowed streaming consumer of the final response body. More...
struct  Options
 Scalar request limits. More...
class  Client
 Synchronous single-request-per-connection client. More...

Enumerations

enum class  Error {
  InvalidURL , InvalidRequest , InvalidOptions , LimitExceeded ,
  TimedOut , Cancelled , ResolverBusy , Transport ,
  TLS , Protocol , Truncated , HTTP2 ,
  Allocation , Rejected
}
 Typed terminal failures; no failed request is replayed. More...
enum class  Protocol { Automatic , HTTP1 , HTTP2 }
 Protocol selection. More...

Detailed Description

Bounded HTTP client API; no HTTP server or HTTP/3.

Bounded HTTP client API.

Enumeration Type Documentation

◆ Error

Typed terminal failures; no failed request is replayed.

Enumerator
InvalidURL 

Invalid or unsupported absolute URL.

InvalidRequest 

Invalid method, field or unsupported request feature.

InvalidOptions 

Invalid limits, deadline, protocol or moved-from client.

LimitExceeded 

An explicit request/response bound was exceeded.

TimedOut 

Total request deadline expired.

Cancelled 

Borrowed cancellation flag was set.

ResolverBusy 

Previous managed DNS work is still running.

Transport 

DNS, connect or native I/O failed.

TLS 

TLS configuration, authentication or engine failure.

Protocol 

Invalid HTTP semantics, framing or required ALPN.

Truncated 

Incomplete message or bare TCP EOF on authenticated TLS.

HTTP2 

HTTP/2 engine, frame, reset or GOAWAY failure.

Allocation 

Provider-side allocation or callback construction failed.

Rejected 

The streaming Receiver declined the response or failed.

◆ Protocol

Protocol selection.

Automatic offers h2/http1.1 over HTTPS, and uses HTTP/1.1 for cleartext. HTTP2 requires h2 ALPN over HTTPS or uses explicit prior knowledge over cleartext, without fallback.

Enumerator
Automatic 

HTTP/1 cleartext, h2/http1.1 HTTPS ALPN.

HTTP1 

HTTP/1.1 only.

HTTP2 

Required h2 ALPN or cleartext prior knowledge.