Struct opendal::raw::oio::ToFlatPager

pub struct ToFlatPager<A: Accessor, P> { /* private fields */ }

ToFlatPager will walk dir in bottom up way:

• List nested dir first
• Go back into parent dirs one by one

Given the following file tree:

.
├── dir_x/
│   ├── dir_y/
│   │   ├── dir_z/
│   │   └── file_c
│   └── file_b
└── file_a

ToFlatPager will output entries like:

dir_x/dir_y/dir_z/file_c
dir_x/dir_y/dir_z/
dir_x/dir_y/file_b
dir_x/dir_y/
dir_x/file_a
dir_x/

Note

There is no guarantee about the order between files and dirs at the same level. We only make sure the nested dirs will show up before parent dirs.

Especially, for storage services that can’t return dirs first, ToFlatPager may output parent dirs’ files before nested dirs, this is expected because files always output directly while listing.

Trait Implementations

impl<A, P> BlockingPage for ToFlatPager<A, P>where
    A: Accessor<BlockingPager = P>,
    P: BlockingPage,

fn next(&mut self) -> Result<Option<Vec<Entry>>>

Fetch a new page of Entry

impl<A, P> Page for ToFlatPager<A, P>where
    A: Accessor<Pager = P>,
    P: Page,

fn next<'life0, 'async_trait>(
    &'life0 mut self
) -> Pin<Box<dyn Future<Output = Result<Option<Vec<Entry>>>> + Send + 'async_trait>>where
    Self: 'async_trait,
    'life0: 'async_trait,

Fetch a new page of Entry