[−][src]Crate body_image
Provides a uniform access strategy to HTTP bodies in RAM, or buffered to a temporary file, and optionally memory mapped.
BodyImage
, BodySink
and supporting types provide a strategy for
safely handling potentially large HTTP request or response bodies without
risk of allocation failure, or the need to impose awkwardly low size limits
in the face of high concurrency. Tunables
size thresholds can be used
to decide when to accumulate the body in RAM vs. the filesystem, including
when the length is unknown in advance.
A Dialog
defines a complete HTTP request and response recording, using
BodyImage
for the request and response bodies and http crate types for
the headers and other components.
See the top-level (project workspace) README for additional rationale.
Optional Features
The following features may be enabled or disabled at build time. All are enabled by default.
mmap: Adds BodyImage::mem_map
support for memory mapping from FsRead
state.
Related Crates
barc: Body Archive container file reader and writer, for
serializing Dialog
records. See also barc-cli.
body-image-futio: Asynchronous HTTP integration with futures, http,
hyper, and tokio for BodyImage
/BodySink
, for both client and server
use.
Structs
BodyImage | A logical buffer of bytes, which may or may not be RAM resident. |
BodySink | A logical buffer of bytes, which may or may not be RAM resident, in the process of being written. |
Dialog | An HTTP request and response recording. |
Epilog | Extract of an HTTP response. |
Prolog | Extract of an HTTP request. |
Tunables | A collection of size limits and performance tuning constants. Setters are
available via |
Tuner | A builder for |
Enums
BodyError | Error enumeration for |
BodyReader | Provides a |
Encoding | A set of HTTP Transfer- or Content-Encoding values. |
ExplodedImage | Exploded representation of the possible |
Statics
VERSION | The crate version string. |
Traits
Recorded | Access by reference for HTTP request (via |
RequestRecorded | Access by reference for HTTP request recording types. |