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
// 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 crate::raw::*;
use crate::*;
use bytes::Buf;
/// BlockingWriter is designed to write data into given path in an blocking
/// manner.
pub struct BlockingWriter {
pub(crate) inner: oio::BlockingWriter,
}
impl BlockingWriter {
/// Create a new writer.
///
/// Create will use internal information to decide the most suitable
/// implementation for users.
///
/// We don't want to expose those details to users so keep this function
/// in crate only.
pub(crate) fn create(acc: Accessor, path: &str, op: OpWrite) -> Result<Self> {
let (_, w) = acc.blocking_write(path, op)?;
Ok(BlockingWriter { inner: w })
}
/// Write into inner writer.
pub fn write(&mut self, bs: impl Into<Buffer>) -> Result<()> {
let mut bs = bs.into();
while !bs.is_empty() {
let n = self.inner.write(bs.clone())?;
bs.advance(n);
}
Ok(())
}
/// Close the writer and make sure all data have been stored.
pub fn close(&mut self) -> Result<()> {
self.inner.close()
}
/// Convert writer into [`StdWriter`] which implements [`std::io::Write`],
pub fn into_std_write(self) -> StdWriter {
StdWriter::new(self.inner)
}
}