/*******************************************************************************
 * Copyright(c) 2014 DongkeSoft All rights reserved. / Confidential
 * 类的信息：
 *      1.程序名称：IDKIBOSSPRD.cs
 *      2.功能描述：系统登录模块服务契约。
 * 编辑履历：
 *      作者            日期                版本            修改内容
 *      陈晓野          2014/09/16          1.00            新建
 *******************************************************************************/

using System.Data;
using System.ServiceModel;

using Dongke.IBOSS.PRD.WCF.DataModels;

namespace Dongke.IBOSS.PRD.WCF.Contracts
{
    /// <summary>
    /// 系统登录模块服务契约
    /// </summary>
    [ServiceContract(ConfigurationName = "DKIBOSSPRDService.IDKIBOSSPRD",
    Name = "IDKIBOSSPRD",
    Namespace = "Dongke.IBOSS.PRD.WCF.Contracts")]
    public interface IDKIBOSSPRD
    {
        #region 服务连接测试

        /// <summary>
        /// 服务连接测试
        /// </summary>
        /// <returns>服务连接测试结果</returns>
        [OperationContract]
        bool GetServiceState();

        #endregion

        #region 系统登录、退出、刷新菜单

        /// <summary>
        /// 系统登录
        /// </summary>
        /// <param name="requestEntity">系统登录请求</param>
        /// <returns>系统登录结果</returns>
        [OperationContract]
        LoginResultEntity DoLogin(LoginRequestEntity requestEntity);

        /// <summary>
        /// 刷新菜单
        /// </summary>
        /// <param name="requestEntity">系统登录请求</param>
        /// <returns></returns>
        [OperationContract]
        LoginResultEntity DoLoginRefresh(LoginRequestEntity requestEntity);

        /// 系统登出
        /// </summary>
        /// <param name="userID">用户ID</param>
        /// <returns></returns>
        [OperationContract(IsOneWay = true)]
        void Logout(int userID);

        #endregion

        #region 客户端升级

        /// <summary>
        /// 客户端升级判断
        /// </summary>
        /// <param name="version">客户端版本</param>
        /// <returns>客户端升级判断结果</returns>
        [OperationContract]
        NeedUpgradeResultEntity IsNeedUpgrade(string version);

        /// <summary>
        /// 下载更新程序
        /// </summary>
        /// <returns>更新程序</returns>
        [OperationContract]
        byte[] DownloadUpgradeFile(string flag = null);

        #endregion
    }
}