using System;
using System.Collections.Generic;
using System.Text;
using System.Threading.Tasks;
using System.Threading;
using System.Net.WebSockets;
namespace Serein.Library.Network.WebSocketCommunication
{
///
/// 标记该类是处理模板,需要获取WebSocketServer/WebSocketClient了实例后,使用(Server/Client).MsgHandleHelper.AddModule()进行添加。
/// 处理模板需要继承 ISocketHandleModule 接口,否则WebSocket接受到数据时,将无法进行调用相应的处理模板。
/// 使用方式:
/// [AutoSocketModule(ThemeKey = "theme", DataKey = "data")]
/// public class PlcSocketService : ISocketHandleModule
/// 类中方法示例:void AddUser(string name,int age)
/// Json示例:{ "theme":"AddUser", //【ThemeKey】
/// "data": { // 【DataKey】
/// "name":"张三",
/// "age":35, } }
/// WebSocket中收到以上该Json时,通过ThemeKey获取到"AddUser",然后找到AddUser()方法
/// 然后根据方法入参名称,从data对应的json数据中取出"name""age"对应的数据作为入参进行调用。AddUser("张三",35)
///
///
[AttributeUsage(AttributeTargets.Class)]
public sealed class AutoSocketModuleAttribute : Attribute
{
public string ThemeKey;
public string DataKey;
}
///
/// 作用:WebSocket中处理Json时,将通过Json中ThemeKey 对应的内容(ThemeValue)自动路由到相应方法进行处理。
/// 如果没有显式设置ThemeValue,将默认使用方法名称作为ThemeValue。
/// 如果没有显式设置IsReturnValue标记为false,当方法顺利完成(没有抛出异常,且返回对象非null),会自动转为json文本发送回去
/// 如果返回类型为Task或Task<TResult>,将会自动等待异步完成并获取结果(无法处理Task<Task<TResult>>的情况)。
/// 如果返回了值类型,会自动装箱为引用对象。
/// 如果有方法执行过程中发送消息的需求,请在入参中声明以下类型的成员,调用时将传入发送消息的委托。
/// Action<string> : 发送文本内容。
/// Action<object> : 会自动将对象解析为Json字符串,发送文本内容。
/// Action<dynamic> : 会自动将对象解析为Json字符串,发送文本内容。
/// Func<string,Task> : 异步发送文本内容。
/// Func<object,Task> : 会自动将对象解析为Json字符串,异步发送文本内容。
/// Func<dynamic,Task> : 会自动将对象解析为Json字符串,异步发送文本内容。
///
[AttributeUsage(AttributeTargets.Method)]
public sealed class AutoSocketHandleAttribute : Attribute
{
///
/// 描述Json业务字段,如果不设置,将默认使用方法名称。
///
public string ThemeValue = string.Empty;
///
/// 标记方法执行完成后是否需要将结果发送。
/// 但以下情况将不会发送:
/// 1.返回类型为void
/// 2.返回类型为Task
/// 3.返回了null
/// 补充:如果返回类型是Task<TResult>
/// 会进行异步等待,当Task结束后,自动获取TResult进行发送(请避免Task<Task<TResult>>诸如此类的Task泛型嵌套)
///
public bool IsReturnValue = true;
}
internal class SocketHandleModel
{
public string ThemeValue { get; set; } = string.Empty;
public bool IsReturnValue { get; set; } = true;
}
}