第二节   悬停时的ASDOC提示
      在多人协同开发时,如果我们往自己的代码中引用了别人开发的类包和方法,就会时不时切换到那些类的源码,去看同事们为类添加的注释或者 ASDoc以确定如何去使用这个方法,这样做十分不便。在这次Flash Builder 4的版本升级中,Adobe为我们新增了一项不错的功能——ASDoc 悬停提示,这项 新功能的主要作用就是使我们在编码过程中只用用鼠标悬停在你想要查看 ASDoc 的类,方法上,IDE 工具就会自动在一个视图中呈现这些 ASDoc 提示, 十分方便。
     

学习目标

了解 Flash Builder 4 的新特性——编码时的ASDoc悬停提示。

 

      1、首先要打开 ASDoc 提示窗口,步骤如下: 工具栏->窗口->其他视图。 (图二十四)

图二十四

打开ASDoc提示窗口

在弹出的窗口中的树形结构中选择 Flash Builder->ASDoc,点击“确定”。 (图二十五)

图二十五

选择ASDos

然后,ASDoc 视图便会出现在 IDE 编辑器中。 (图二十六)

图二十六

ASDos编辑器

2、我们首先写一个 Service 类,并添加 ASDoc 注释。ASDoc 的具体写法在下一章中会有详细介绍。

package cn.airia.fb4.asdoc

{

    public class UserService

    {

        public function UserService()

        {

        }

        /**

        * 根据用户id返回用户名

        * @param id 用户的id

        * @return 用户名

        *

        */                

        public function getUsernameById(id:String):String

        {

            return "momoko";

        }

    }

}

3、然后我们在主程序中调用这个 getUsernameById 方法,当我们需要查看这个方法的 ASDoc 注释时,只需将鼠标悬停在方法名上,ASDoc 窗口便会自动显示它的注释。(详见下图)