DATA frame (RFC 7540 Section 6.1) More...

#include <frame.h>

Inheritance diagram for kcenon::network::protocols::http2::data_frame:

Collaboration diagram for kcenon::network::protocols::http2::data_frame:

Public Member Functions
	data_frame (uint32_t stream_id, std::vector< uint8_t > data, bool end_stream=false, bool padded=false)
	Construct DATA frame.

auto	is_end_stream () const -> bool
	Check if END_STREAM flag is set.

auto	is_padded () const -> bool
	Check if frame is padded.

auto	data () const -> std::span< const uint8_t >
	Get actual data (without padding)

Public Member Functions inherited from kcenon::network::protocols::http2::frame
	frame ()=default
	Default constructor.

	frame (const frame_header &hdr, std::vector< uint8_t > payload)
	Construct frame with header and payload.

auto	serialize () const -> std::vector< uint8_t >
	Serialize frame to bytes.

auto	header () const -> const frame_header &
	Get frame header.

auto	payload () const -> std::span< const uint8_t >
	Get frame payload.

virtual	~frame ()=default
	Virtual destructor.

Static Public Member Functions
static auto	parse (const frame_header &hdr, std::span< const uint8_t > payload) -> Result< std::unique_ptr< data_frame > >
	Parse DATA frame from raw bytes.

Static Public Member Functions inherited from kcenon::network::protocols::http2::frame
static auto	parse (std::span< const uint8_t > data) -> Result< std::unique_ptr< frame > >
	Parse frame from raw bytes.

Private Attributes
std::vector< uint8_t >	data_
	Actual data without padding.

Additional Inherited Members
Protected Attributes inherited from kcenon::network::protocols::http2::frame
frame_header	header_
	Frame header.

std::vector< uint8_t >	payload_
	Frame payload.

Detailed Description

DATA frame (RFC 7540 Section 6.1)

DATA frames convey arbitrary, variable-length sequences of octets associated with a stream.

Definition at line 138 of file frame.h.

Constructor & Destructor Documentation

◆ data_frame()

kcenon::network::protocols::http2::data_frame::data_frame	(	uint32_t	stream_id,
		std::vector< uint8_t >	data,
		bool	end_stream = false,
		bool	padded = false )

Construct DATA frame.

Parameters

stream_id	Stream identifier
data	Payload data
end_stream	True if this is the last frame in stream
padded	True if frame is padded

Definition at line 190 of file frame.cpp.

        : data_(std::move(data))
    {
        header_.stream_id = stream_id;
        header_.type = frame_type::data;
        header_.flags = frame_flags::none;
 
        if (end_stream)
        {
            header_.flags |= frame_flags::end_stream;
        }
 
        if (padded)
        {
            header_.flags |= frame_flags::padded;
            payload_.push_back(0);  // Pad length = 0 for now
        }
 
        payload_.insert(payload_.end(), data_.begin(), data_.end());
        header_.length = static_cast<uint32_t>(payload_.size());
    }

Member Function Documentation

◆ data()

auto kcenon::network::protocols::http2::data_frame::data ( ) const -> std::span<const uint8_t>

Get actual data (without padding)

Returns: Span of data bytes

Definition at line 267 of file frame.cpp.

    {
        return data_;
    }

References data_.

◆ is_end_stream()

auto kcenon::network::protocols::http2::data_frame::is_end_stream ( ) const -> bool

Check if END_STREAM flag is set.

Returns: True if this is the last frame in stream

Definition at line 257 of file frame.cpp.

    {
        return header_.flags & frame_flags::end_stream;
    }

References kcenon::network::protocols::http2::frame_flags::end_stream, kcenon::network::protocols::http2::frame_header::flags, and kcenon::network::protocols::http2::frame::header_.

◆ is_padded()

auto kcenon::network::protocols::http2::data_frame::is_padded ( ) const -> bool

Check if frame is padded.

Returns: True if frame has padding

Definition at line 262 of file frame.cpp.

    {
        return header_.flags & frame_flags::padded;
    }

References kcenon::network::protocols::http2::frame_header::flags, kcenon::network::protocols::http2::frame::header_, and kcenon::network::protocols::http2::frame_flags::padded.

◆ parse()

auto kcenon::network::protocols::http2::data_frame::parse	(	const frame_header &	hdr,
		std::span< const uint8_t >	payload ) -> Result<std::unique_ptr<data_frame>>

static

Parse DATA frame from raw bytes.

Parameters

hdr	Frame header (must be DATA type)
payload	Frame payload

Returns: Result containing parsed DATA frame or error

Definition at line 213 of file frame.cpp.

    {
        if (hdr.stream_id == 0)
        {
            return error_info(4, "DATA frame must have non-zero stream ID", "http2");
        }
 
        std::vector<uint8_t> data;
        size_t data_offset = 0;
 
        if (hdr.flags & frame_flags::padded)
        {
            if (payload.empty())
            {
                return error_info(5, "Padded DATA frame must have pad length", "http2");
            }
 
            uint8_t pad_length = payload[0];
            data_offset = 1;
 
            if (payload.size() < data_offset + pad_length)
            {
                return error_info(6, "Invalid padding in DATA frame", "http2");
            }
 
            data.assign(payload.begin() + data_offset,
                       payload.end() - pad_length);
        }
        else
        {
            data.assign(payload.begin(), payload.end());
        }
 
        auto frame = std::make_unique<data_frame>(
            hdr.stream_id,
            std::move(data),
            hdr.flags & frame_flags::end_stream,
            hdr.flags & frame_flags::padded
        );
 
        return frame;
    }

References kcenon::network::protocols::http2::data, kcenon::network::protocols::http2::frame_flags::end_stream, and kcenon::network::protocols::http2::frame_flags::padded.

Referenced by kcenon::network::protocols::http2::frame::parse().

Here is the caller graph for this function:

Member Data Documentation

◆ data_

std::vector<uint8_t> kcenon::network::protocols::http2::data_frame::data_

private

Actual data without padding.

Definition at line 179 of file frame.h.

Referenced by data(), and data_frame().

The documentation for this class was generated from the following files:

src/internal/protocols/http2/frame.h
src/protocols/http2/frame.cpp

Public Member Functions

Static Public Member Functions

Private Attributes

Additional Inherited Members