Ligg.EasyWinApp-101-Ligg.EasyWinForm: Application--启动,传入参数、读取Application级别配置文件、验证密码、软件封面、启动登录、StartForm

首先请在VS里打开下面的文件,我们将对源码分段进行说明:

步骤1:读取debug.ini文件

 

    首先读取当前文件夹(.ClientsForm)的debug.ini文件,该文件的args用于调试时传参,这样就不用每次都要到[Project/Properties]去设置[Commamd line argument]。在debug阶段设置debug=true;在release阶段设置debug=false,或者直接把该文件删除。如果运行.ClientsFormRun.exe没有带参数,传递参数就采用debug.ini文件的args。

步骤2:实例化BootStrap

 

    这段代码逻辑:先从授权证书读取数据,再把Key赋值给EncryptionHelper

    GlobalConfiguration(位于Ligg.EasyWinApp.ImplInterface GlobalConfiguration.cs )是Ligg.EasyWinForm项目和Ligg.EasyWinApp.Impl.xxxxCblp项目都可以访问的一个静态类。

    EncryptionHelper(位于Ligg.WinformBaseHelpers EncryptionHelper.cs)是一个加密解密的静态类。

 

步骤3:传参分解

    传参arg[0]之间以@分隔,arg[1] 即passedCultureName表示起始的Culture,下面是对传参的解释:

//##passedArg0 format

//###formTypeStr=0multiple view            

//invisibleStr@formTypeStr=0/multipleview@startAppStr@startFuncStr   @startViewMenuIdStr@startParams@startActionsStr@passwordStr@formTitle@usrCode@usrToken  passedCultureName

//###formTypeStr=1single view

//invisibleStr@formTypeStr=1/singleviewk@startAppStr@startZoneLocStr@inputZoneVars      @startParams@startActionsStr@passwordStr@formTitle@usrCode@usrToken  passedCultureName

formTypeStr=0 表示mutiple view,指用单窗体模拟多窗体的情况;formTypeStr=1,表示single view,指单个Zone组成一个窗体(这个在以后的章节里会详细介绍)。2种情况的传参有所区别。

2种情况的公用的传参:

invisibleStr=0或为空值表示窗体可见,否则不可见。这个暂时没有实现。

startAppStr=xxxx表示开始的应用(Application)。每个应用,对应一个Ligg.EasyWinApp.Impl.xxxxCblp项目,即对应一个xxxxCblp.dll(为了方便叙述,我们暂且把它称为后台),核心业务逻辑的处理都会放在这个dll里。每个应用都对应一整套配置放在.Applicationsxxxx(application name)文件夹下

startParams:应用级别参数,用‘,‘符号相隔。既会传给前台的StartForm,也会传给后台。满足需求的各种可选性。

startActionsStr:启始动作,只传给前台,在StartForm初始化完成后,会运行 StartForm里的Act方法一次。如弹出一个提示框或运行后台的某个服务的方法等。

passwordStr:启始密码,如果应用的配置要求输入密码,该参数如果不为空值且验证通过,则不会弹出弹窗。

formTitle:StartForm的Text; 如果为空值,StartForm的Text将会去abbrevAnnexes.xml按Function/Zone的Name读取。

usrCode :启动时传递的用户登录名。登录后会存储在GlobalConfiguration.UserCode里,由前台读取显示。

usrToken:启动时传递的用户登录令牌,登录时由后台的UserServic.Logon()产生并存储在GlobalConfiguration.UserToken里。由一个应用跳转到另(同)一个应用时会带这个参数,如验证通过,就不用再弹出登录窗口。这样可实现各应用间的SSO(单点登录)。

multiple view情况下:

startFuncStr: 开始的功能(Function),就是指一个Form,一套界面。如一个应用有管理员界面和用户界面,所以有2个Function。Function的配置在 .Applicationxxxx(application)ClientsFormFunctionsyyyy(function name)下。

startViewMenuIdStr:开始时的展示的View的菜单Id。如果为空,就会使用默认的展示View。

single view情况下:

startZoneLocStr: 开始的Zone的位置,zone会加入Public View,形成一个独立的Function。Zone的配置在 .Applicationxxxx(application)ClientsFormoneszzzz(Zone)下。

inputZoneVars: Zone级别参数,用‘,‘符号相隔。会传给前台的StartForm,在Zone 初始化时传入Zone,如果需求的可选项多的话,通过这个参数,不用定义很多Zone,只在Zone里配置选项就行了。

步骤4:设置路径,读取和设置应用启动参数

    在BootStrap的SetPaths方法里,当前路径已经被设置到执行文件的祖父目录。

  

    然后从配置文件.Applicationsxxxx(application)ApplicationStartParamSet.xml 读取并设置ApplicationStartParamSet的各属性。

    ImplementationDllPathAdapterFullClassName用于加载应用的Cblp的Dll;下面会介绍。

    SupportMultiCultures是否支持多文化,如果为false的话,界面上右上角不会显示文化/语言切换的部分。所有控件的显示不会从各个Annexes.xml读取,前台界面也不用配置各个Annexes.xml。

    VerifyPasswordAtStart/ShowSoftwareCoverAtStart/LogonAtStart既在ApplicationStartParamSet里配置,也可以在FunctionStartParamSet里配置,以ApplicationStartParamSet的配置为主。就是说,如果在 ApplicationStartParamSet配置为 true, FunctionStartParamSet里的配置不生效;如果在 ApplicationStartParamSet配置为false的话,可以在FunctionStartParamSet配置为true。假如每个 Function,每个Zone的配置由不同的人协作完成,在事关安全验证的配置上面,如果不必须验证,可以由参与人员根据需要来设置,如果必须验证,则总体控制。

    其他属性都是起始验证的一些设置,大家可以根据软件需要来补充或扩展代码,这里不多赘述。

步骤5:设置Culture

    读取配置文件.Applicationsxxxx(Aplication)Cultures Cultures.xml,设置静态类CultureHelper的缺省、当前的Culture;CultureHelper位于Ligg.WinformBaseHelpers CultureHelper.cs。

步骤6:验证起始密码

     大家可以追踪代码,这段代码就是弹出一个对话框验证起始密码。验证规则在ApplicationStartParamSet.PasswordVerificationRule里配置。

步骤7:设置功能(Function)起始参数,作为StartForm的属性

   //##set funcInitParamSet下的部分。大家可以自行查看。

步骤8:初始化应用的核心业务处理动态链接库 (CBLP.Dll)

 

    首先bootStrap.InitGlobalConfiguration把各参数传递给GlobalConfiguration供前台后台使用。

    然后CblpDllAdapter.Init初始化应用的CBLP.dll。详见上面代码,如果是调试阶段是直接实例化一个CBLP.dll的接口实施类Apdaper,这样就可以方便debug;如果是发布阶段,是加载CBLP.dll的接口实施类Adapter。

    加载CBLP.dll的接口实施类Adapter的优点:由于界面是由配置文件来决定的,所有应用共用一套启动和前台的代码,这些代码可以做到千年不变;由于基本过程控制和功能也是由配置文件来决定,所以后台cblp.dll可以只包括核心业务逻辑处理的代码,可以写的非常简单,写成函数式的就行了,如果有变动,修改后直接覆盖各cblp.dll就行了。按我多年的实施经验(不是代码经验),需求变更和多样化不大会体现在核心业务逻辑处理的代码修改,往往体现在界面/选项/流程上,这些如果可以通过配置来满足的话,那么这套框架就的价值就体现出来了。

步骤9:展示软件封面

    实际上就是实例化一个single view的StartForm,这个看了后面章节的介绍就明白了。

步骤10:验证用户登录令牌和登录

    为什么启动时会有用户登录令牌呢?这是由已启动的本应用或其他应用的实例通过System.Diagnostics.Process转过来的。如果前面的应用已登录,启动本应用时,用户登录令牌经过验证OK,那么就不用再登陆了,这也算实现单点登录吧。如果做成和Windows域帐号集成,只要从域的机器上启动本应用都不用登录就更完善了。

    登录也是实例化一个single view的StartForm。比显示软件封面稍微复杂的地方,是它要与后台的Userservice互动 ,验证登录密码,同时把USerCode和UserToken存储到GlobalConfiguration。这些都是通过配置实现的。看了后面章节的介绍就明白了。

步骤11:实例化StartForm

    最后就是用funcInitParamSet参数实例化StartForm。

    请在VS里打开下面的文件StartForm.cs

   

下面是代码, 首先在构造函数里把CblpDllAdapter.Adapter赋值给_Adapter,然后后台的各服务的方法全部通过各重载方法调用。

 

各重载方法:

请至 https://github.com/Liggin2019/Ligg.EasyWinApp/blob/master/demo/demo.rar 下载,运行Form-MutiView-ITSmaoa-AdmKt2和Form-MutiView-ITSmaoa-AdmKt3相关执行文件,查看其启动的配置。

StartForm布局(Layout)的各组成元素、样式怎么配合配置文件生成和变化,请看下一章节文档。

Ligg.EasyWinApp-102-Ligg.EasyWinFormFunction--ControlBox、Tray、Resize、Menu

原文地址:https://www.cnblogs.com/liggin2019/p/11824065.html