Trait AsyncFileReader 

pub trait AsyncFileReader:
    Debug
    + Send
    + Sync
    + 'static {
    // Required method
    fn get_bytes<'life0, 'async_trait>(
        &'life0 self,
        range: Range<u64>,
    ) -> Pin<Box<dyn Future<Output = Result<Bytes>> + Send + 'async_trait>>
       where Self: 'async_trait,
             'life0: 'async_trait;

    // Provided methods
    fn get_byte_ranges<'life0, 'async_trait>(
        &'life0 self,
        ranges: Vec<Range<u64>>,
    ) -> Pin<Box<dyn Future<Output = Result<Vec<Bytes>>> + Send + 'async_trait>>
       where Self: 'async_trait,
             'life0: 'async_trait { ... }
    fn file_size<'life0, 'async_trait>(
        &'life0 self,
    ) -> Pin<Box<dyn Future<Output = Result<Option<u64>>> + Send + 'async_trait>>
       where Self: 'async_trait,
             'life0: 'async_trait { ... }
}

Async interface for reading byte ranges from an HDF5 file.

Modeled after async-tiff’s AsyncFileReader trait. Implementations exist for object_store::ObjectStore, reqwest, and tokio::fs::File.

Required Methods

fn get_bytes<'life0, 'async_trait>( &'life0 self, range: Range<u64>, ) -> Pin<Box<dyn Future<Output = Result<Bytes>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Fetch the bytes in the given range.

Provided Methods

fn get_byte_ranges<'life0, 'async_trait>( &'life0 self, ranges: Vec<Range<u64>>, ) -> Pin<Box<dyn Future<Output = Result<Vec<Bytes>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Fetch multiple byte ranges. The default implementation calls get_bytes sequentially; ObjectReader overrides this with get_ranges().

fn file_size<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<Option<u64>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Return the total file size, if known. Used by BlockCache::pre_warm to fetch all blocks in parallel. The default returns None.

Trait Implementations

impl AsyncFileReader for Box<dyn AsyncFileReader + '_>

fn get_bytes<'life0, 'async_trait>( &'life0 self, range: Range<u64>, ) -> Pin<Box<dyn Future<Output = Result<Bytes>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Fetch the bytes in the given range.

fn get_byte_ranges<'life0, 'async_trait>( &'life0 self, ranges: Vec<Range<u64>>, ) -> Pin<Box<dyn Future<Output = Result<Vec<Bytes>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Fetch multiple byte ranges. The default implementation calls get_bytes sequentially; ObjectReader overrides this with get_ranges().

fn file_size<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<Option<u64>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Return the total file size, if known. Used by BlockCache::pre_warm to fetch all blocks in parallel. The default returns None.

Implementations on Foreign Types

impl AsyncFileReader for Box<dyn AsyncFileReader + '_>

fn get_bytes<'life0, 'async_trait>( &'life0 self, range: Range<u64>, ) -> Pin<Box<dyn Future<Output = Result<Bytes>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

fn get_byte_ranges<'life0, 'async_trait>( &'life0 self, ranges: Vec<Range<u64>>, ) -> Pin<Box<dyn Future<Output = Result<Vec<Bytes>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

fn file_size<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<Option<u64>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

impl AsyncFileReader for Arc<dyn AsyncFileReader + '_>

fn get_bytes<'life0, 'async_trait>( &'life0 self, range: Range<u64>, ) -> Pin<Box<dyn Future<Output = Result<Bytes>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

fn get_byte_ranges<'life0, 'async_trait>( &'life0 self, ranges: Vec<Range<u64>>, ) -> Pin<Box<dyn Future<Output = Result<Vec<Bytes>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

fn file_size<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<Option<u64>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Implementors

impl AsyncFileReader for ObjectReader

impl AsyncFileReader for ReqwestReader

impl<F: AsyncFileReader + Send + Sync> AsyncFileReader for BlockCache<F>

impl<T: AsyncRead + AsyncSeek + Unpin + Send + Debug + 'static> AsyncFileReader for TokioReader<T>