用户队列服务API

/// <summary>
/// 用户队列服务API
/// </summary>
public interface ICustomerQueueManager : IService
{
    /// <summary>
    /// 创建用户队列
    /// </summary>
    /// <param name="queueName">队列名称</param>
    [OperationContract(Name = "CreateQueue")]
    [WebGet(RequestFormat = WebMessageFormat.Json)]
    void CreateQueue(string queueName);

    /// <summary>
    /// 删除队列
    ///  - 分强制删除和非强制删除两种模式
    ///  - 强制删除: 队列如果不为空也会被删除
    ///  - 非强制删除: 队列如果不为空, 这不会被删除并抛出异常
    /// </summary>
    /// <param name="queueName">队列名称</param>
    /// <param name="forceDrop">true: 强制删除; false: 非强制删除</param>
    [OperationContract(Name = "DropQueue")]
    [WebGet(RequestFormat = WebMessageFormat.Json)]
    void DropQueue(string queueName, bool forceDrop);

    /// <summary>
    /// 检查队列是否存在
    /// </summary>
    /// <param name="queueName">要检查的队列名称</param>
    /// <returns>true: 存在, false: 不存在</returns>
    [OperationContract(Name = "HasQueue")]
    [WebGet(RequestFormat = WebMessageFormat.Json)]
    bool HasQueue(string queueName);

    /// <summary>
    /// 将咨询用户加入队列
    /// </summary>
    /// <param name="queueName">队列名称</param>
    /// <param name="record">咨询记录对象 - 如果将deskId设置为空则代表是新加入的客户.</param>
    /// <param name="enqueueMode">入队列模式: 0 - 替换模式, 1 - 重新排队模式</param>
    [OperationContract(Name = "Enqueue")]
    [WebGet(RequestFormat = WebMessageFormat.Json)]
    void Enqueue(string queueName, InquiryRecord record, int enqueueMode);

    /// <summary>
    /// 获取某个客户在队列中的位置
    /// </summary>
    /// <param name="queueName">队列名称</param>
    /// <param name="customerUserId">客户ID</param>
    /// <returns></returns>
    int Position(string queueName, string customerUserId);

    /// <summary>
    /// 将用户拉出队列
    /// </summary>
    /// <param name="queueName">队列名称</param>
    /// <param name="customerUserId">要拉出队列的客户ID, 如果为空则将第一个咨询客户拉出队列.</param>
    /// <returns>被拉出队列的访客记录对象</returns>
    [OperationContract(Name = "Dequeue")]
    [WebGet(RequestFormat = WebMessageFormat.Json)]
    InquiryRecord Dequeue(string queueName, string customerUserId);

    /// <summary>
    /// 将用户在不同队列间快速移动 (不提供comments)
    /// </summary>
    /// <param name="sourceQueueName">源队列</param>
    /// <param name="targetQueueName">目标队列</param>
    /// <param name="deskUserId">执行快速移动的客服用户ID</param>
    /// <param name="customerUserId">要快速移动的客户ID, 如果为空则对源队列的第一个咨询客户进行移动.</param>
    /// <param name="attachedComments">附加的备注信息</param>
    /// <returns>被移动的访客记录对象</returns>
    [OperationContract(Name = "QuickMove")]
    [WebGet(RequestFormat = WebMessageFormat.Json)]
    InquiryRecord QuickMove(string sourceQueueName, string targetQueueName, string deskUserId, string customerUserId, string attachedComments);

    /// <summary>
    /// 查看队列用户列表
    /// </summary>
    /// <param name="queueName">队列名称</param>
    /// <param name="count">要查看的数量</param>
    /// <returns>访客记录列表</returns>
    [OperationContract(Name = "ViewQueue")]
    [WebGet(RequestFormat = WebMessageFormat.Json)]
    List<InquiryRecord> ViewQueue(string queueName, int count);

    /// <summary>
    /// 获取队列长度
    /// </summary>
    /// <param name="queueName">要查询的队列名称</param>
    /// <returns>长度</returns>
    [OperationContract(Name = "Count")]
    [WebGet(RequestFormat = WebMessageFormat.Json)]
    int Count(string queueName);

    /// <summary>
    /// 获取所有队列名称
    /// </summary>
    /// <returns>队列名称列表</returns>
    [OperationContract(Name = "GetAllQueues")]
    [WebGet(RequestFormat = WebMessageFormat.Json)]
    List<string> GetAllQueues();
}