reload method

Future<PersistentAccessSnapshot> reload({
  1. bool revalidateAvailable = false,
})

Reloads authoritative storage and retries temporarily unavailable entries.

Set revalidateAvailable to true to resolve available handles again. This can detect a deleted path or an entity-kind change with a path-based backend, but may wait on slow or disconnected volumes. The default preserves available entries without probing them again.

Implementation

Future<PersistentAccessSnapshot> reload({
  final bool revalidateAvailable = false,
}) {
  return _serializeOperation(() async {
    final prepared = await _prepareRecovery(
      cached: _entriesByHandle,
      retryUnavailable: true,
      revalidateAvailable: revalidateAvailable,
    );
    final recovered = await _recoverAndClean(
      cached: prepared.entriesByHandle,
    );
    await _acceptRecovery(recovered);
    return _snapshot;
  });
}