技术经验分享:Asea——轻量级的AS3模块配置与加载管理库

简介: 技术经验分享:Asea——轻量级的AS3模块配置与加载管理库

代码已经托管到github:


该库的设计最初是为了方便配置RSL,后来发现功能逐渐与Spring接近,所以干脆对功能重新规划了一次取名为Asea,在AS3上实现了基本的IOC功能。


以下内容让您学会如何使用Asea。


一. Hello World


1 package


2 {


3 import com.alibado.asea.;


4


5 import flash.display.Sprite;


6


7 public class AseaTest extends Sprite


8 {


9 public function AseaTest()


10 {


11 //定义配置xml


12 var xml:XML = new XML();


13


14 //获取根节点处理器


15 var asea:EaDrop = EaConfig.getDrop("asea");


16


17 //定义上下文对象


18 var context:Object = {};


19


20 //执行


21 asea.process(xml, 【context】);


22 }


23 }


24


25 }


除非您打算扩展它,否则使用Asea的仅需要四步。


配置xml中定义了您要执行的命令,命令的具体语法将在下面介绍。


上下文对象是xml命令执行的数据环境,换句话说,您可以在xml命令中从上下文对象中获取数据和写入数据,您可以尝试把上下文对象另外保存起来,这样您就可以通过它获取到处理后的结果了。这里提醒一点,如果您的上下文对象并非动态对象,那么当您尝试在xml上写入上下文环境中不存在的属性时,系统将报错(ReferenceError),当然一般来说您没有必要这么做。


根节点处理器就是一个大烤箱,您把执行命令和上下文数据交给它,它帮您处理。根节点处理器从EaConfig中获取,一般来说获取名字是“asea”的根节点处理器是不会错的,除非您非常确切得知道您的根节点是什么标签。另外方法process的第三个参数是成功后的回调,其定义应该是function(result: = null):void,result处理后的结果,如果您的根节点是“asea”,那么result肯定是null,该回调存在的意义在于,考虑您的xml可能是异步处理的,比如在xml中加载个数据什么的。。process的第四个参数是出错后的回调,定义是function(errorCode:int, message:String, target:String, xml:XML):void。


对了,您可能还注意到process的第二个参数并非直接是context对象,而是一个只有context一个元素的数组。这个问题涉及到作用域链,作用域链的作用将在后面讲到。我知道这样看起来不太友好,希望哪个好人能帮它再封装一层吧。


二. 标签处理器


Asea目前提供的标签有:asea,class,get,if,lib,method,new,selector,trace,with,bean。


您可以在EaConfig这个类的drops属性中找到这些定义,drops是个包含所有标签处理器的数组,如果您定义了自己的标签处理器,可以push到这个数组中即可生效。


所有的标签处理器都继承EaDrop这个类,您只需覆盖onProcess方法和get name方法即可定义自己的标签处理器。另外提醒一点,标签处理器是无状态的,全局唯一实例,所以如果您的变量不是定义在方法体内,就要小心处理了。


这里贴出了最简单的标签处理器


1 package com.alibado.asea.drops


2 {


3 import com.alibado.asea.EaDrop;


4


5 public class EaGet extends EaDrop


6 {


7


8 override public function get name():String


9 {


10 return "get";


11 }


12


13


14 /


15 example:


16


17 /


18 override protected function onProcess(dom:XML, value:, contexts:Array, onComplete:Function, onError:Function = null):void


19 {


20 onComplete(value);


21 }


22 }


23


24 }


在EaGet中覆盖了public function get name():String,需要在该方法中返回该标签处理器的要处理的标签名。


另外还要覆盖protected function onProcess(dom:XML, value:*, contexts:Array, onComplete:Function, onError:Function = null):void,该方法的第一个参数是处理的xml,系统会保证该xml的根节点名就是get name中指定的名字;第二个参数value是在标签中的value属性在上下文环境中查询到的数据,如果您不想知道查询的结果想自己处理value属性,那么您就去访问xml.@value吧;contexts是上下文环境;onComplete是处理成功后的回调,如果您的标签处理器会产生结果,那么就往onComplete里面传递结果吧,如果您的处理不产生结果,那也要调用一次onComplete,因为整个处理链是依赖onComplete进行的,如果您的标签有id属性且您传递了结果,那么系统会自动把您的结果保存在id属性指定的地方,onError是处理出错后的回调,定义已经在上文中提到过了。除非是特别严重的错误,否则我们不建议因为出错而不调用onComplete。因为如果您不调用onComplete,系统会认为您的标签尚未处理完成,整个处理过程将无法继续。


三. 上下文环境的操作


上下文环境是个数组,其中下标为0的对象为“当前上下文”,数组末尾的对象为“根上下文”,一般来说“根上下文”是我们人为提供的,就像Hello World程序里定义的那个上下文对象。其他上下文对象则是在运行xml时产生的,至于为什么产生,什么时候会产生,这些问题在下文中介绍具体介绍标签时讲解。


有了上下文环境,我们就需要在上下文环境总读取和写入数据,通过标签的value属性可从上下文环境中读取数据。


读取的量可分常量与变量,常量分为string,number,boolean三种类型,例如"string/hello world"是字符串常量,"number/110"是数字常量,"boolean/true"是布尔型常量,其余写法都算作变量。


@root是一个关键字,代表根上下文,我们可以以@root.attr的方式访问根上下文的属性,也可以@root.attr.attr2的方式进一步访问。@this也是一个关键字,代表当前上下文环境。如果不使用关键字,比如myBall.x这样的方式,则系统首先搜索当前上下文环境是否有myBall属性,若是没有,则再向上一级搜索,直到搜索到根上下文环境,这一点类似与JS的属性访问规则。


通过id属性可保存标签执行的结果,若是id为myBall.x,那么首先系统将在上下文环境中由内向外搜索myBall属性,找到myBall对象后往其内设置x属性。若是myBall属性不存在,则将会在其当前上下文对象中建立myBall属性,并且设置x属性。同样的myBall.positon.x的话,若是myBall不存在,则建立之,而后建立positon,最后设置x。id的设置同样支持@root和@this,若是id直接等于@this或者@root,那么你就能直接把上下文对象给覆盖了。。这相当危险但是有用。


四. 标签详解


asea:所有标签中最重要的一个,该标签什么属性也不支持,但是它却是其他标签正常运行的容器,它一般作为根节点或者被其他标签处理器作为父类;


bean:


/


example:














/


定义一个对象的定义(并不直接执行内部代码),内部第一个标签必须是new标签,new标签执行前当前上下文对象是个空对象,new标签之后当前上下文对象变成new出来的对象。而后的代码可对new出来的对象设置属性等操作。。。bean标签的执行结果是一个对象定义,当每次被访问时,都会执行一次对应的bean标签内部的代码并得到构造出来的内容。


class:


/


example:


/


定义一个类的别名,value属性是类的完整命名,id是类的别名。实际上该别名就是上下文环境中的一个Class对象。


get:


/


example:



/


获取属性或者转存属性,get标签的执行结果就是value属性中指定的属性。


if:


/**


example:







/


逻辑判断功能的标签,若是value内的值是布尔型true,则执行内部内容,否则不执行任何操作。


lib:


/


example:


//代码效果参考:http://www.jhylw.com.cn/312820287.html

/

该标签是动态加载swf库到当前applicationDomain。


method:


/


example:







/


该标签是执行一个方法,其value值对应的对象必须是个Function,否则结果你懂的。。标签的输出是函数执行结果。标签的子标签是参数。实际上参数可以是任何标签,只要能产生输出均可,内部标签的当前上下文对象是个数组,该数组将最终成为Function执行的参数。


new:


/**


example:






//代码效果参考:http://www.jhylw.com.cn/225821237.html



/


该标签的功能是实例化一个对象,value的值可以是上下文中的Class对象,也可以是类的全名(先搜索上下文内容)。new标签输出结果是实例化的结果。new标签内部的标签是构造函数参数,其实现原理与method标签一样,另外,构造函数参数个数不能超过十个。。。


selector:


/**


example:













子节点规则:onComplete参数第一个为true则跳出,否则继续。


/


该标签类似于switch,当其内部标签的执行结果是true的时候,才停止执行,否则将一直执行下去。


trace:


/**


example:


/


该标签直接在控制台输出value的内容,用于调试。


with:


/**


example:







/


该标签为其内部的标签创造一个当前上下文对象,内部标签的当前上下文对象变成由value指定的对象。


include:


/*


example:



/


该标签可导入一个外部的xml或者上下文中存在的一个xml对象,系统首先搜索value中给定的值是否在上下文中有对应的xml对象,若是有则处理之,若是没有则搜索是否存在对应的String对象,若是有则将其视为外部xml的URL并加载之,若是没有则将value内容视为外部XML的URL并加载之。载入的XML与外部享有相同的上下文环境。

相关文章
|
3天前
|
NoSQL Java Redis
若依如何使用(基本环境的配置)
若依如何使用(基本环境的配置)
|
2月前
|
编译器 API PHP
深入PHP扩展开发:打造高效自定义模块
【4月更文挑战第30天】 在追求性能优化和特定功能实现的道路上,PHP提供了一种强大机制——扩展。本文将引导读者通过编写一个简单的PHP扩展来探索扩展开发的世界。我们将涉及从环境搭建到代码实现,再到扩展的编译与加载的完整流程,确保读者能够理解并实践如何创建高效的自定义PHP模块。
|
9月前
|
数据采集 小程序 定位技术
[笔记]微信小程序开发《三》框架基础:小程序生命周期、全局配置、页面配置。
[笔记]微信小程序开发《三》框架基础:小程序生命周期、全局配置、页面配置。
|
9月前
|
开发框架 小程序 前端开发
阿里云小程序框架
阿里云小程序框架
|
缓存 JSON 前端开发
腾讯开源的 hel 提供了加载远程模块的能力,谈谈它的实现原理
腾讯开源的 hel 提供了加载远程模块的能力,谈谈它的实现原理
159 0
|
前端开发
封装库/工具库中重要概念之组件库
前端开发中,封装库和工具库是非常重要的组成部分。它们可以帮助我们提高代码复用性和可维护性,从而缩短开发周期和降低维护成本。在封装库和工具库中,组件库是其中最为重要和常用的一种,因为它们可以帮助我们快速构建复杂的 UI 界面。
227 0
|
机器学习/深度学习 C语言 C++
Python开发基础总结(五)模块+日志+自省
Python开发基础总结(五)模块+日志+自省
|
前端开发
搭建自己的前端组件库-集成tailwindcss
搭建自己的前端组件库-集成tailwindcss
381 0
|
Web App开发 小程序 开发工具
小程序云开发CLI工具辅助开发
介绍小程序云CLI的使用技巧,提效小程序云开发。
1991 0
|
Kubernetes 网络协议 API
纯手工搭建k8s集群-(二)核心模块部署
1. 部署ETCD(主节点) 1.1 简介 kubernetes需要存储很多东西,像它本身的节点信息,组件信息,还有通过kubernetes运行的pod,deployment,service等等。都需要持久化。
2486 0