Adam Hathcock
27 lines
1.7 KiB
C#
27 lines
1.7 KiB
C#
using System.Diagnostics.CodeAnalysis;
|
|
using Speckle.Sdk.Models;
|
|
using Speckle.Sdk.Serialisation;
|
|
|
|
namespace Speckle.Connectors.Common.Caching;
|
|
|
|
/// <summary>
|
|
/// <para>Stores object references resulting from a send operation. These can be retrieved back during a subsequent send operation to bypass conversion if
|
|
/// they have not been changed. On large sends with small changes, this makes the process much speedier!</para>
|
|
/// <para>Note: do not and should not persist between file opens, should just persist in memory between send operations. Always eagerly invalidate.</para>
|
|
/// <para>If you ever implement a different conversion cache, do remember that objects in speckle are namespaced to each project (stream). E.g., if you send A to project C and project D, A needs to exist twice in the db. As such, always namespace stored references by project id.</para>
|
|
/// <para>Further note: Caching is optional in the send ops; an instance of this should be injected only in applications <b>where we know we can rely on change tracking!</b></para>
|
|
/// </summary>
|
|
public interface ISendConversionCache
|
|
{
|
|
void StoreSendResult(string projectId, IReadOnlyDictionary<Id, ObjectReference> convertedReferences);
|
|
|
|
/// <summary>
|
|
/// <para>Call this method whenever you need to invalidate a set of objects that have changed in the host app.</para>
|
|
/// <para><b>Failure to do so correctly will result in cache poisoning and incorrect version creation (stale objects).</b></para>
|
|
/// </summary>
|
|
/// <param name="objectIds"></param>
|
|
void EvictObjects(IEnumerable<string> objectIds);
|
|
void ClearCache();
|
|
bool TryGetValue(string projectId, string applicationId, [NotNullWhen(true)] out ObjectReference? objectReference);
|
|
}
|