Struct Http2FrameBuilder 

pub struct Http2FrameBuilder { /* private fields */ }

Builder for a single HTTP/2 frame.

Example

use stackforge_core::layer::http2::builder::Http2FrameBuilder;
use stackforge_core::layer::http2::frames::Http2FrameType;

let frame = Http2FrameBuilder::settings_ack().build();
assert_eq!(frame.len(), 9); // 9-byte header, empty payload

Implementations

impl Http2FrameBuilder

pub fn new(frame_type: Http2FrameType) -> Self

Create a new frame builder for the given frame type.

pub fn flags(self, flags: u8) -> Self

Set the flags byte.

pub fn add_flag(self, flag: u8) -> Self

Set an additional flag bit (OR with existing flags).

pub fn stream_id(self, id: u32) -> Self

Set the stream ID.

pub fn payload(self, data: Vec<u8>) -> Self

Set the frame payload.

pub fn end_stream(self) -> Self

Set the END_STREAM flag (0x1).

Used with DATA and HEADERS frames.

pub fn end_headers(self) -> Self

Set the END_HEADERS flag (0x4).

Used with HEADERS, PUSH_PROMISE, and CONTINUATION frames.

pub fn build(&self) -> Vec<u8>

Build the frame into bytes.

pub fn settings() -> Self

Create an empty SETTINGS frame (stream 0).

pub fn settings_ack() -> Self

Create a SETTINGS ACK frame (stream 0, ACK flag set).

pub fn settings_with_params(params: &[(u16, u32)]) -> Self

Create a SETTINGS frame with parameters.

Each entry is (settings_id, value). The payload is 6 bytes per entry.

pub fn ping(data: [u8; 8]) -> Self

Create a PING frame with 8 bytes of opaque data.

pub fn ping_ack(data: [u8; 8]) -> Self

Create a PING ACK frame (response to a PING).

pub fn goaway(last_stream: u32, error_code: u32) -> Self

Create a GOAWAY frame.

Arguments

• last_stream: the last stream ID processed
• error_code: the error code (see frames::error_codes)

pub fn window_update(increment: u32, stream_id: u32) -> Self

Create a WINDOW_UPDATE frame.

Arguments

• increment: window size increment (1-2^31-1)
• stream_id: stream ID (0 for connection-level)

pub fn rst_stream(stream_id: u32, error_code: u32) -> Self

Create a RST_STREAM frame.

Arguments

• stream_id: the stream to reset
• error_code: the error code

pub fn headers_frame(stream_id: u32, hpack_data: Vec<u8>) -> Self

Create a HEADERS frame carrying HPACK-encoded header data.

Sets END_HEADERS by default. Use .flags() to override.

pub fn headers_frame_final(stream_id: u32, hpack_data: Vec<u8>) -> Self

Create a HEADERS frame with END_STREAM + END_HEADERS flags set.

pub fn data_frame(stream_id: u32, data: Vec<u8>) -> Self

Create a DATA frame.

pub fn data_frame_final(stream_id: u32, data: Vec<u8>) -> Self

Create a DATA frame with END_STREAM set.

pub fn continuation(stream_id: u32, hpack_data: Vec<u8>) -> Self

Create a CONTINUATION frame.

pub fn continuation_final(stream_id: u32, hpack_data: Vec<u8>) -> Self

Create a CONTINUATION frame with END_HEADERS set.

pub fn priority_frame( stream_id: u32, exclusive: bool, stream_dep: u32, weight: u8, ) -> Self

Create a PRIORITY frame.

Arguments

• stream_id: the stream being prioritized
• exclusive: exclusive dependency flag
• stream_dep: stream dependency
• weight: priority weight (0-255, actual weight = weight + 1)

pub fn push_promise( stream_id: u32, promised_stream_id: u32, hpack_data: Vec<u8>, ) -> Self

Create a PUSH_PROMISE frame.

Arguments

• stream_id: the associated stream
• promised_stream_id: the stream ID being promised
• hpack_data: HPACK-encoded headers for the promised request

Trait Implementations

impl Clone for Http2FrameBuilder

fn clone(&self) -> Http2FrameBuilder

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Http2FrameBuilder

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl IntoLayerStackEntry for Http2FrameBuilder

fn into_layer_stack_entry(self) -> LayerStackEntry