Flex SDK 4(Gumbo)浅析ASDoc ASDoc Tags参数
《Flex SDK 4(Gumbo)浅析ASDoc - Flash Builder 4配置篇》介绍了如何在Flash Builder 4里面配置、运行ASDoc。
本篇文章介绍一些比较常用的ASDoc Tags，只有搞清楚了如何使用ASDoc Tags才能让我们生成一些我们想要的ASDoc文档。
我在这里只列举了一些比较常用的ASDoc Tags：
@param paramName description
为函数的参数添加注释，如果有多个参数，则写入多个@param即可。
例如：@param scaleX 传入x轴方向的放大率
@private
输出时会被排除的元素。（即ASDoc不会解析和显示包含@private的内容）
@return description
为函数的返回值添加描述信息。
例如：@return 累加的值
@see reference [displayText]
用@see标签可以增加插入‘参见更多’的一个链接。
详细请看：http://livedocs.adobe.com/flex/gumbo/html/WSd0ded3821e0d52fe1e63e3d11c2f44bc36-7ff8.html
注意：@see标签中不能包含HTML格式化字符。
例如：@see com.rianote.flex.kui.component.LinkLabel
@default value
某个变量的默认值
例如：
@default false
@default 0xffffff
@example exampleText
在指定位置的头部添加可自定义样式属性的代码实例
代码需要写在<listing version="3.0"></listing>标签内
不规范样式时，实例代码会被先是在一个灰色可滚动的边框中
例如：
@example The following code sets the volume level for your sound:
<listing version="3.0">
var mySound:Sound = new Sound(); mySound.setVolume(VOL_HIGH);
</listing>
@throws package.class.className description
对抛出的异常进行解释
例如：@throws SecurityError Local untrusted SWFs may not communicate with the Internet.
@eventType description
对某一个Event类型进行描述
例如：@eventType mx.events.FlexEvent.BUTTON_DOWN
关于ASDoc Tags的官方文档：
Flex SDK 4(Gumbo)官方ASDoc教程：
http://livedocs.adobe.com/flex/gumbo/html/WSd0ded3821e0d52fe1e63e3d11c2f44bc36-7ff6.html
相关文档：
1.监听事件时用弱引用方式（特别是对Applicatiion.applicaion和Stage的事件监听），方式如下：第五个参数值为true
Application.application.addEventListener(MouseEvent.CLICK,doClick,false,0,true);
2.集合类如Array和Dictionary里的元素，在不用的时候要设置为null;(尤其是主页面上的集合类)，如：myMap[o]=null;
3. ......
Adobe Flex开发与传统的Web开发有很多不同之处。正确的理解和利用这些不同之处，可以帮助我们创建更丰富的用户体验，也可以反过来增加网站的可用性以及浏览和更新速度。Flex还提供了大量的组件和技术库来让Web开发更加轻松——它提供的强大工具要远远超过传统Web 2.0中的异步JavaScript和XML（Ajax）应用。此外， ......
今天遇到的一个问题，读取网站上的一个XML文件被拒绝，错误描述如下：
*** 安全沙箱冲突 ***
到127.0.0.1:8080的连接已停止 - 不允许从d:/flex/work/bin_debug/work.swf进行连接
错误：拒绝请求位于 http://127.0.0.1:8080/php/work.xml 的资源（请求者从d:/flex/work/bin_debug/work.swf发出请求），原因是缺乏策� ......
随着 Adobe Flex 技术的成熟，越来越多的企业开始采用 Adobe Flex 技术开发 RIA (Rich Internet Application)。在常见的 RIA 应用程序架构中，客户端用 Adobe Flex 渲染出漂亮的界面，而渲染界面所需要的数据则从服务器端的应用程序获取。在 Java EE 领域，服务器端的应用程序通常是� ......
其实对于这个题目是不恰当的，因为flex中是没有页面这个概念的，页面在flex里面其实就是一个个的Canvas，vbox，
hbox等等之类的东西，看到的不同页面的切换，就是这些元素一层层的堆积，或者替换，但是为了好理解，还是称之为
"页面跳转"。其实我们可以对比传统的C/S开发模式，没页面跳转，只有窗体和元件的显示和隐藏� ......
