Merge pull request #42707 from nextcloud/enh/noid/store-file-etag-at-metadata-creation

enh(metadata): store current file etag

2 files changed, 37 insertions, 0 deletions

diff --git a/lib/public/FilesMetadata/Model/IFilesMetadata.php b/lib/public/FilesMetadata/Model/IFilesMetadata.php
index 7697a2f37ad..024b21039bc 100644
--- a/lib/public/FilesMetadata/Model/IFilesMetadata.php
+++ b/lib/public/FilesMetadata/Model/IFilesMetadata.php
@@ -37,12 +37,14 @@ use OCP\FilesMetadata\Exceptions\FilesMetadataTypeException;
  *   "mymeta": {
  *     "value": "this is a test",
  *     "type": "string",
+ *     "etag": "abcd1234",
  *     "indexed": false,
  *     "editPermission": 1
  *   },
  *   "myapp-anothermeta": {
  *     "value": 42,
  *     "type": "int",
+ *     "etag": "0987zyxw",
  *     "indexed": true,
  *     "editPermission": 0
  *   }
@@ -113,6 +115,23 @@ interface IFilesMetadata extends JsonSerializable {
 	public function isIndex(string $key): bool;
 
 	/**
+	 * returns file etag stored during the last update of the metadata key
+	 *
+	 * @param string $key metadata key
+	 * @return string
+	 * @since 29.0.0
+	 */
+	public function getEtag(string $key): string;
+
+	/**
+	 * set file etag
+	 *
+	 * @param string $key metadata key
+	 * @since 29.0.0
+	 */
+	public function setEtag(string $key, string $etag): void;
+
+	/**
 	 * set remote edit permission
 	 * (Webdav PROPPATCH)
 	 *
diff --git a/lib/public/FilesMetadata/Model/IMetadataValueWrapper.php b/lib/public/FilesMetadata/Model/IMetadataValueWrapper.php
index d34cd070c8b..6c551efea81 100644
--- a/lib/public/FilesMetadata/Model/IMetadataValueWrapper.php
+++ b/lib/public/FilesMetadata/Model/IMetadataValueWrapper.php
@@ -286,6 +286,24 @@ interface IMetadataValueWrapper extends JsonSerializable {
 	public function getValueAny(): mixed;
 
 	/**
+	 * get stored etag value
+	 *
+	 * @return string stored etag
+	 * @since 29.0.0
+	 */
+	public function getEtag(): string;
+
+	/**
+	 * set etag value
+	 *
+	 * @param string $etag etag value
+	 *
+	 * @return self
+	 * @since 29.0.0
+	 */
+	public function setEtag(string $etag): self;
+
+	/**
 	 * @param bool $indexed TRUE to set the stored value as an indexed value
 	 *
 	 * @return self