src/MassTransit.Abstractions/Contexts/SerializerContext.cs - develop - vshmidt/masstransit

src/MassTransit.Abstractions/Contexts/SerializerContext.cs
61 строка2 KB
Chris Patterson
Massive file cleanup
27 мар 2024, 02:43
27 мар 2024, 02:432ac69e8
namespace MassTransit
{
    using System;
    using System.Collections.Generic;
    using System.Diagnostics.CodeAnalysis;
    using Serialization;


    public interface SerializerContext :
        MessageContext,
        IObjectDeserializer
    {
        string[] SupportedMessageTypes { get; }

        bool IsSupportedMessageType<T>()
            where T : class;

        bool IsSupportedMessageType(Type messageType);

        bool TryGetMessage<T>(out T? message)
            where T : class;

        bool TryGetMessage(Type messageType, [NotNullWhen(true)] out object? message);

        /// <summary>
        /// Returns a message serializer using the deserialized message ContentType, that can be used to
        /// serialize the message on another <see cref="SendContext" />.
        /// </summary>
        /// <returns></returns>
        IMessageSerializer GetMessageSerializer();

        /// <summary>
        /// Returns a message serializer using the deserialized message ContentType, that can be used to
        /// serialize the message on another <see cref="SendContext" />.
        /// </summary>
        /// <param name="envelope">The message envelope to modify</param>
        /// <param name="message">A message to overlay on top of the existing message, merging the properties together</param>
        /// <returns></returns>
        IMessageSerializer GetMessageSerializer<T>(MessageEnvelope envelope, T message)
            where T : class;

        /// <summary>
        /// Returns a message serializer using the deserialized message ContentType, that can be used to
        /// serialize the message on another <see cref="SendContext" />.
        /// </summary>
        /// <param name="message">A message to overlay on top of the existing message, merging the properties together</param>
        /// <param name="messageTypes">The supported message types</param>
        /// <returns></returns>
        IMessageSerializer GetMessageSerializer(object message, string[] messageTypes);

        /// <summary>
        /// Converts a message (or really any object) to a dictionary of string, object. This is serializer dependent, since
        /// JSON serializers use internal objects for object properties, to encapsulate nested properties, etc.
        /// </summary>
        /// <param name="message">The message</param>
        /// <typeparam name="T">The message type</typeparam>
        /// <returns></returns>
        Dictionary<string, object> ToDictionary<T>(T? message)
            where T : class;
    }
}