Source code
Revision control
Copy as Markdown
Other Tools
// Licensed under the Apache License, Version 2.0 <LICENSE-APACHE or
// option. This file may not be copied, modified, or distributed
// except according to those terms.
use std::{
fmt::{self, Display, Formatter},
time::Instant,
};
use neqo_common::qdebug;
use neqo_transport::{Connection, StreamId};
use crate::{
frames::{FrameReader, HFrame, StreamReaderConnectionWrapper},
CloseType, Error, Http3StreamType, ReceiveOutput, RecvStream, Res, Stream,
};
/// The remote control stream is responsible only for reading frames. The frames are handled by
/// `Http3Connection`.
#[derive(Debug)]
pub struct ControlStreamRemote {
stream_id: StreamId,
frame_reader: FrameReader,
}
impl Display for ControlStreamRemote {
fn fmt(&self, f: &mut Formatter) -> fmt::Result {
write!(f, "Http3 remote control stream {:?}", self.stream_id)
}
}
impl ControlStreamRemote {
pub fn new(stream_id: StreamId) -> Self {
Self {
stream_id,
frame_reader: FrameReader::new(),
}
}
/// Check if a stream is the control stream and read received data.
pub fn receive_single(&mut self, conn: &mut Connection, now: Instant) -> Res<Option<HFrame>> {
qdebug!("[{self}] Receiving data");
match self.frame_reader.receive(
&mut StreamReaderConnectionWrapper::new(conn, self.stream_id),
now,
)? {
(_, true) => Err(Error::HttpClosedCriticalStream),
(s, false) => {
qdebug!("[{self}] received {s:?}");
Ok(s)
}
}
}
}
impl Stream for ControlStreamRemote {
fn stream_type(&self) -> Http3StreamType {
Http3StreamType::Control
}
}
impl RecvStream for ControlStreamRemote {
fn reset(&mut self, _close_type: CloseType) -> Res<()> {
Err(Error::HttpClosedCriticalStream)
}
fn receive(&mut self, conn: &mut Connection, now: Instant) -> Res<(ReceiveOutput, bool)> {
let mut control_frames = Vec::new();
loop {
if let Some(f) = self.receive_single(conn, now)? {
control_frames.push(f);
} else {
return Ok((ReceiveOutput::ControlFrames(control_frames), false));
}
}
}
}
#[test]
fn control_stream_remote_display() {
let stream = ControlStreamRemote::new(StreamId::new(2));
assert_eq!(
stream.to_string(),
"Http3 remote control stream StreamId(2)"
);
}