当前位置: 首页 > 工具软件 > Swiz > 使用案例 >

[Flex] swiz 点滴

孙帅
2023-12-01

* 一个完整的swiz 例子

http://www.cnblogs.com/shanlanjie/archive/2012/06/07/2540006.html


* Main issues

> flex access point is a mxml file under src root folder. 这个mxml会add view指向你的(swiz) view package里的其中一个view mxml作为main view. 而swiz config 代码可以写到这个main view xml里,也可以写到access point的app mxml file里。


> view里只应该有pm,不应该有model, controller & service/delegate. view or pm是通过dispatch event来通知controller的。而controller里dispatch的event通常由pm or view接收。


> pm的讲解见后面的部分。view只会和pm进行交互,我们也应该尽量把view的logic写到pm里,实在不行才写到view里。pm应该有一些data变量,它们要么绑定到model里。要么就是也把model定义为变量,然后定义event handler,这样就使得event发生后,就会把model里的data复制给pm里的data变量。


> model, 你可以设置model里的var是bindable的,也可以在var的setter里dispatch event来通知var value change。


> event, 自定义event,通过dispatch这些event来通知trigger。event通常会带一些变量(声明为public)用来存储。例如,一个search功能,我们创建一个search event class,该class有一个变量为"keyword",那么在pm里会创建一个search event实例,并从view ui里获取keyword值复制给event实例的变量,然后dispatch该event。controller里定义了该event的handler method,会从该event中获取keyword来调用delegate/service。event里的变量起到了传递值的作用。


> service/delegate 不应该有任何data变量 (e.g. model, pm), 会inject httpservice,它只是call httpservice的send method, 至于返回的result应该在controller里处理


> controller 通常会inject service/delegate, 也会inject model. controller里dispatch的event通常由pm or view接收


> 有些人喜欢在controller里调用delegate/service,然后赋值该model,在model的setter里dispatch event,有些人则喜欢在controller里调用了delegate之后直接在controller里dispatch event。不过还是要看情况,当然最应该是写在setter里,这样比较符合逻辑。比如call search service之后,会在controller里调用model的setter来赋值,这时setter method应该dispatch 一个 "..._MODEL_INFO_CHANGE"之类的event来通知event handler。而如果你不是在setter里,而是在controller里dispatch event,那么有可能其他controller也会修改该model,那么就要在所有修改model的地方都dispatch相同的event,就duplicate code了。当然也有些情况我觉得在controller里dispatch event比较好,比如login。




* Presentation Model.

classes in pm package are presentation model. 官方文档解释:pm的作用是为了remove any logic from the view and let the PM handle the view logic。由于view里没有logic,所以you only have to unit test your PM

而且pm还是是model class (in model package) 和 view之间的桥梁,象java 的dto,使得view只和present model交互,而不会直接和model交互。因此在view.mxml里只会看到presentation model的变量。在presentation model里基本上都会有一个model的变量或者把model的某些var inject到pm的var上如果不是把model的某些var inject到pm的var上,则可以添加一些event handler method,当trigger这些handler时,就会把model变量里的data传递给presentation model的变量(因为trigger时model已经被赋值了data)

Note: it is recommended  to declare pm  as a Prototype so the PM will only be created (instantiated) when the corresponding view is added to the stage. 例如

      <swiz:Prototype type="{MyPresentationModel}" />

我觉得swiz:Prototype还表示该bean不是singleton的。即每次把该pm bean inject时,都会create a new instance。如果你希望bean为singleton,而且又只是在view添加到stage之后才创建instance,那么可以使用

      <swiz:Prototype type="{MyPresentationModel}" singleton="true"/>

有可能是因为pm既inject to view,又inject to controller,那么需要设置singleton=true


ref link

http://swizframework.jira.com/wiki/display/SWIZ/Presentation+Model


* vo和model的关系

vo package里定义的class相当于java的pojo,和model不同的是它不会有dispatcher变量vo和model的关系的一个典型的例子是:model里有一个变量是array list,而array list的每一个item就是一个vo


Swiz guide 

official guide

http://swizframework.jira.com/wiki/display/SWIZ/Home

Recommend download swiz examples from https://github.com/swiz/swiz-examples, it include the Quick-start swiz example.


Swiz quick start example guide: http://swizframework.jira.com/wiki/display/SWIZ/Quick+Start


* swiz framework, it can
* Inversion of Control / Dependency Injection
* Event handling
* A simple life cycle for asynchronous remote method invocations
* A framework that is decoupled from your application code Compatibility with both Flex and non-Flex AS3 projects


很像java的spring framework.


* Q: How to add swiz to your flex project?
A: just copy swiz swc file to "libs" folder of project



* 添加<swiz:Swiz>...</swiz:Swiz>。 其中
<swiz:beanProviders>
<config:Beans />
</swiz:beanProviders>


<swiz:beanProvider>是用来设置哪个文件用来定义那些Non-visual component的bean。类似于spring设置bean xml file, all defined bean are processed by Swiz for dependency injection and the creation of event handlers。上面的代码设置了<config:Beans/>。假设xmln:config设置的是"demo.config.*",那么<config:Beans/>表示的是demo.config.Beans.mxml。
注意:该mxml file必须存在,否则会报错


然后再来看demo.config.Beans.mxml:
<swiz:BeanProvider 
xmlns:fx="http://ns.adobe.com/mxml/2009"
xmlns:swiz="http://swiz.swizframework.org"
xmlns:service="demo.service.*" 
xmlns:controller="org.swizframework.quickswiz.controller.*">

<service:UserService id="userService"/>
<controller:UserController id="userController"/>
</swiz:BeanProvider>


看到设置了xmlns:service指向"demo.service.*" ,xmlns:controller指向"demo.controller.*"
因此
<service:UserService id="userService"/>
表示把demo.service.UserService.as定义做id为userService的bean


<controller:UserController id="userController"/>
表示把demo.controller.UserController.as定义做id为userController的bean

之后进行DI时,就会通过这些id来注入


* 待续

 类似资料: