diff options
Diffstat (limited to 'lib/VNLib.Data.Caching.ObjectCache/src/CacheEntry.cs')
-rw-r--r-- | lib/VNLib.Data.Caching.ObjectCache/src/CacheEntry.cs | 227 |
1 files changed, 227 insertions, 0 deletions
diff --git a/lib/VNLib.Data.Caching.ObjectCache/src/CacheEntry.cs b/lib/VNLib.Data.Caching.ObjectCache/src/CacheEntry.cs new file mode 100644 index 0000000..8644d1d --- /dev/null +++ b/lib/VNLib.Data.Caching.ObjectCache/src/CacheEntry.cs @@ -0,0 +1,227 @@ +/* +* Copyright (c) 2022 Vaughn Nugent +* +* Library: VNLib +* Package: VNLib.Data.Caching.ObjectCache +* File: BlobCache.cs +* +* BlobCache.cs is part of VNLib.Data.Caching.ObjectCache which is part of the larger +* VNLib collection of libraries and utilities. +* +* VNLib.Data.Caching.ObjectCache is free software: you can redistribute it and/or modify +* it under the terms of the GNU Affero General Public License as +* published by the Free Software Foundation, either version 3 of the +* License, or (at your option) any later version. +* +* VNLib.Data.Caching.ObjectCache is distributed in the hope that it will be useful, +* but WITHOUT ANY WARRANTY; without even the implied warranty of +* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +* GNU Affero General Public License for more details. +* +* You should have received a copy of the GNU Affero General Public License +* along with this program. If not, see https://www.gnu.org/licenses/. +*/ + +using System; +using System.Buffers.Binary; +using System.Runtime.CompilerServices; + +using VNLib.Utils.Memory; +using VNLib.Utils.Extensions; + +namespace VNLib.Data.Caching +{ + /// <summary> + /// A structure that represents an item in cache + /// </summary> + public readonly struct CacheEntry : IDisposable, IEquatable<CacheEntry> + { + private const int TIME_SEGMENT_SIZE = sizeof(long); + + private const int LENGTH_SEGMENT_SIZE = sizeof(int); + + private const int DATA_SEGMENT_START = TIME_SEGMENT_SIZE + LENGTH_SEGMENT_SIZE; + + + //Only contain ref to backing handle to keep struct size small + private readonly MemoryHandle<byte> _handle; + + + /// <summary> + /// Creates a new <see cref="CacheEntry"/> and copies the initial data to the internal buffer + /// </summary> + /// <param name="data">The initial data to store</param> + /// <param name="heap">The heap to allocate the buffer from</param> + /// <returns>The new <see cref="CacheEntry"/></returns> + public static CacheEntry Create(ReadOnlySpan<byte> data, IUnmangedHeap heap) + { + //Calc buffer size + int bufferSize = GetRequiredHandleSize(data.Length); + + //Alloc buffer + MemoryHandle<byte> handle = heap.Alloc<byte>(bufferSize); + + //Create new entry from handle + CacheEntry entry = new (handle, data.Length); + + //Get the data segment + Span<byte> segment = entry.GetDataSegment(); + + //Copy data segment + data.CopyTo(segment); + + return entry; + } + + [MethodImpl(MethodImplOptions.AggressiveInlining)] + private static int GetRequiredHandleSize(int size) + { + //Caculate the minimum handle size to store all required information, rounded to nearest page + return (int)MemoryUtil.NearestPage(size + DATA_SEGMENT_START); + } + + private CacheEntry(MemoryHandle<byte> handle, int length) + { + _handle = handle; + //Store data length, assumes the handle is large enough to store it + SetLength(length); + } + + + ///<inheritdoc/> + public readonly void Dispose() => _handle.Dispose(); + + + [MethodImpl(MethodImplOptions.AggressiveInlining)] + private readonly Span<byte> GetTimeSegment() => _handle.AsSpan(0, TIME_SEGMENT_SIZE); + + [MethodImpl(MethodImplOptions.AggressiveInlining)] + private readonly Span<byte> GetLengthSegment() => _handle.AsSpan(TIME_SEGMENT_SIZE, LENGTH_SEGMENT_SIZE); + + /// <summary> + /// Gets the size of the block of memory held by the underlying handle + /// </summary> + /// <returns>The size of the block held by the current entry</returns> + /// <exception cref="ObjectDisposedException"></exception> + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public readonly nuint GetMemoryUsage() + { + _handle.ThrowIfClosed(); + return _handle.ByteLength; + } + + + /// <summary> + /// Gets the last set time + /// </summary> + /// <returns>The last date stored</returns> + /// <exception cref="ObjectDisposedException"></exception> + public readonly DateTime GetCreatedTime() + { + //Get the time segment and write the value in big endian + ReadOnlySpan<byte> segment = GetTimeSegment(); + + long ticks = BinaryPrimitives.ReadInt64BigEndian(segment); + + //ticks back to + return new(ticks); + } + + /// <summary> + /// Sets the last modified time + /// </summary> + /// <param name="time">The new time to set the handle to</param> + /// <exception cref="ObjectDisposedException"></exception> + public readonly void SetTime(DateTime time) + { + //Get native ticks value + long timeData = time.Ticks; + + //Get the time segment and write the value in big endian + Span<byte> segment = GetTimeSegment(); + + BinaryPrimitives.WriteInt64BigEndian(segment, timeData); + } + + /// <summary> + /// Gets the length of the data segment + /// </summary> + /// <returns>The length of the data segment</returns> + /// <exception cref="ObjectDisposedException"></exception> + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public readonly int GetLength() + { + //Get the length segment + ReadOnlySpan<byte> segment = GetLengthSegment(); + //Recover the integer + return BinaryPrimitives.ReadInt32BigEndian(segment); + } + + private readonly void SetLength(int length) + { + //Get the length segment + Span<byte> segment = GetLengthSegment(); + + //Update the length value + BinaryPrimitives.WriteInt32BigEndian(segment, length); + } + + /// <summary> + /// Gets the stored data segment + /// </summary> + /// <returns>The data segment</returns> + /// <exception cref="ObjectDisposedException"></exception> + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public readonly Span<byte> GetDataSegment() + { + //Get the actual length of the segment + int length = GetLength(); + //Get the segment from its begining offset and + return _handle.AsSpan(DATA_SEGMENT_START, length); + } + + /// <summary> + /// Writes the specified segment to the internal buffer and resizes the buffer if necessary. + /// This operation overwrites any previously stored data + /// </summary> + /// <param name="data">The data segment to store</param> + /// <exception cref="ObjectDisposedException"></exception> + public readonly void UpdateData(ReadOnlySpan<byte> data) + { + //Calc required buffer size + int bufferSize = GetRequiredHandleSize(data.Length); + + //Resize handle if required + _handle.ResizeIfSmaller(bufferSize); + + //Reset data length + SetLength(data.Length); + + //Get the data segment + Span<byte> segment = GetDataSegment(); + +#if DEBUG + //Test segment length is equvalent to the requested data length + System.Diagnostics.Debug.Assert(segment.Length == data.Length); +#endif + //Copy data segment + data.CopyTo(segment); + } + + + ///<inheritdoc/> + public override bool Equals(object? obj) => obj is CacheEntry entry && Equals(entry); + + ///<inheritdoc/> + public override int GetHashCode() => _handle.GetHashCode(); + + ///<inheritdoc/> + public static bool operator ==(CacheEntry left, CacheEntry right) => left.Equals(right); + + ///<inheritdoc/> + public static bool operator !=(CacheEntry left, CacheEntry right) => !(left == right); + + ///<inheritdoc/> + public bool Equals(CacheEntry other) => other.GetHashCode() == GetHashCode(); + } +} |