EBMIDE——服务脚本IOS

前言

之前，想到这样一个情景，用一个脚本来描述一个服务的操作，这样做的好处是，业务逻辑落到了配置文件。业务变化时只需通过修改配置，而不需要重新编译系统。

最近几天，由于工作需要，转到了服务器的研发，刚好碰上这一应用场合，终于有机会完成这一脚本的设计。

 

IOS简介

IOS是In/Out Script(输入/输出脚本)的简称，在我的设计中，用in，out，script3个节点来描述一个服务调用。

 

设计目标

采用XML作为服务的描述语言，因为目前XML解析的库已非常完善，采用XML能够省去大量的语法解析工作；

一个服务对外界的元素是输入参数和输出参数，所以定义了In，Out两个节点分别描述；

一个服务应该包含多个操作，这些操作有先后关系，赋值关系；

服务的多个操作应该支持顺序，分支，循环3个基本的执行方式；

服务执行过程中会产生临时变量，要支持临时变量的存放；

必须保证服务的多个操作的事务性；

服务的内部错误处理。

 

服务脚本节点定义

set节点

定义输入/输出参数：name参数名称

io节点

定义Invoke/Out操作：i执行脚本，o输出变量

if/elseif/else节点

定义条件执行节点：i执行判断脚本

foreach节点

定义循环遍历执行节点：i获取父项脚本，o输出子项变量

throwerror节点

定义引发异常节点：i获取异常信息脚本

error节点

定义错误处理节点

 

 

完整的服务脚本

<servicename="">------【服务节点】name:服务名称

   <in>------【输入参数】

     <setname=""/>

   </in>

   <out>------【输出参数】

     <setname=""/>

   </out>

   <scriptt="false">------【服务脚本】t：transaction事务控制

     <ioi=""o=""/>

     <ioi=""o=""/>

     <ifi="">

       <ioi=""o=""/>------if结果为true时执行

       <ioi=""o=""/>

       <elseifi="">

         <ioi=""o=""/>------elseif结果为true时执行

         <ioi=""o=""/>

       </elseif>

       <else>

         <ioi=""o=""/>------if/elseif所有结果为false时执行

         <ioi=""o=""/>

       </else>

     </if>

     <foreachi=""o="">

       <ioi=""o=""/>------i值必须是可遍历的数据类型，o值是遍历时的子项

       <ioi=""o=""/>

     </foreach>

     <throwerrori=""/>------引发异常能控制事务回滚

     <error>

       <ioi=""o=""/>

       <ioi=""o=""/>

     </error>

   </script>

 </service>

 

服务脚本引擎

用来解析执行服务脚本，是服务器的一个子模块。

 

服务脚本例子

例子1：创建实体对象服务

<servicename="NewEntity">

 <in>

   <setname="Type"/>

 </in>

 <out>

   <setname="New"/>

 </out>

 <scriptt="true">

   <ioi="CreateEntity(@Type)"o="New"/>

   <ioi="CreateDTS()"o="New.DTS"/>

   <ioi="InsertEntity(@New)"o="P1"/>

   <ifi="!@P1">

     <ioi="Null()"o="New"/>

   </if>

   <error>

     <ioi="Error()"o="New"/>

   </error>

 </script>

</service>

例子2：带文件操作和数据库操作，并且有事务控制的例子

<servicename="CreateSheet">

 <in>

   <setname="Template"type="string"/>

   <setname="Items"type="manifest"/>

 </in>

 <out>

   <setname="DTS"/>

   <setname="Error"/>

 </out>

 <scriptt="true">

   <!--创建文件映射?-->

   <ioi="CreateEntity('EBM.Data.File')"o="File"/>

   <ioi="CreateDTS()"o="File.DTS"/>

   <ioi="FormatDate(Date(),'yyyyMMdd')"o="File.Folder"/>

   <ioi="@File.DTS"o="File.Name"/>

   <ioi="'.fxl'"o="File.Ext"/>

   <ioi="GetDriver()"o="File.Driver"/>

   <ioi="ToFullPath(Concat(@File.Folder,'/',@File.Name,@File.Ext), @File.Driver)" o="SavePath"/>

   <!--创建文件-->

   <ioi="ToFullPath(@Template)"o="Path"/>

   <ioi="LoadSheet(@Path)"o="Sheet"/>

   <ioi="FillSheet(@Sheet, @Items)"o="Sheet"/>

   <ioi="InvokeSheet(@Sheet)"o="Sheet"/>

   <!--写文件-->

   <ioi="WriteText(@SavePath, @Sheet)"o="Success"/>

   <!--入库-->

   <ioi="InsertEntity(@File)"o="Success"/>

   <ifi="!@Success">

     <throwerrori="'错䨪误¨®：êoInsertEntity(@File)'"/>

   </if>

   <!--

   <throwerror i="'事务回滚测试'"/>

   -->

   <ioi="@File.DTS"o="DTS"/>

   <error>

     <ioi=""o="DTS"/>

     <ioi="Error()"o="Error"/>

   </error>

 </script>

</service>

 

 

相关文章

EBM专栏