1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122
// Licensed to the Apache Software Foundation (ASF) under one
// or more contributor license agreements. See the NOTICE file
// distributed with this work for additional information
// regarding copyright ownership. The ASF licenses this file
// to you under the Apache License, Version 2.0 (the
// "License"); you may not use this file except in compliance
// with the License. You may obtain a copy of the License at
//
// http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing,
// software distributed under the License is distributed on an
// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
// KIND, either express or implied. See the License for the
// specific language governing permissions and limitations
// under the License.
use std::io;
use std::pin::Pin;
use std::task::ready;
use std::task::Context;
use std::task::Poll;
use futures::{AsyncWrite, SinkExt};
use crate::raw::*;
use crate::*;
/// FuturesIoAsyncWriter is the adapter of [`AsyncWrite`] for [`Writer`].
///
/// Users can use this adapter in cases where they need to use [`AsyncWrite`] related trait.
///
/// FuturesIoAsyncWriter also implements [`Unpin`], [`Send`] and [`Sync`]
pub struct FuturesAsyncWriter {
sink: BufferSink,
buf: oio::FlexBuf,
}
impl FuturesAsyncWriter {
/// NOTE: don't allow users to create directly.
#[inline]
pub(crate) fn new(w: oio::Writer) -> Self {
FuturesAsyncWriter {
sink: BufferSink::new(w),
buf: oio::FlexBuf::new(256 * 1024),
}
}
}
impl AsyncWrite for FuturesAsyncWriter {
fn poll_write(
self: Pin<&mut Self>,
cx: &mut Context<'_>,
buf: &[u8],
) -> Poll<io::Result<usize>> {
let this = self.get_mut();
loop {
let n = this.buf.put(buf);
if n > 0 {
return Poll::Ready(Ok(n));
}
ready!(this.sink.poll_ready_unpin(cx)).map_err(format_std_io_error)?;
let bs = this.buf.get().expect("frozen buffer must be valid");
this.sink
.start_send_unpin(Buffer::from(bs))
.map_err(format_std_io_error)?;
this.buf.clean();
}
}
fn poll_flush(self: Pin<&mut Self>, cx: &mut Context<'_>) -> Poll<io::Result<()>> {
let this = self.get_mut();
loop {
// Make sure buf has been frozen.
this.buf.freeze();
let Some(bs) = this.buf.get() else {
return Poll::Ready(Ok(()));
};
ready!(this.sink.poll_ready_unpin(cx)).map_err(format_std_io_error)?;
this.sink
.start_send_unpin(Buffer::from(bs))
.map_err(format_std_io_error)?;
this.buf.clean();
}
}
fn poll_close(self: Pin<&mut Self>, cx: &mut Context<'_>) -> Poll<io::Result<()>> {
let this = self.get_mut();
loop {
// Make sure buf has been frozen.
this.buf.freeze();
let Some(bs) = this.buf.get() else {
return this.sink.poll_close_unpin(cx).map_err(format_std_io_error);
};
ready!(this.sink.poll_ready_unpin(cx)).map_err(format_std_io_error)?;
this.sink
.start_send_unpin(Buffer::from(bs))
.map_err(format_std_io_error)?;
this.buf.clean();
}
}
}
#[cfg(test)]
mod tests {
use super::*;
use crate::raw::MaybeSend;
#[test]
fn test_trait() {
let v = FuturesAsyncWriter::new(Box::new(()));
let _: Box<dyn Unpin + MaybeSend + Sync + 'static> = Box::new(v);
}
}