本篇介绍0.1版中最后一个特性,FlowController;同时也对第一版总结一下,因为近两年全部都是在搞前端,都是做一些js框架类的东西,也做了不少有意思的功能,做smartjs对我来说一个是对自己做一个总结,也希望分享一些东西给大家借鉴。
而对smartjs的来说,整体思想都并不是为了实现什么功能、特效和内容。而是希望体现一些前端编程模式或者思想上的内容,这次的0.1版本中,主要体现了一些面向切面编程、非侵入式编程、异步编程,生命周期控制的一些思想。包括后续的oop的内容,基于策略的数据管理,模型驱动,类型驱动等等都是想给前端开发中注入一些特别点的内容。
FlowController
流程或者生命周期管理器。控制流程的走向,流程扩展,注入控制等等;FlowController是基于trigger封装,具有所有trigger的特性;
接口方法
var flow = {
node1 : function(e,arg,...){}
};//流程控制初始化
flowController({
flow : flow,
order : ["node1"],
mode : "",
trigger : true | {mode : "",iFace : {}}
})//启动流程
flow.boot(arg,...);//根据指定的流程节点启动
flow.bootWithStart("start",[args])
参数讲解
- flow :流程定义
- order : 流程执行顺序
- mode
:流程模式,默认为promiseEvent模式;simple:简单模式 - trigger : trigger的设置,详细见上篇trigger api说明
在流程中的e参数,与trigger一样,只是多出了几个流程控制方法方法
e.end() : 停止流程方法
e.next(nextNode, pass, args) :
指定下个节点方法;
- nextNode:下个节点名称,可以不在流程定义order设置中
- pass:
可选,略过的流程节点数,只在nextNode指向的非定义的流程节点有效 - args:可选,指定nextNode的方法参数
e.changeArgs([]):
改变后续流程的方法参数
e.recoverArgs():
回复原始方法参数,与changeArgs对应;
另外,需要注意的是
e.stop()
: 与trigger的效果一样,停止方法的执行,这里是停止当前节点的后续执行,但不影响 流程的后续执行
使用样例
简单模式
var flow = st.flowController({
flow: {
init: function(name, op) {
log(name, ‘init‘);
},
render: function(name, op) {
log(‘render‘);
},
complete: function(name, op) {
log(‘complete‘);
}
},
order: ["init", "render", "complete"],
mode: "simple"
})flow.boot("boot");
expect(arr + ‘‘).toBe(‘boot,init,render,complete‘);
普通模式
以一个见的控件渲染为例子,正常的有init,render,complete三个节点,还有两个非标准流程节点buildInput和cancel。在init节点中根据name不同还有做流程走向控制
//一个简单的控件渲染流程
var promiseFlow = st.flowController({
flow: {
init: function(e, name, op) {
setTimeout(function() {
log(name, ‘init‘);
//根据name判断下个流程
if (name === ‘input‘)
//改变下个流程的参数
e.next("buildInput", [op.type]);
else if (name === ‘cancel‘)
e.next(‘cancel‘)e.resolve();
}, 100)
return e.promise();
},
//非标准流程中的节点
buildInput: function(e, type) {
setTimeout(function() {
log(‘buildInput‘);
e.resolve(type);
}, 100)
return e.promise();
},
//非标准流程中的节点
cancel: function(e) {
setTimeout(function() {
log(‘cancel‘);
//流程结束
e.end().resolve();
}, 100)
return e.promise();},
render: function(e, name, op) {
//值传递测试
e.result && log(e.result);
log(‘render‘);
},
complete: function(e, name, op) {
log(‘complete‘);
}
},
order: ["init", "render", "complete"]
});//div控件走正常流程
$.when(promiseFlow.boot("div")).done(function() {
expect(arr + ‘‘).toBe(‘div,init,render,complete‘);
})//input进入非标准流程
$.when(promiseFlow.boot("input", {
type: ‘text‘
})).done(function() {
expect(arr + ‘‘).toBe(‘input,init,buildInput,text,render,complete‘);
});//end测试
$.when(promiseFlow.boot("end")).done(function() {
expect(arr + ‘‘).toBe(‘end,init,cancel‘);
})
trigger注入方法例子
var triggerFlow = st.flowController({
flow: {
init: function(e, name, op) {
setTimeout(function() {
log(name, ‘init‘);
e.resolve();
}, 100)
return e.promise();
},
render: function(e, name, op) {
log(‘render‘);
},
complete: function(e, name, op) {
log(‘complete‘);
}
},
order: ["init", "render", "complete"],
trigger: true
});it("trigger", function(testCall) {
//init节点注入前置方法
triggerFlow.onBefore("init", "initBefore", function(e, name, op) {
log(‘initBefore‘);
}, "once");//init节点注入后置方法
triggerFlow.on("init", "initAfter", function(e, name, op) {
setTimeout(function() {
log(‘initAfter‘);
e.resolve();
}, 100)
return e.promise();
}, "once");$.when(triggerFlow.boot("div")).done(function() {
expect(arr + ‘‘).toBe(‘initBefore,div,init,initAfter,render,complete‘);
testCall();
})
})it("trigger - next", function(testCall) {
//init中注入方法,跳入后续节点
triggerFlow.onBefore("init", "initBefore", function(e, name, op) {
setTimeout(function() {
log(‘initBefore‘);
e.next(‘complete‘).resolve();
}, 100)
return e.promise();
}, "once");$.when(triggerFlow.boot("div")).done(function() {
expect(arr + ‘‘).toBe(‘initBefore,div,init,complete‘);
testCall();
})})
//注入方法结束节点
it("trigger - end", function(testCall) {
triggerFlow.onBefore("init", "initBefore", function(e, name, op) {
setTimeout(function() {
log(‘initBefore‘);
e.end().resolve();
}, 100)
return e.promise();
}, "once");$.when(triggerFlow.boot("div")).done(function() {
expect(arr + ‘‘).toBe(‘initBefore‘);
testCall();
})
})
还有很多的流程控制的例子就不一一介绍了,请参考smartjs上的测试用例
smartJS 0.1 API 讲解 - FlowController