Better io error handling (#482)

ntex-io/CHANGES.md

@@ -1,5 +1,9 @@
 # Changes
 
+## [2.9.2] - 2024-12-05
+
+* Better error handling
+
 ## [2.9.1] - 2024-12-04
 
 * Check service readiness for every turn

ntex-io/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "ntex-io"
-version = "2.9.1"
+version = "2.9.2"
 authors = ["ntex contributors <team@ntex.rs>"]
 description = "Utilities for encoding and decoding frames"
 keywords = ["network", "framework", "async", "futures"]

ntex-io/src/io.rs

@@ -80,6 +80,23 @@ impl IoState {
         }
     }
 
+    /// Get current io error
+    pub(super) fn error(&self) -> Option<io::Error> {
+        if let Some(err) = self.error.take() {
+            self.error
+                .set(Some(io::Error::new(err.kind(), format!("{}", err))));
+            Some(err)
+        } else {
+            None
+        }
+    }
+
+    /// Get current io result
+    pub(super) fn error_or_disconnected(&self) -> io::Error {
+        self.error()
+            .unwrap_or_else(|| io::Error::new(io::ErrorKind::NotConnected, "Disconnected"))
+    }
+
     pub(super) fn io_stopped(&self, err: Option<io::Error>) {
         if err.is_some() {
             self.error.set(err);
@@ -257,19 +274,6 @@ impl<F> Io<F> {
     fn io_ref(&self) -> &IoRef {
         unsafe { &*self.0.get() }
     }
-
-    /// Get current io error
-    fn error(&self) -> Option<io::Error> {
-        self.st().error.take()
-    }
-
-    /// Get current io error
-    fn error_or_disconnected(&self) -> io::Error {
-        self.st()
-            .error
-            .take()
-            .unwrap_or_else(|| io::Error::new(io::ErrorKind::Other, "Disconnected"))
-    }
 }
 
 impl<F: FilterLayer, T: Filter> Io<Layer<F, T>> {
@@ -333,7 +337,7 @@ impl<F> Io<F> {
                     "Timeout",
                 ))),
                 Err(RecvError::Stop) => Err(Either::Right(io::Error::new(
-                    io::ErrorKind::Other,
+                    io::ErrorKind::UnexpectedEof,
                     "Dispatcher stopped",
                 ))),
                 Err(RecvError::WriteBackpressure) => {
@@ -423,7 +427,7 @@ impl<F> Io<F> {
         let mut flags = st.flags.get();
 
         if flags.is_stopped() {
-            Poll::Ready(Err(self.error_or_disconnected()))
+            Poll::Ready(Err(st.error_or_disconnected()))
         } else {
             st.dispatch_task.register(cx.waker());
 
@@ -511,7 +515,7 @@ impl<F> Io<F> {
             let st = self.st();
             let flags = st.flags.get();
             if flags.is_stopped() {
-                Err(RecvError::PeerGone(self.error()))
+                Err(RecvError::PeerGone(st.error()))
             } else if flags.contains(Flags::DSP_STOP) {
                 st.remove_flags(Flags::DSP_STOP);
                 Err(RecvError::Stop)
@@ -545,12 +549,12 @@ impl<F> Io<F> {
     /// otherwise wake up when size of write buffer is lower than
     /// buffer max size.
     pub fn poll_flush(&self, cx: &mut Context<'_>, full: bool) -> Poll<io::Result<()>> {
+        let st = self.st();
         let flags = self.flags();
 
         if flags.is_stopped() {
-            Poll::Ready(Err(self.error_or_disconnected()))
+            Poll::Ready(Err(st.error_or_disconnected()))
         } else {
-            let st = self.st();
             let len = st.buffer.write_destination_size();
             if len > 0 {
                 if full {
@@ -575,7 +579,7 @@ impl<F> Io<F> {
         let flags = st.flags.get();
 
         if flags.is_stopped() {
-            if let Some(err) = self.error() {
+            if let Some(err) = st.error() {
                 Poll::Ready(Err(err))
             } else {
                 Poll::Ready(Ok(()))
@@ -611,7 +615,7 @@ impl<F> Io<F> {
         let st = self.st();
         let flags = st.flags.get();
         if flags.intersects(Flags::IO_STOPPED | Flags::IO_STOPPING) {
-            Poll::Ready(IoStatusUpdate::PeerGone(self.error()))
+            Poll::Ready(IoStatusUpdate::PeerGone(st.error()))
         } else if flags.contains(Flags::DSP_STOP) {
             st.remove_flags(Flags::DSP_STOP);
             Poll::Ready(IoStatusUpdate::Stop)

ntex-io/src/ioref.rs

@@ -191,7 +191,7 @@ impl IoRef {
         F: FnOnce(&mut BytesVec) -> R,
     {
         if self.0.flags.get().contains(Flags::IO_STOPPED) {
-            Err(io::Error::new(io::ErrorKind::Other, "Disconnected"))
+            Err(self.0.error_or_disconnected())
         } else {
             let result = self.0.buffer.with_write_source(self, f);
             self.0.filter().process_write_buf(self, &self.0.buffer, 0)?;

ntex-server/src/net/builder.rs

@@ -360,7 +360,7 @@ pub fn bind_addr<S: net::ToSocketAddrs>(
             Err(e)
         } else {
             Err(io::Error::new(
-                io::ErrorKind::Other,
+                io::ErrorKind::InvalidInput,
                 "Cannot bind to address.",
             ))
         }

ntex-tls/src/openssl/connect.rs

@@ -51,11 +51,11 @@ impl<T: Address> SslConnector<T> {
         log::trace!("{}: SSL Handshake start for: {:?}", io.tag(), host);
 
         match openssl.configure() {
-            Err(e) => Err(io::Error::new(io::ErrorKind::Other, e).into()),
+            Err(e) => Err(io::Error::new(io::ErrorKind::InvalidInput, e).into()),
             Ok(config) => {
                 let ssl = config
                     .into_ssl(&host)
-                    .map_err(|e| io::Error::new(io::ErrorKind::Other, e))?;
+                    .map_err(|e| io::Error::new(io::ErrorKind::InvalidInput, e))?;
                 let tag = io.tag();
                 match connect_io(io, ssl).await {
                     Ok(io) => {
@@ -64,7 +64,10 @@ impl<T: Address> SslConnector<T> {
                     }
                     Err(e) => {
                         log::trace!("{}: SSL Handshake error: {:?}", tag, e);
-                        Err(io::Error::new(io::ErrorKind::Other, format!("{}", e)).into())
+                        Err(
+                            io::Error::new(io::ErrorKind::InvalidInput, format!("{}", e))
+                                .into(),
+                        )
                     }
                 }
             }

ntex-tls/src/openssl/mod.rs

@@ -250,7 +250,9 @@ async fn handle_result<T, F>(
             ssl::ErrorCode::WANT_READ => {
                 let res = io.read_notify().await;
                 match res? {
-                    None => Err(io::Error::new(io::ErrorKind::Other, "disconnected")),
+                    None => {
+                        Err(io::Error::new(io::ErrorKind::NotConnected, "disconnected"))
+                    }
                     _ => Ok(None),
                 }
             }

ntex/src/http/client/h2proto.rs

@@ -187,14 +187,17 @@ async fn get_response(
                                             err
                                         );
                                         pl.set_error(
-                                            io::Error::new(io::ErrorKind::Other, err)
+                                            io::Error::new(
+                                                io::ErrorKind::UnexpectedEof,
+                                                err,
+                                            )
                                             .into(),
                                         );
                                     }
                                     _ => {
                                         pl.set_error(
                                             io::Error::new(
-                                                io::ErrorKind::Other,
+                                                io::ErrorKind::Unsupported,
                                                 "unexpected h2 message",
                                             )
                                             .into(),
@@ -216,7 +219,7 @@ async fn get_response(
             }
         }
         _ => Err(SendRequestError::Error(Box::new(io::Error::new(
-            io::ErrorKind::Other,
+            io::ErrorKind::Unsupported,
             "unexpected h2 message",
         )))),
     }

ntex/src/http/encoding/encoder.rs

@@ -117,7 +117,7 @@ impl<B: MessageBody> MessageBody for Encoder<B> {
                     Poll::Ready(Ok(Err(e))) => return Poll::Ready(Some(Err(Box::new(e)))),
                     Poll::Ready(Err(_)) => {
                         return Poll::Ready(Some(Err(Box::new(io::Error::new(
-                            io::ErrorKind::Other,
+                            io::ErrorKind::Interrupted,
                             "Canceled",
                         )))));
                     }

ntex/src/http/error.rs

@@ -217,7 +217,7 @@ pub enum BlockingError<E: fmt::Debug> {
 impl From<crate::rt::JoinError> for PayloadError {
     fn from(_: crate::rt::JoinError) -> Self {
         PayloadError::Io(io::Error::new(
-            io::ErrorKind::Other,
+            io::ErrorKind::Interrupted,
             "Operation is canceled",
         ))
     }
@@ -228,7 +228,7 @@ impl From<BlockingError<io::Error>> for PayloadError {
         match err {
             BlockingError::Error(e) => PayloadError::Io(e),
             BlockingError::Canceled => PayloadError::Io(io::Error::new(
-                io::ErrorKind::Other,
+                io::ErrorKind::Interrupted,
                 "Operation is canceled",
             )),
         }

ntex/src/http/h2/service.rs

@@ -408,7 +408,9 @@ where
             h2::MessageKind::Disconnect(err) => {
                 log::debug!("Connection is disconnected {:?}", err);
                 if let Some(mut sender) = self.streams.borrow_mut().remove(&stream.id()) {
-                    sender.set_error(io::Error::new(io::ErrorKind::Other, err).into());
+                    sender.set_error(
+                        io::Error::new(io::ErrorKind::UnexpectedEof, err).into(),
+                    );
                 }
                 return Ok(());
             }

ntex/src/http/test.rs

@@ -257,7 +257,7 @@ where
         server,
         client: Client::build().finish(),
     }
-    .set_client_timeout(Seconds(30), Millis(30_000))
+    .set_client_timeout(Seconds(45), Millis(45_000))
 }
 
 #[derive(Debug)]

ntex/src/web/server.rs

@@ -467,7 +467,7 @@ where
                 Err(e)
             } else {
                 Err(io::Error::new(
-                    io::ErrorKind::Other,
+                    io::ErrorKind::InvalidInput,
                     "Cannot bind to address.",
                 ))
             }

ntex/src/web/test.rs

@@ -717,8 +717,8 @@ where
                     .map_err(|e| log::error!("Cannot set alpn protocol: {:?}", e));
                 Connector::default()
                     .lifetime(Seconds::ZERO)
-                    .keep_alive(Seconds(30))
+                    .keep_alive(Seconds(45))
-                    .timeout(Millis(30_000))
+                    .timeout(Millis(45_000))
                     .disconnect_timeout(Seconds(5))
                     .openssl(builder.build())
                     .finish()
@@ -727,14 +727,14 @@ where
             {
                 Connector::default()
                     .lifetime(Seconds::ZERO)
-                    .timeout(Millis(30_000))
+                    .timeout(Millis(45_000))
                     .finish()
             }
         };
 
         Client::build()
             .connector(connector)
-            .timeout(Seconds(30))
+            .timeout(Seconds(45))
             .finish()
     };
 

ntex/src/ws/transport.rs

@@ -54,7 +54,7 @@ impl WsTransport {
             Ok(())
         } else {
             self.insert_flags(Flags::PROTO_ERR);
-            Err(io::Error::new(io::ErrorKind::Other, err_message))
+            Err(io::Error::new(io::ErrorKind::InvalidData, err_message))
         }
     }
 }
@@ -96,7 +96,7 @@ impl FilterLayer for WsTransport {
                     self.codec.decode_vec(&mut src).map_err(|e| {
                         log::trace!("Failed to decode ws codec frames: {:?}", e);
                         self.insert_flags(Flags::PROTO_ERR);
-                        io::Error::new(io::ErrorKind::Other, e)
+                        io::Error::new(io::ErrorKind::InvalidData, e)
                     })? {
                     frame
                 } else {
@@ -123,14 +123,14 @@ impl FilterLayer for WsTransport {
                     Frame::Continuation(Item::FirstText(_)) => {
                         self.insert_flags(Flags::PROTO_ERR);
                         return Err(io::Error::new(
-                            io::ErrorKind::Other,
+                            io::ErrorKind::InvalidData,
                             "WebSocket Text continuation frames are not supported",
                         ));
                     }
                     Frame::Text(_) => {
                         self.insert_flags(Flags::PROTO_ERR);
                         return Err(io::Error::new(
-                            io::ErrorKind::Other,
+                            io::ErrorKind::InvalidData,
                             "WebSockets Text frames are not supported",
                         ));
                     }