基于TypeScript的FineUIMvc组件式开发（概述）

WebForm与Mvc

我简单说一下WebForm与Mvc，WebForm是微软很早就推出的一种WEB开发架构，微软对其进行了大量的封装，使开发人员可以像开发桌面程序一样去开发WEB程序，虽然开发效率得到了提高，但可控性会一差。而MVC框架的出现，使WEB开发又回到了请求与响应的开发模式下，可控性增强了，但开发难度也增加了，所以说在架构的选择上没有好与坏，只有适合自己的才是最好的。

FineUIMvc与IFrame

虽然FineUIMvc基于MVC架构，但是也沿用了WebForm页面开发的方式，所以一开始刚接触FineUIMvc时还有一点疑惑。在FineUIMvc中的控制器与视图之间存在着一定的耦合，但这对FineUIMvc来说应该不是什么问题，因为FineUIMvc本身并不是一个通用型的架构，FineUIMvc更适合拥有大量控件操作的项目，耦合的存在可以降低控件的操作难度。在官网的示例中，我们经常能看到在一个控制器中有多个可以返回视图的Action，特别是AppBoxMvc更是达到极致，一个控制器几乎包含了整个项目的全部分代码，这是我所不推荐的做法，所以我在后面对这方面会做一些约束。

在FineUIMvc中有很多容器控件都可以启用IFrame，IFrame之间的交互，在官网示例（http://fineui.com/demo_mvc/）的内联框架中也给出了示例，在这些示例中，大家经常会看到在很多地方都在调用ActiveWindow中的方法，这个也是FineUIMvc对活动窗体的封装。那你在调用ActiveWindow中的方法时，你就已明确的知道，当前的页面是在一个窗体中显示的，并且还是一个活动窗体，如果我们想重用这个页面，并将其放到其它非窗体的容器中，我们要么需要在页面中判断，要么再重新创建一个新的页面，这样必然会对页面的重用带来一些麻烦，同时如果需要在页面间传递一些数据，页面还需要事先知道父页面或同级页面中的方法，这也无形中增加了页面与页面之间的耦合。

FineUIMvc组件开发的基本概念

如果基于组件的方式去开发FineUIMvc项目，这样就可以解决上面所遇到的问题。首先组件是封闭性的，你只需要暴露你想暴露的事件与方法，同时组件不需要知道调用者的信息，调用者只需要监控组件所提供的事件，调用组件所提供的方法，就可以完成组件的操作。我们这里所指的组件，主要是在FineUIMvc中通过IFrame显示的页面，IFrame本身可以起到上下文隔离的作用，再加上在IFrame中显示的页面以组件的方式提供服务，这样页面的开发可以独立出来，而不用去考虑调用者所处在的上下文。

FineUIMvc组件的构成

通过上面的介绍大家应该都知道，我们这里的组件其实就是页面，组件与组件之间的交互，其实就是页面与页面之间的交互。一个页面一般要包含HTML文件、CSS文件及JS文件，由于我们是基于TS开发，所以这里的JS文件就是TS文件，HTML文件对应到MVC中就是CSHTML视图文件。如果我们要创建一个UserInfoComponent组件，那它对应到MVC中应该包含哪些文件及是什么样的结构呢，请看下图

图中用箭头所指向的文件就是我们UserInfoComponent组件所需要的文件，有人可能会问，开发一个组件需要这么文件吗，那组件的开发是不是很复杂。为了使前后端的开发更顺畅，我们需要一些辅助文件，所以这些文件都是必须的，但大家也不用担心，因为这些文件是通过FineUIMvcTools插件自动生成的，并且会在你更改视图及控制器代码时，会自动更新相应的文件。下面是这些文件说明：

UserInfoController.cs：这是MVC中的控制器文件，与普通控制器文件一样没有什么区别
UserInfoController.g.cs：控件引用定义文件，由工具生成，方便直接操作视图中的控件
UserInfoModels.cs：模型文件，这个文件中包含了与当前控制器相关的模型，其中有些模型是自动生成的
Index.cshtml：视图文件，对应控制器中的Index方法
Index.css：视图文件的样式文件
Main.cs：组件引导文件，由工具生成，一般不用修改此文件
UserInfoComponent.ts：组件的TS逻辑文件，组件在客户端的逻辑代码
UserInfoComponent.g.ts：组件的TS辅助文件，由工具生成，包含了控件TS引用定义、模型TS引用定义及TS的控制器中Action的调用方法

UserInfoComponent组件的开发过程

下面为UserInfoComponent组件的内容，4个文本框及2个按钮，4个文本框的数据来源于外部调用者的设置，“确定”及“取消”按钮触发事件通知调用者

当我们创建完视图时，工具会自动帮助我们生成代码

UserInfoController.g.cs中的代码：

 //
 // 此代码由工具生成
 // 对此文件的修改，将会在下次生成时丢失
 //

 using FineUIMvc;
 using System.Collections.Generic;

 namespace FineUIMvc.EmptyProject.Controllers
 {
     public partial class UserInfoController
     {
         private Dictionary<string, IControlBaseAjaxHelper<ControlBase>> _FINE_UI_MVC_CONTROLS_ = new Dictionary<string, IControlBaseAjaxHelper<ControlBase>>();

         private TextBoxAjaxHelper txtName
         {
             get
             {
                 var controlId = "txtName";

                 if (!this._FINE_UI_MVC_CONTROLS_.ContainsKey(controlId))
                 {
                     this._FINE_UI_MVC_CONTROLS_[controlId] = UIHelper.TextBox(controlId);
                 }

                 return (TextBoxAjaxHelper)this._FINE_UI_MVC_CONTROLS_[controlId];
             }
         }

         private TextBoxAjaxHelper txtEmail
         {
             get
             {
                 var controlId = "txtEmail";

                 if (!this._FINE_UI_MVC_CONTROLS_.ContainsKey(controlId))
                 {
                     this._FINE_UI_MVC_CONTROLS_[controlId] = UIHelper.TextBox(controlId);
                 }

                 return (TextBoxAjaxHelper)this._FINE_UI_MVC_CONTROLS_[controlId];
             }
         }

         private TextBoxAjaxHelper txtTelphone
         {
             get
             {
                 var controlId = "txtTelphone";

                 if (!this._FINE_UI_MVC_CONTROLS_.ContainsKey(controlId))
                 {
                     this._FINE_UI_MVC_CONTROLS_[controlId] = UIHelper.TextBox(controlId);
                 }

                 return (TextBoxAjaxHelper)this._FINE_UI_MVC_CONTROLS_[controlId];
             }
         }

         private TextBoxAjaxHelper txtAddress
         {
             get
             {
                 var controlId = "txtAddress";

                 if (!this._FINE_UI_MVC_CONTROLS_.ContainsKey(controlId))
                 {
                     this._FINE_UI_MVC_CONTROLS_[controlId] = UIHelper.TextBox(controlId);
                 }

                 return (TextBoxAjaxHelper)this._FINE_UI_MVC_CONTROLS_[controlId];
             }
         }

         private ButtonAjaxHelper btnOK
         {
             get
             {
                 var controlId = "btnOK";

                 if (!this._FINE_UI_MVC_CONTROLS_.ContainsKey(controlId))
                 {
                     this._FINE_UI_MVC_CONTROLS_[controlId] = UIHelper.Button(controlId);
                 }

                 return (ButtonAjaxHelper)this._FINE_UI_MVC_CONTROLS_[controlId];
             }
         }

         private ButtonAjaxHelper btnCancel
         {
             get
             {
                 var controlId = "btnCancel";

                 if (!this._FINE_UI_MVC_CONTROLS_.ContainsKey(controlId))
                 {
                     this._FINE_UI_MVC_CONTROLS_[controlId] = UIHelper.Button(controlId);
                 }

                 return (ButtonAjaxHelper)this._FINE_UI_MVC_CONTROLS_[controlId];
             }
         }
     }
 }

UserInfoComponent.g.ts中的代码：

 //
 // 此代码由工具生成
 // 对此文件的修改，将会在下次生成时丢失
 //

 /*
  * UI
  */
 export module UI {
     export let txtName = F<F.TextBox>('txtName');
     export let txtEmail = F<F.TextBox>('txtEmail');
     export let txtTelphone = F<F.TextBox>('txtTelphone');
     export let txtAddress = F<F.TextBox>('txtAddress');
     export let btnOK = F<F.Button>('btnOK');
     export let btnCancel = F<F.Button>('btnCancel');
 }

 /*
  * Action
  */
 export module Action {
     export function getActionUrl(actionName: string) {
         return `${F.baseUrl}UserInfo/${actionName}`;
     }

     export function index(model?: Model.IndexModel, owner?: Window | GetIFrameWindow) {
         let url = `${getActionUrl('Index')}${model != null ? '?' + QueryString.stringify(model) : ''}`;
         let wnd : any = owner || window;
         wnd = (wnd != null && wnd.getIFrameWindow && wnd.getIFrameWindow()) || wnd;
         wnd.open(url, '_self');
     }
 }

 /*
  * Model
  */
 export module Model {

     export class IndexModel {

         constructor() {
         }
     }

 }

外部调用者设置组件的信息，我们需要在UserInfoComponent.ts中去实现（23行到53行为自己添加的代码，其它的为创建时自动生成的代码），代码：

 import { Component } from '../../Scripts/Component';
 import { UI, Action, Model } from './UserInfoComponent.g';

 export class UserInfoComponent extends Component {
     public static readonly TYPE = 'FINEUIMVC_EMPTYPROJECT_VIEWS_USERINFOCOMPONENT';

     constructor() {
         super(UserInfoComponent.TYPE);
         this.init();
     }

     public static validType(component: Component) {
         return component.isType(UserInfoComponent.TYPE);
     }

     public static open(model?: Model.IndexModel, owner?: Window | GetIFrameWindow) {
         Action.index(model, owner);
     }

     private init() {
     }

     public set userName(name: string) {
         UI.txtName.setText(name, false);
     }

     public get userName() {
         return UI.txtName.getText();
     }

     public set email(email: string) {
         UI.txtEmail.setText(email, false);
     }

     public get email() {
         return UI.txtEmail.getText();
     }

     public set telphone(telphone: string) {
         UI.txtTelphone.setText(telphone, false);
     }

     public get telphone() {
         return UI.txtTelphone.getText();
     }

     public set address(address: string) {
         UI.txtAddress.setText(address, false);
     }

     public get address() {
         return UI.txtAddress.getText();
     }
 }

外部调用者监听组件事件，我们还是需要在UserInfoComponent.ts中去实现（20行到36行为自己添加的代码），代码：

 import { Component } from '../../Scripts/Component';
 import { UI, Action, Model } from './UserInfoComponent.g';

 export class UserInfoComponent extends Component {
     public static readonly TYPE = 'FINEUIMVC_EMPTYPROJECT_VIEWS_USERINFOCOMPONENT';

     constructor() {
         super(UserInfoComponent.TYPE);
         this.init();
     }

     public static validType(component: Component) {
         return component.isType(UserInfoComponent.TYPE);
     }

     public static open(model?: Model.IndexModel, owner?: Window | GetIFrameWindow) {
         Action.index(model, owner);
     }

     private init() {
         UI.btnOK.onClick(() => {
             $(document).trigger('onOKClick');
         });

         UI.btnCancel.onClick(() => {
             $(document).trigger('onCancelClick');
         });
     }

     public onOKClick(handler: (e, m) => any) {
         $(document).on('onOKClick', handler);
     }

     public onCancelClick(handler: (e, m) => any) {
         $(document).on('onCancelClick', handler);
     }

     public set userName(name: string) {
         UI.txtName.setText(name, false);
     }

     public get userName() {
         return UI.txtName.getText();
     }

     public set email(email: string) {
         UI.txtEmail.setText(email, false);
     }

     public get email() {
         return UI.txtEmail.getText();
     }

     public set telphone(telphone: string) {
         UI.txtTelphone.setText(telphone, false);
     }

     public get telphone() {
         return UI.txtTelphone.getText();
     }

     public set address(address: string) {
         UI.txtAddress.setText(address, false);
     }

     public get address() {
         return UI.txtAddress.getText();
     }
 }

调用者本身也是一个组件，组件中含有一个Window控件，用于加载UserInfoComponent组件（22行到45行为调用UserInfoComponent，第3行为导入UserInfoComponent），代码：

 import { Component } from '../../Scripts/Component';
 import { UI, Action, Model } from './DefaultComponent.g';
 import { UserInfoComponent } from '../UserInfo/UserInfoComponent';

 export class DefaultComponent extends Component {
     public static readonly TYPE = 'FINEUIMVC_EMPTYPROJECT_VIEWS_DEFAULTCOMPONENT';

     constructor() {
         super(DefaultComponent.TYPE);
         this.init();
     }

     public static validType(component: Component) {
         return component.isType(DefaultComponent.TYPE);
     }

     public static open(model?: Model.IndexModel, owner?: Window | GetIFrameWindow) {
         Action.index(model, owner);
     }

     private init() {
         UserInfoComponent.open(null, UI.window1);
         UI.window1.onReady(() => {
             let userInfoComponent = UI.window1.getComponent<UserInfoComponent>();
             if (userInfoComponent && UserInfoComponent.validType(userInfoComponent)) {
                 userInfoComponent.userName = '张三';
                 userInfoComponent.email = 'test@test.com';
                 userInfoComponent.telphone = ';
                 userInfoComponent.address = 'xxxxxxxxxxx';

                 userInfoComponent.onOKClick(() => {
                     F.notify({
                         message: `姓名：${userInfoComponent.userName};邮箱：${userInfoComponent.email}`,
                         messageIcon: F.MessageBoxIcon.$Success
                     });
                 });

                 userInfoComponent.onCancelClick(() => {
                     F.notify({
                         message: '单击了取消按钮',
                         messageIcon: F.MessageBoxIcon.$Warning
                     });
                 });
             }
         });
     }
 }

运行后的效果（修改完姓名及邮箱后，单击“确定”按钮），如图：

以上就是组件开发的过程，基于组件方式的开发，可以最大程度的提高页面重复利用次数，降低页面与页面之间的耦合。

在后续的文章中，我会介绍组件开发的每一个细节，FineUIMvcTools工具还在完善中，我想等到这个系列文章写完后，再提供给大家。

示例代码：

链接: http://pan.baidu.com/s/1o7AgH2y 密码: 6b33