report a peer's port change locally without rewriting it

Keep IConfigurationManager source-compatible for plugin implementers.
2026-09-21 00:46:16 +10:00
parent a9d6c749fb
commit 483c739fb1
4 changed files with 153 additions and 18 deletions
@@ -90,8 +90,15 @@ namespace MediaBrowser.Common.Configuration
        /// Drops the locally cached copy of configuration another instance has written to the shared
        /// configuration directory, so the next read reloads it, and raises the local update event.
        /// </summary>
+        /// <remarks>
+        /// An implementation predating the invalidation bus keeps the default, which reports that it
+        /// cannot drop its cache rather than quietly leaving it stale. The caller applying a remote
+        /// notice treats that as a failed apply and logs it.
+        /// </remarks>
        /// <param name="key">The named configuration key, or <c>null</c> for the system configuration.</param>
-        void InvalidateCachedConfiguration(string? key);
+        /// <exception cref="NotSupportedException">The implementation cannot drop its cached configuration.</exception>
+        void InvalidateCachedConfiguration(string? key)
+            => throw new NotSupportedException(GetType().Name + " cannot drop configuration cached from the shared configuration directory, so writes by other instances will not be picked up.");
    }

    public static class ConfigurationManagerExtensions