Shaker/Avalonia/Avalonia.Xaml.Interactions/Messaging/Internals/MessageHandlerDispatcher.cs

// Licensed to the .NET Foundation under one or more agreements.
// The .NET Foundation licenses this file to you under the MIT license.
// See the LICENSE file in the project root for more information.

using System.Runtime.CompilerServices;

namespace CommunityToolkit.Mvvm.Messaging.Internals;

/// <summary>
/// A dispatcher type that invokes a given <see cref="MessageHandler{TRecipient, TMessage}"/> callback.
/// </summary>
/// <remarks>
/// This type is used to avoid type aliasing with <see cref="Unsafe.As{T}(object)"/> when the generic
/// arguments are not known. Additionally, this is an abstract class and not an interface so that when
/// <see cref="Invoke(object, object)"/> is called, virtual dispatch will be used instead of interface
/// stub dispatch, which is much slower and with more indirections.
/// </remarks>
internal abstract class MessageHandlerDispatcher
{
    /// <summary>
    /// Invokes the current callback on a target recipient, with a specified message.
    /// </summary>
    /// <param name="recipient">The target recipient for the message.</param>
    /// <param name="message">The message being broadcast.</param>
    public abstract void Invoke(object recipient, object message);

    /// <summary>
    /// A generic version of <see cref="MessageHandlerDispatcher"/>.
    /// </summary>
    /// <typeparam name="TRecipient">The type of recipient for the message.</typeparam>
    /// <typeparam name="TMessage">The type of message to receive.</typeparam>
    public sealed class For<TRecipient, TMessage> : MessageHandlerDispatcher
        where TRecipient : class
        where TMessage : class
    {
        /// <summary>
        /// The underlying <see cref="MessageHandler{TRecipient, TMessage}"/> callback to invoke.
        /// </summary>
        private readonly MessageHandler<TRecipient, TMessage> handler;

        /// <summary>
        /// Initializes a new instance of the <see cref="For{TRecipient, TMessage}"/> class.
        /// </summary>
        /// <param name="handler">The input <see cref="MessageHandler{TRecipient, TMessage}"/> instance.</param>
        public For(MessageHandler<TRecipient, TMessage> handler)
        {
            this.handler = handler;
        }

        /// <inheritdoc/>
        public override void Invoke(object recipient, object message)
        {
            this.handler(Unsafe.As<TRecipient>(recipient), Unsafe.As<TMessage>(message));
        }
    }
}