From b9c214f0bce073908fd3880f9ea63254fbaed070 Mon Sep 17 00:00:00 2001 From: Josh Date: Sat, 25 Apr 2026 12:44:28 -0400 Subject: [PATCH] docs(Storage): update docblock for Cache/StorageGlobal class Signed-off-by: Josh --- lib/private/Files/Cache/StorageGlobal.php | 13 ++++++------- 1 file changed, 6 insertions(+), 7 deletions(-) diff --git a/lib/private/Files/Cache/StorageGlobal.php b/lib/private/Files/Cache/StorageGlobal.php index 87116702d3a..b7d128d00a0 100644 --- a/lib/private/Files/Cache/StorageGlobal.php +++ b/lib/private/Files/Cache/StorageGlobal.php @@ -12,15 +12,14 @@ use OCP\DB\QueryBuilder\IQueryBuilder; use OCP\IDBConnection; /** - * Handle the mapping between the string and numeric storage ids + * Provides a process-local cache of persisted storage-id mappings. * - * Each storage has 2 different ids - * a string id which is generated by the storage backend and reflects the configuration of the storage (e.g. 'smb://user@host/share') - * and a numeric storage id which is referenced in the file cache + * Caches lookups in both directions: + * - string storage id to storage record + * - numeric storage id to storage record * - * A mapping between the two storage ids is stored in the database and accessible through this class - * - * @package OC\Files\Cache + * This class reduces repeated database lookups for storage mapping metadata + * and provides invalidation helpers for callers that update those records. */ class StorageGlobal { /** @var array */