JS脚本与服务器交互完成业务处理

最近一直在做关于调用客户端本地的DLL与服务器进行进行协作交互的工作,这里的难点在于与客户端DLL的交互并不是一次性的完成,通常情况下需要实现"在客户端开始事务,在服务器开始事务,在客户端提交,在服务器端提交"这样的逻辑顺序的事,这对于B/S的结构来说是比较难处理的.下面我把我这些天的工作成果拿出来和大家分享一下.

 

分析设计模型

技术方案模型

目标

由于医保是目前与HIS系统唯一需要接口的业务,且由于各地区的医保接口不相同,也不相通,但是主要的业务的处理模型基本上是相通的,即都需要进行收费明细处理.为满足能够灵活的支持各种医保接口且减少我们自己的HIS系统与医保接口的强藕合,则需要对医保的业务处理进行必要的抽象建模.

但是,由于B/S系统需要考虑交互上的问题,则对这个业务的需求就需要使用JS来完成.JS有一定的面向对象的机制,但不是很全面,目前的了解应该可以采用变通的方式实现抽象.

JS对象模型

1.对象图

这里,采用了类图的描述方式,但是实现的方式需要采用变通的方法

1.         OCXBase:OCX完成与对本地医保的接口调用封装,使JS可以与医保接口交互,每一种医保类型需要一个具体的实现,OCX对外暴露的接口允许变化,这是因为每种医保都有各自的业务规则且提供的接口形式也不尽相同,这个规则的变动只需要具体的JS业务类知道,针对于各个医保的JS对其变化进行了封装.

2.         服务器端业务:这个可以以WebService的形式或者页面来实现,主要是针对各种不同的医保返回的数据进行处理,例如需要保存各种医保的返回数据,以为将来的报表查询提供原始数据.另外,在这个业务处理过程还要处理我们自身的业务.

3.         JS业务类:因为是JS的实现,所以不可能将OCX和服务器端的业务类以引用的形式传给它,限于技术上的约束,这里对OCX和服务器端均需要采用字符串用来标识它们.JS业务类需要保持对象的对外暴露的接口,在其内部,它可以根据业务的需要来协调调用本地OCX控件与医保接口的接互,和对服务器端业务类的远程异步调用来完成医保数据与我们自身业务数据的处理.

2.调用关系时序图

调用首先由客户端页面来触发,JS得到其所需要的业务数据,然后将数据发送给OCX控件用来与医保接口交互和调用服务器端业务类进行数据的处理,服务器端的业务类即要处理医保的业务又要处理我们自身的业务.

在这里,调用OCX对象和异步远程调用服务器的业务类是可以由JS业务类来决定调用的顺序的,因为这里可能存在的变化点是根据医保接口的特点其处理的过程可能会因此而发生变化,那么也就是说,在JS的这个业务处理的过程中将变化点封装在它的内部,而不需要暴露给页面的代码进行处理.

最后,如果全部处理成功,则需要异步回调当前页面,对当前页面的某些控件进行刷新,或者执行打印报表一类的操作.

3.对现有方案的思考

 

现有的方案是页面与医保的接口进行的强耦合,即由页面级的代码来区别各种医保类型然后加以处理,由于各种医保接口的不尽相同,则势必在页面级别编写各种类型的JS与各种类型的OCX进行交互,页面上会存在很多判断来确定是何种医保类型,然后才去决定应该进行何种的业务处理,如果医保的接口变动,或者新增医保类型,那么在页面上进行代码的修改将会变得很麻烦.另外,由于B/S的特殊性,动态执行某些功能时需要经常性的向页面注册脚本也会使处理过程变的更加复杂.

而采用与医保处理分离的方式,则可以页面与医保的处理独立进行,减小依赖,便于扩展和修改.

系统实现

依赖关系概述

从上面的分析可以确定,客户端的JS类和服务器端的业务类应该彼此了解对方的处理细节,它们之间是有很强的依赖性的,所以在实现具体的JS客户端业务类与具体的服务器端业务类时可以互相约定一些调用过程的细节.这里指的具体的含义是某种医保的业务类型,这就会形成某个业务类,会分别有具体的JS业务对象和服务器端的业务对象.

调用服务器端业务类的方式

JS客户端业务对象需要调用服务器端的业务处理逻辑,这里客户端的需要异步请求以不刷新页面,那么这个方案自然是要采用XMLHttpRequest的,那么服务器端的业务处理以何种方式暴露给JS客户端业务对象呢?可选的方案有WebService,我们可以使用XMLHttpRequest可以传递Post或者Get参数,然后在WebService进行判断再处理.

但是这里存在一个问题,就是这里的业务类是需要处理我们自身业务的,即需要我们自身业务处理所需要的参数.我们倒着来演绎一下这个参数是从哪来的:

1.         服务器业务处理的这些参数从哪来呢?由JS业务类传入?

2.         JS从哪里获取业务处理所需的数据呢?在调用JS业务类的方法时传进来.

3.         在调用JS业务类的方法时如何传进来?触发业务时组织数据传入.

4.         触发业务时如何组织数据呢?这就回到原始的数据点了.

从功能上可以得知,触发事件的点是在客户端的页面中,那么获取数据可以通过DOM或者回服务器组织数据.通过DOM的方式,则需要与页面进行强藕合,且有可能组织不全处理所需的参数.回服务器组织参数,则需要后台的页类来处理,而后台的页面又如何知道具体的业务需要哪些数据呢?这就又造成了强藕合.即使通过服务器的业务类来组织数据,但是让一大堆参数数据传来传去也不是很爽,与现有的模型冲突太大.

那么有没有一种方案,能够做到让服务器端的页面完成完整的生命周期, 然后我们就可以读取各个控件的值了?有的,因为了解了AJAX的原理和ASP.Net2.0的异常回调模型后,就会发现这种方案是完全可行的,分析Asp.net2.0的异常回调模型是一个很大的议题,我在这里就不讨论它了.我将微软的JS代码修改后封装到WebForm_DoCallback中,使用这个函数进行提交的时候可以将ViewState和Form里的值提交回去,这样就会使后台页面的IsPostback为真,可以正常读取控件的值,然后再在页面级进行检查后,再调用业务类进行业务处理,参数传递自然也变成了一件简单的事情.

JS业务类上传服务器的消息格式

消息格式采用XML格式,如下所示:

<?xml version="1.0"?>

<Message>

 <Class></Class>

 <Command></Command>

 <ClientParams></ClientParams>

 <ClientReturn></ClientReturn>

 <ServerParams></ServerParams>

 <ServerReturn></ServerReturn>

</Message>

 

l         Class:标识了调用功能的JS的业务类标志.

 

l         Command:命令字标识

l         ClientParams:调用客户端JS函数时的传入参数.

l         ClientReturn:调用客户端JS与OCX交互时产生的返回值.

l         ServerParams:需要调用服务器的功能的参数

l         ServerReturn:服务器端的返回值,这个主要是保存上次调用时的返回值.

JS业务类的实现代码

医保基类

//<summary>构造函数</summary>
//<param name="param">显示错误信息的容器</param>
//<returns></returns>
function MedicareBase(errContainer)
{
    this.ErrContainer=errContainer;
    
    //保留属性定义
    
    this._MessagePacketFlag="<?xml version=\"1.0\"?>";
    
    this._BeginMessageFlag="<Message>";
    this._EndMessageFlag="</Message>";
    
    this._BeginClassFlag="<Class>";
    this._EndClassFlag="</Class>";
    
    
    this._BeginNoTransCommand="<Command Transaction='No'>";
    this._BeginBeginTransCommand="<Command Transaction='Begin'>";
    this._BeginCommitTransCommand="<Command Transaction='Commit'>";
    this._BeginRollTransCommand="<Command Transaction='Rollback'>";
    
    this._EndCommandFlag="</Command>";
    
    this._BeginClientParamsFlag="<ClientParams>";
    this._EndClientParamsFlag="</ClientParams>";
        
    this._BeginClientReturnFlag="<ClientReturn>";
    this._EndClientReturnFlag="</ClientReturn>";
    
    this._BeginServerParamsFlag="<ServerParams>";
    this._EndServerParamsFlag="</ServerParams>";
    
    this._BeginServerReturnFlag="<ServerReturn>";
    this._EndServerReturnFlag="</ServerReturn>";
    
    this._JSClientCommand="JSClientCommand";
}

//<summary>获取以0或-1开头的真假值</summary>
//<param name="param"></param>
//<returns>true/false</returns>
MedicareBase.prototype._GetBoolean=function(str)
{
    try
    {
        if (str.substring(0,1)=='0')
        {
            return true;
        }
        else
        {
            return false;
        }
    }
    catch(e)
    {
        return false;
    }
};

//<summary>去掉成功与否的标记,获取Server的返回值</summary>
//<param name="param"></param>
//<returns></returns>
MedicareBase.prototype._GetReturnString=function(str)
{
    var digits = "0123456789"; 
    try
    {
        if (str.length==0)
        {
            return str;
        }
        
        if (str.charAt(0) == "e" || str.charAt(0) == "s")
        {
            return str.substring(1);
        }
        
        else
        {
            for(i=0;i<str.length;i++)
            {
                if (str.substring(i,1)!='-' && digits.indexOf(str.substring(i,1))==-1)
                {
                    break;
                }
            }
        }
        
        return str.substring(i);
    }
    catch(e)
    {
        return str;
    }
};

//<summary>去掉成功与否的标记,获取Server的返回值</summary>
//<param name="param"></param>
//<returns></returns>
MedicareBase.prototype._GetReturnFlag=function(str)
{
    var digits = "0123456789"; 
    try
    {
        if (str.length==0)
        {
            return str;
        }
        var i=0;
        if (str.charAt(0) == "e" || str.charAt(0) == "s")
        {
            return '-1';
        }
        else
        {
            for(i=0;i<str.length;i++)
            {
                if (str.substring(i,1)!='-' && digits.indexOf(str.substring(i,1))==-1)
                {
                    break;
                }
            }
        }
        return str.substring(0,i-1);
    }
    catch(e)
    {
        return str;
    }
};

//<summary>获取首行</summary>
//<param name="param"></param>
//<returns></returns>
MedicareBase.prototype._GetFirstLine=function(str)
{
    var i=0;
    for(i=0;i<str.length;i++)
    {
        if (str.substring(i,i+1)=='\r' || str.substring(i,i+1)=='\n')
        {
            break;
        }
    }
    
    return str.substring(0,i);
};

//<summary>显示成功后的信息</summary>
//<param name="param">消息文本</param>
//<returns></returns>
MedicareBase.prototype._ShowSuccessMsg=function(str)
{
    //判断一下是否为空,为空则不显示提示,将来确定何时来显示这个框时可以在参数里加标志
    if (str!="")
    {
        alert(str);
    }
};

//<summary>显示失败后的信息</summary>
//<param name="param">消息文本</param>
//<returns></returns>
MedicareBase.prototype._ShowFailurMsg=function(str)
{
    if (typeof(errContainer)=="undefined")
    {
        alert(str);
    }
    else
    {
        var control=document.getElementById(errContainer);
        if (typeof(control)=="undefined")
        {
            alert(str);
        }
        else
        {   
            control.value=str;
        }
    }
};

    //默认读卡返回真
MedicareBase.prototype.ReadCard=function()
{
    return true;
};

    //默认挂号返回真
MedicareBase.prototype.Registration=function()
{
    return true;
};

医保具体类

//构造函数 
    //objID:OCX控件ID 
    //remoteService:远程后台服务  
    //callBack:目前为AjaxManagerID 
    //userName:操作员
    //errContainer:错误信息的容器
    function SYMedicare(objID,callBack,userName,errContainer)
    {
        MedicareBase.call(this,errContainer);                    //使属性继承
        
        this.ObjID=objID;
        this.UserName=userName;
        this.CallBack=callBack;
        
        
        //私有属性
        this._personAccountInfo="";
        
    }
    
//方法定义 SYMedicare.prototype=new MedicareBase();必需是定义方法前的第一行
    SYMedicare.prototype=new MedicareBase();
    
    //<summary>向服务器发送信息,将来可以根据是发送到WS还是后台页面来做修改</summary>
    //<param name="param">发送的信息</param>
    //<returns>[0,-1]|ReturnMessage</returns>
    SYMedicare.prototype._SendDataToServer=function(param)
    {
        //使用ASP.net2.0的WebForm_DoCallback异步机制,使用修改后的函数
        var result=WebForm_DoCallback(param);
        return this._GetFirstLine(result);
    }
    
    //<summary>重置状态</summary>
    //<returns></returns>
    SYMedicare.prototype._Reset=function()
    {
        this._personAccountInfo="";
    }
    
    //<summary>对发送的消息打包</summary>
    //<param name="clientParams">调用客户端时的参数</param>
    //<param name="clientReturn">调用客户端产生的返回值</param>
    //<param name="serverParams">调用服务器端需要的业务的参数</param>
    //<param name="serverReturn">上一次服务器端的返回值</param>
    //<param name="rollBack">是否为回滚命令</param>
    //<param name="commandText">命令字</param>
    //<returns></returns>
    MedicareBase.prototype._PacketMessage=function(clientParams,clientReturn,
            serverParams,serverReturn,commandType,commandText)
    {
        var msg=new StringBuilder();
        
        msg.append(this._MessagePacketFlag);
        msg.append(this._BeginMessageFlag);
        
        msg.append(this._BeginClassFlag);
        msg.append("SYMedicare");
        msg.append(this._EndClassFlag);
        
        msg.append(commandType);
        msg.append(commandText);
        msg.append(this._EndCommandFlag);

        msg.append(this._BeginClientParamsFlag);
        msg.append(clientParams= (typeof(clientParams)=="undefined")?"":clientParams);
        msg.append(this._EndClientParamsFlag);
        
        msg.append(this._BeginClientReturnFlag);
        msg.append(clientReturn= (typeof(clientReturn)=="undefined")?"":clientReturn);
        msg.append(this._EndClientReturnFlag);
        
        msg.append(this._BeginServerParamsFlag);
        msg.append(serverParams= (typeof(serverParams)=="undefined")?"":serverParams);
        msg.append(this._EndServerParamsFlag);
        
        msg.append(this._BeginServerReturnFlag);
        msg.append(serverReturn= (typeof(serverReturn)=="undefined")?"":serverReturn);
        msg.append(this._EndServerReturnFlag);
        
        msg.append(this._EndMessageFlag);
        return msg.toString();
    };
    
    //<summary>读卡</summary>
    //<param name="param">数值型1~7或者x+y的形式</param>
    //<param name="callbackFlag">是否回调 true/false,默认为true</param>
    
    //<returns>读卡产生的消息或者出错信息</returns>
    SYMedicare.prototype.ReadCard=function(param,callbackFlag,callServer)
    {
        callbackFlag= (typeof(callbackFlag)=="undefined")?true:callbackFlag;
        callServer= (typeof(callServer)=="undefined")?true:callServer;
        
        var control=document.getElementById(this.ObjID);
        var objMsg="";
        
        //对参数要进行判断,如果是a+b+c形式的,需要多次读卡,并将读出的信息用符号~连接起来
        var readPara=String(param).split('+');
        for(var i=0;i<readPara.length;i++)
        {
            var m=control.ReadCard(readPara[i]);
            if (control.GetBoolean(m))
            {
                if (objMsg=="")
                {
                    objMsg=m;
                }
                else
                {
                    objMsg+="~"+m;
                }
                
            }
            else
            {
                if (callbackFlag==true)
                {
                    this._ShowFailurMsg(control.GetReturnString(m));
                }
                return m;
            }
        }

        if (callServer==true)
        {
            var serverResult=false;
            //调用服务器端业务逻辑处理读卡
            
            var s=this._PacketMessage(param,objMsg,"","",this._BeginNoTransCommand,"ReadCard");
            
            var serverMsg=this._SendDataToServer(s);
            serverResult=this._GetBoolean(serverMsg);
            
            if (serverResult==true)
            {
                this._ShowSuccessMsg(this._GetReturnString(serverMsg));
            }
            else
            {
                this._ShowFailurMsg(this._GetReturnString(serverMsg));
            }
            
            s=this._PacketMessage(param,objMsg,"",serverResult,this._BeginNoTransCommand,"ReadCard");
        }
        if (callbackFlag==true)
        {
            var managerName=this.CallBack.toString();
            window[managerName].AjaxRequest(this._JSClientCommand+','+s);
        }
        return objMsg;
    }
    
    //<summary>挂号服务</summary>
    //<param name="param">参数约定: MedType|BillNO|InHosNo|SysDate|DiseaseNO|DiseaseName</param>
    //<param name="callbackFlag">是否回调 true/false,默认为true</param>
    //<param name="transType">挂号类别</param>
    //<returns>挂号产生的消息或者出错信息</returns>
    SYMedicare.prototype._RegistrationAll=function(param,callbackFlag,commandText,transType)
    {
        callbackFlag= (typeof(callbackFlag)=="undefined")?true:callbackFlag;
        
        var objMsg="";
        var control=document.getElementById(this.ObjID);
        
        var strParam=new String(param);
        var paramArray=strParam.split("|");
        if (paramArray.length<6)
        {
            this._ShowFailurMsg("挂号参数传递错误");
            return;
        }

        objMsg=this.ReadCard(7,false,false);
        if (control.GetBoolean(objMsg)==false)
        {
            this._ShowFailurMsg(control.GetReturnString(objMsg));
            return objMsg;
        }
        
        this._personAccountInfo=control.GetReturnString(objMsg);
        
        objMsg=control.Registration(this._personAccountInfo,transType,
                        paramArray[0],paramArray[1],paramArray[2],paramArray[3],
                        paramArray[4],this.UserName,paramArray[5]);
        
        if (control.GetBoolean(objMsg)==true)
        {
            var serverResult=false;
            //调用服务器端业务逻辑处理挂号
            
            var s=this._PacketMessage(param,objMsg,"","",this._BeginBeginTransCommand,commandText);
            var serverMsg=this._SendDataToServer(s);
            serverResult=this._GetBoolean(serverMsg);
                
            //如果服务器端返回成功,则提交本地
            if (serverResult==true)
            {
                objMsg=control.CommitTrans();
                //判断接口是否提交成功,不成功则调用服务器端撤销业务
                if (control.GetBoolean(objMsg)==false)
                {
                    s=this._PacketMessage(param,objMsg,"",serverMsg,this._BeginRollTransCommand,commandText);
                    this._SendDataToServer(s);
                    
                    this._ShowFailurMsg(control.GetReturnString(objMsg));
                    return objMsg;
                }
                else
                {
                    //这里应该再次调用服务器端确认提交数据,暂时未做
                    
                    this._ShowSuccessMsg(this._GetReturnString(serverMsg));
                    return serverMsg;
                }
            }
            else
            {
                control.RollbackTrans();
                this._ShowFailurMsg(this._GetReturnString(serverMsg));
                return serverMsg;
                
            }
            //回调
            if (callbackFlag==true)
            {
                window[this.CallBack].AjaxRequest('Registration,'+paramArray[0]+','+objMsg+","+serverMsg);
            }
            return objMsg;
        }
        else
        {
            this._ShowFailurMsg(control.GetReturnString(objMsg));
            return objMsg;
        }
    }
    
    //<summary>挂号</summary>
    //<param name="param">参数约定: MedType|BillNO|InHosNo|SysDate|DiseaseNO|DiseaseName</param>
    //<param name="callbackFlag">是否回调 true/false</param>
    //<returns>挂号产生的消息或者出错信息</returns>
    SYMedicare.prototype.Registration=function(param,callbackFlag)
    {
        return this._RegistrationAll(param,callbackFlag,"Registration","1");
    }
    
    //<summary>退号</summary>
    //<param name="param">参数约定: MedType|BillNO|InHosNo|SysDate|DiseaseNO|DiseaseName</param>
    //<param name="callbackFlag">是否回调 true/false</param>
    //<returns>挂号产生的消息或者出错信息</returns>
    SYMedicare.prototype.UnRegistration=function(param)
    {
        return this._RegistrationAll(param,callbackFlag,"UnRegistration","-1");
    }

服务器端的实现代码

消息解析器

/// <summary>
/// JS医保类的消息解析器,目前版本只解析出来可用的文本,将来可能将解析出来的结果自动创建对应的类
/// 当前只有各返回值都只有一个参数,如果有多参数,则用特殊符号分隔
/// </summary>
public class MsgParser
{
    /// <summary>
    /// 消息的命令的事务类型
    /// </summary>
    public enum MsgTransactionType
    {
        /// <summary>
        /// 无事务
        /// </summary>
        NoTransaction,

        /// <summary>
        /// 开起事务
        /// </summary>
        BeginTransaction,

        /// <summary>
        /// 提交事务
        /// </summary>
        CommitTransaction,

        /// <summary>
        /// 回滚事务
        /// </summary>
        RollbackTransaction
    }
    /// <summary>
    /// 对消息命令的封装
    /// </summary>
    public class MsgCommand
    {
        private string _commandName;
        private MsgTransactionType _transType;

        /// <summary>
        /// 构造函数
        /// </summary>
        /// <param name="commandName">命令字</param>
        /// <param name="isRollback">回滚操作标志</param>
        public MsgCommand(string commandName, MsgTransactionType transType)
        {
            _commandName = commandName;
            _transType = transType;
        }

        /// <summary>
        /// 命令名
        /// </summary>
        public string CommandName
        {
            get
            {
                return _commandName;

            }
        }

        /// <summary>
        /// 事务类型
        /// </summary>
        public MsgTransactionType TransactionType
        {
            get
            {
                return _transType;
            }
        }

    }

    private XmlDocument _doc = null;
    private MsgCommand _command = null;
    private string _className = null;

    private string _clientParams;
    private string _clientReturn;
    private string _serverParams;
    private string _serverReturn;
    
    /// <summary>
    /// 构造函数
    /// </summary>
    /// <param name="msg">消息的XML文本</param>
    public MsgParser(string msg)
    {
        _doc = new XmlDocument();
        _doc.LoadXml(msg);

        //解析出类名
        _className = _doc.SelectSingleNode("Message/Class").InnerText;

        //解析出命令字
        XmlNode cmd = _doc.SelectSingleNode("Message/Command");

        MsgTransactionType tran = MsgTransactionType.NoTransaction;

        if (cmd.Attributes["Transaction"] != null)
        {
            switch (cmd.Attributes["Transaction"].Value)
            {
                case "No":
                    tran = MsgTransactionType.NoTransaction;
                    break;
                case "Begin":
                    tran = MsgTransactionType.BeginTransaction;
                    break;
                case "Commit":
                    tran = MsgTransactionType.CommitTransaction;
                    break;
                case "Rollback":
                    tran = MsgTransactionType.RollbackTransaction;
                    break;
                default:
                    throw new Exception(cmd.Attributes["Transaction"].Value + ",未知的命令事务类型");
            }
        }

        _command = new MsgCommand(cmd.InnerText, tran);

        _clientParams = _doc.SelectSingleNode("Message/ClientParams").InnerText;

        _clientReturn = _doc.SelectSingleNode("Message/ClientReturn").InnerText;

        _serverParams = _doc.SelectSingleNode("Message/ServerParams").InnerText;

        _serverReturn = _doc.SelectSingleNode("Message/ServerReturn").InnerText;

    }


    /// <summary>
    /// 消息命令
    /// </summary>
    public MsgCommand Command
    {
        get
        {
            return _command;
        }
    }

    /// <summary>
    /// JS的类名
    /// </summary>
    public string ClassName
    {
        get
        {
            return _className;
        }
    }

    /// <summary>
    /// 客户端的调用时的参数
    /// </summary>
    public string ClientParams
    {
        get
        {
            return _clientParams;
        }
    }

    /// <summary>
    /// 客户端的返回值
    /// </summary>
    public string ClientReturn
    {
        get
        {
            return _clientReturn;
        }
    }

    /// <summary>
    /// 要求服务器完成业务时的数据
    /// </summary>
    public string ServerParams
    {
        get
        {
            return _serverParams;
        }
    }

    /// <summary>
    /// 上一次服务器返回的数据
    /// </summary>
    public string ServerReturn
    {
        get
        {
            return _serverReturn;
        }
    }
}

业务类简单工厂

 

/// <summary>
///简单工厂:根据参数创建相应的医保业务类,将创建业务类集的逻辑封装在一点
/// </summary>
public class MedicareFactory
{

    private MedicareFactory()
    {

    }

    public static readonly MedicareFactory Instance = new MedicareFactory();

    /// <summary>
    /// 根据消息创建相应的医保类
    /// </summary>
    /// <param name="parser"></param>
    /// <returns></returns>
    public MedicareBase GetMedicare(MsgParser parser)
    {
        ReadCardType type;

        switch (parser.ClassName)
        {
            case "SYMedicare":
                type= ReadCardType.市医保卡;
                break;
            default:
                throw new Exception(parser.ClassName + "是当前系统尚未实现的医保类型");
                break;

        }

        switch (type)
        {
            case ReadCardType.市医保卡:
                return new Medicare_Sy();
                break;
            default:
                throw new NotImplementedException("尚未实现的医保类");
                break;
        }
    }
}

业务类基类

/// <summary>
/// 医保基类
/// </summary>
public abstract class MedicareBase
{
    #region 声明一些有关医保的常量

    /// <summary>
    /// JS客户端的命令前缀
    /// </summary>
    public const string JSCLIENTCOMMAND = "JSClientCommand";

    /// <summary>
    /// 读卡命令
    /// </summary>
    public const string READCARD = "ReadCard";

    /// <summary>
    /// 挂号命令
    /// </summary>
    public const string REGISTRATION = "Registration";

    #endregion

    /// <summary>
    /// 检验类名
    /// </summary>
    /// <param name="className"></param>
    protected abstract void ValidateClass(string className);

    /// <summary>
    /// 读卡获取医保病人信息
    /// </summary>
    /// <param name="msg"></param>
    /// <returns></returns>
    public abstract MedicarePatientBase ReadCard(MsgParser msg);

    /// <summary>
    /// 获取挂号的附加信息
    /// </summary>
    /// <param name="msg"></param>
    /// <returns></returns>
    public abstract RegistrationInfoBase GetRegistrationInfo(MsgParser msg);

}

业务类具体类

/// <summary>
/// 市医保业务类
/// </summary>
public class Medicare_Sy : MedicareBase
{
    private char[] spliter1 = new char[] { '~' };
    private char[] spliter2 = new char[] { '|' };

    /// <summary>
    /// 读出卡中的患者信息,在沈阳的JS客户端将卡内余额附在ClientParams消息中,并且
    /// 是两组消息,第一组为患者为7的,第二组为3的,两组用~分开
    /// </summary>
    /// <param name="msg"></param>
    /// <returns></returns>
    public override MedicarePatientBase ReadCard(MsgParser msg)
    {
        ValidateClass(msg.ClassName);

        MedicarePatientBase patient = null;
        string[] ps = msg.ClientReturn.Split(spliter1);
        if (ps.Length == 2)
        {
            patient = new MedicarePatientBase();

            //取卡号
                //1.去掉第一个|前的字符
            ps[0]=ps[0].Substring(1);
            ps[0] = ps[0].Trim(spliter2);
                //2.分解各个参数
            string[] paras = ps[0].Split(spliter2);
                //3.取医保卡号
            patient.CardNO = paras[9];

            //取余额
            ps[1] = ps[1].Substring(1);
            string balance = ps[1].Trim(spliter2);
            patient.Balance = Convert.ToDecimal(balance);
        }

        return patient;
    }

    /// <summary>
    /// 获取挂号客户端调用的参数字符串
    /// </summary>
    /// <param name="mediCategory">医疗类别</param>
    /// <param name="userName">登录用户名</param>
    /// <param name="diseaseNO">疾病编码</param>
    /// <param name="diseaseName">疾病名称</param>
    /// <returns></returns>
    public string GetRegistrationParams(string mediCategory,string userName,
                                        string diseaseNO,string diseaseName)
    {
        string p = "";

        Guid newRegId = Guid.NewGuid();

        DateTime regDateTime = DateTime.Now;

        string optDate = regDateTime.ToString("yyyyMMddhhmmss");

        //生成一个住院号
        string inHosNO = newRegId.ToString().Substring(0, 4) + optDate;
        string billNO = inHosNO;

        p = string.Format("{0}|{1}|{2}|{3}|{4}|{5}",
            mediCategory, billNO, inHosNO, optDate, diseaseNO, diseaseName);
        //将挂号将使用的Guid和挂号时间附到消息末尾,待消息传回后再取出,用来进行服务器端业务处理
        p += string.Format("|{0}|{1}", newRegId, regDateTime.ToString());
        return p;
    }

    /// <summary>
    /// 市医保的要求将挂号信息附加到客户端的调用参数后面
    /// </summary>
    /// <param name="info"></param>
    /// <param name="registrationID"></param>
    /// <param name="registrationTime"></param>
    /// <returns></returns>
    private string AttachRegistrationInfo(string info,Guid registrationID,DateTime registrationTime)
    {
        return info + string.Format("|{0}|{1}", registrationID, registrationTime);
    }
    
    /// <summary>
    /// 市医保的从ClientParams中取得RegistrationInfoBase信息
    /// </summary>
    /// <param name="msg"></param>
    /// <returns></returns>
    public override RegistrationInfoBase GetRegistrationInfo(MsgParser msg)
    {
        ValidateClass(msg.ClassName);

        string[] paras = msg.ClientParams.Split(spliter2);

        RegistrationInfoBase r = new RegistrationInfoBase();
        r.RegistrationID = new Guid(paras[paras.Length - 2]);
        r.RegistrationTime = DateTime.Parse(paras[paras.Length - 1]);

        return r;
    }


    protected override void ValidateClass(string className)
    {
        if (className.ToLower() != "SYMedicare".ToLower())
        {
            throw new Exception("医保类消息检验错误");
        }
    }
}

页面的处理过程

因为使用的是ASP.Net2.0的异步回调模型,所以要实现ICallbackEventHandler接口.

1.组织功能调用:通过触发客户端的页面上的提交事件(例如控钮触发),使服务器端接收到请求,然后需要组织JS业务类方法中所需的参数,这里需要Ajax技术的支持,以使页面不被刷新.
某按钮中的代码片断如下:

                //医疗类别
                string YllbCode = iMdt.GetEntityByPrimaryKey(new Guid(drpYLLB.Value)).NormalCode;

                McsillnessCodeEntity entity = iMc.GetEntityByPrimaryKey(new Guid(drpYBTB.Value));

                string p=new Medicare_Sy().GetRegistrationParams(YllbCode,CurrentUser.UserName,
                    entity.NormalCode,entity.CnName);

                string str = string.Format("Registration('{0}',true,'{1}')",
                                    p,this.Label6.ClientID);

                new JsHelper(this).RegisterClientScriptBlock(str);

这里需要根据页面上的选择来确定使用哪个医保的服务器端业务类,通过传递必要的参数后,由服务器端业务组织成JS业务端所需要的参数,最后动态注册JS脚本,使其返回时被执行,JS业务端执行时可以中断处理,然后产生一个对服务器端业务的请求.

2.接收JS业务端产生的请求:JS业务类处理完成后需要通知服务器进行处理,服务器可以在ICallbackEventHandler的接口方法的RaiseCallbackEvent(string eventArgument)会被调用.在这里就可以通过多态来屏蔽细节了.示例代码如下:

    #region ICallbackEventHandler 成员

    private string _returnMsg = "";

    public string GetCallbackResult()
    {
        return _returnMsg;
    }

    public void RaiseCallbackEvent(string eventArgument)
    {
        try
        {
            MsgParser msg = new MsgParser(eventArgument);

            switch (msg.Command.CommandName)
            {
                case MedicareBase.READCARD:
                    _returnMsg = "0";
                    break;
                case MedicareBase.REGISTRATION:
                    if (msg.Command.TransactionType==MsgParser.MsgTransactionType.BeginTransaction)
                    {
                        string s = "";
                        ReadCardType cardType = JSMessageHelper.GetReadCardType(msg.ClassName);
                        //取时挂号的Guid和挂号时间
                        string[] p = msg.ClientParams.Split(new char[] { '|' });
                        DateTime regTime = DateTime.Parse(p[p.Length - 1]);
                        Guid regID = new Guid(p[p.Length - 2]);
                        if (Registration(out s, cardType, regID, regTime))
                        {
                            _returnMsg = JSMessageHelper.BuildSuccessMsg(s);
                        }
                        else
                        {
                            _returnMsg = JSMessageHelper.BuildFailurMsg(s);
                        }
                    }

                    break;
                default:
                    _returnMsg = JSMessageHelper.BuildFailurMsg("未知的业务类型");
                    break;
            }
        }
        catch (Exception ex)
        {
            _returnMsg = JSMessageHelper.BuildFailurMsg(ex.Message);
        }
    }

    #endregion

其中_returnMsg是页面级的变量,是供异步返回时使用的.这个回调完成后,JS业务端得到返回值用来判断是否可以继续处理,如果出错则可以进行对客户端的回滚,如果成功则继续处理,处理完毕后需要调用客户端进行界面上的刷新.
3.接收JS业务端请求,完成界面的刷新:这里需要Ajax的配合,目前我使用的是Rad的AjaxManager,它提供一个回调的方法,我可以在服务器端接收到这个请求,示例代码如下:

    protected void DawAjaxManager1_AjaxRequest(object sender, AjaxRequestEventArgs e)
    {
            if (e.Argument.StartsWith(MedicareBase.JSCLIENTCOMMAND))
            {
                //得到消息体
                string[] ps = e.Argument.Split(new char[] { ',' });
                MsgParser parser = new MsgParser(ps[1]);

                MedicareBase medicare = MedicareFactory.Instance.GetMedicare(parser);
                switch (parser.Command.CommandName)
                {
                    case MedicareBase.READCARD:

                        MedicarePatientBase patient = medicare.ReadCard(parser);
                        txtCarNum.Text = patient.CardNO;
                        DawButton1_Click(null, null);
                        txtYe.Text = patient.Balance.ToString();

                        break;

                    case MedicareBase.REGISTRATION:

                        ShowSummary();

                        break;
                }
            }
    }

总结
通过使用这种模型,将业务处理逻辑分配到JS的业务类和服务器端的业务类,减少了页面对于业务处理的代码,达到了一定的业务抽象,便于扩展其它的医保类型.同时,对于JS的异步调用也解决了”中断函数－>同步请求服务－>根据返回值再继续处理”的技术问题,简化了与由于B/S处理这种与本地交互的而产生的复杂过程.