using NewLife.Data;
using NewLife.Messaging;

namespace NewLife.Remoting;

/// <summary>Api会话</summary>
/// <remarks>
/// 在基于令牌Token的无状态验证模式中，可以借助Token重写IApiHandler.Prepare，来达到同一个Token共用相同的IApiSession.Items
/// </remarks>
public interface IApiSession : IExtend
{
    /// <summary>主机</summary>
    IApiHost Host { get; }

    /// <summary>最后活跃时间</summary>
    DateTime LastActive { get; }

    /// <summary>所有服务器所有会话，包含自己</summary>
    IApiSession[] AllSessions { get; }

    /// <summary>令牌</summary>
    String? Token { get; set; }

    ///// <summary>查找Api动作</summary>
    ///// <param name="action"></param>
    ///// <returns></returns>
    //ApiAction? FindAction(String action);

    ///// <summary>创建控制器实例</summary>
    ///// <param name="api"></param>
    ///// <returns></returns>
    //Object CreateController(ApiAction api);

    /// <summary>单向远程调用，无需等待返回</summary>
    /// <param name="action">服务操作</param>
    /// <param name="args">参数</param>
    /// <param name="flag">标识</param>
    /// <returns></returns>
    Int32 InvokeOneWay(String action, Object? args = null, Byte flag = 0);

    /// <summary>发送消息。用于流式推送等场景</summary>
    /// <param name="msg">消息</param>
    /// <returns></returns>
    Int32 SendMessage(IMessage msg);
}