// Licensed to the .NET Foundation under one or more agreements.
// The .NET Foundation licenses this file to you under the MIT license.
 
using System.Buffers;
 
namespace Microsoft.AspNetCore.Components;
 
/// <summary>
/// Provides custom serialization logic for persistent component state values of type <typeparamref name="T"/>.
/// </summary>
/// <typeparam name="T">The type of the value to serialize.</typeparam>
public abstract class PersistentComponentStateSerializer<T> : IPersistentComponentStateSerializer
{
    /// <summary>
    /// Serializes the provided <paramref name="value"/> and writes it to the <paramref name="writer"/>.
    /// </summary>
    /// <param name="value">The value to serialize.</param>
    /// <param name="writer">The buffer writer to write the serialized data to.</param>
    public abstract void Persist(T value, IBufferWriter<byte> writer);
 
    /// <summary>
    /// Deserializes a value of type <typeparamref name="T"/> from the provided <paramref name="data"/>.
    /// This method must be synchronous to avoid UI tearing during component state restoration.
    /// </summary>
    /// <param name="data">The serialized data to deserialize.</param>
    /// <returns>The deserialized value.</returns>
    public abstract T Restore(ReadOnlySequence<byte> data);
 
    /// <summary>
    /// Explicit interface implementation for non-generic serialization.
    /// </summary>
    void IPersistentComponentStateSerializer.Persist(Type type, object value, IBufferWriter<byte> writer)
        => Persist((T)value, writer);
 
    /// <summary>
    /// Explicit interface implementation for non-generic deserialization.
    /// </summary>
    object IPersistentComponentStateSerializer.Restore(Type type, ReadOnlySequence<byte> data)
        => Restore(data)!;
}