Flex 元数据及用法

     Flex引入了元数据标签的概念，它告诉编译器如何编译这段Flex 或actionscript代码。大多数人都使用过[Bindable]标签，元数据标签是一种 特殊的标签，它在代码中的作用就是向编译器提供如何编译程序的信息。实际上，这些标签并没有被编译到生成的SWF文件中，而只是 告诉编译器如何生成SWF 文件。 这篇Post结合网上相关的 资料 以及Adobe的 help resource center的相关材料 介绍了16个元数据标签。

 

[ArrayElementType]

实际上，定义一个数组通常来说是一件很平常的事情，因为数组中的元素可以是任何类型的。不过，使用ArrayElementType元数据标签可以让你定义数组元素的数据类型。下面的例子展示了如何使用[ArrayElementType]：

    [ArrayElementType(”String”)]
    public var arrayOfStrings:Array;

    [ArrayElementType(”Number”)]
    public var arrayOfNumbers:Array;

    [ArrayElementType(”mx.core.UIComponent”)]
    public var arrayOfUIComponents:Array;

 

[Bindable]

Bindable元数据标签是最经常用到的一个元数据标签，因为它使程序组件之间的数据同步变得很容易。Bindable可以用来绑定简单数据类 型、类、复杂数据类型以及函数。绑定数据的时候，你必须先使用元数据标签定义一下数据。Bindable也可以用来绑定到事件。

 

啥是绑定

[
Bindable]

public
 var
 name
:String
 = ""
;

作为一个public变量，肯定既可以被赋值，也能赋值给别的变量。绑定的作用就是，当name改变的时候（被赋值了），可能通知其它被name影响（赋
值给它们）的变量发生改变。这里的“可能”就需要编译器来判断，这就是为什么元数据是给编译器用的原因了。在mxml里用{}的语法的地方就是绑定的对
象，比如label={xxx.name}，当name变化，label也跟着变化。这样，我们只是很简单的改变了name的值，由于有绑定，界面上的
label也跟着自动变化了

能用在哪里

三个地方：类, 变量, getter/setter。是不是public没有关系，private的就只能给自家用呗。用在Class上就是简单的给所有的public属性（包 括变量，getter/setter，普通方法）加上[Bindable]，可是一般的方法不能用[Bindable]呀，于是一般就能看到flex给了 个warning，直接无视:)。变量嘛就是上面讲的，很简单略掉。

 

[
Bindable]

private
 var
 content:Array
 = new
 Array
(
)
;
[
Bindable]

public
 function
 set
 _content(
ct:String
)
:void

{

       content = ct.split
(
SEP)
;
        this
.dispatchEvent
(
new
 Event(
&
quot;_contectChanged&
quot;)
)
;
}

[
Bindable(
&
quot;_contectChanged&
quot;)
]
              
public
 function
 get
 _wholeText(
)
:String

{

       if
(
content.length
 == 0
)

       {

              return
 &
quot;&
quot;;
       }

       else

       {

              var
 _w:String
 = &
quot;&
quot;;
              for
(
var
 i:int
=0
 ; i&
lt;content.length
 ; i++)

              {

                     _w += content[
i]
 + &
quot;\r\n&
quot;;
              }

              return
 _w;
       }

}

[DefaultProperty]

DefaultProperty元数据标签用来将一个单一属性设定为某个类的默认属性。它允许在一个容器标签内设定属性，而不用定义属性的名字。 一个简单的例子就是一个自定义Button类。 Listing 3 展示了一个简单的Button类，它将label属性设定为了DefaultProperty。 Listing 4 展示了label属性是如何在自定义Button标签中作为一个字符串定义的。

[Deprecated]

A class or class elements marked as deprecated is one which is considered obsolete, and whose use is discouraged in the current release. While the class or class element still works, its use can generate compiler warnings.

[Embed]

Embed元数据标签用来导入图片到程序。可以通过两种方式使用Embed。你可以将图片嵌入到ActionScript中并将其指派给一个变量（如同下面代码中的第一个例子），或者你也可以将图片直接指派给组件的属性（使用下面代码中的第二个例子所示的语法规则）。

例1：

[Embed(source=”myIcon.gif”)]
[Bindable]
public var myIcon:Class;<mx:Button label=”Icon Button 1″ icon=”{myIcon}”/>
<mx:Button label=”Icon Button 2″ icon=”{myIcon}”/>

例2：

<mx:Button label=”Icon Button 1″ icon=”@Embed(source=myIcon.gif’)”/><mx:Button label=”Icon Button 2″ icon=”@Embed(source=myIcon.gif’)”/>

上面这两个例子产生的结果是一样的。创建myIcon类的好处是，它在一个类中只定义一次并可以绑定到程序中的多个组件。

[Event]

Event元数据标签用来声明那些被自定义类分派的事件。将这个元数据标签添加到类定义中之后，你就可以在MXML标签中添加事件处理函数来初始化该自定义类。

[Effect]

Effect元数据标签用来定义一个自定义效果，当某个事件发生的时候该效果会被分派。

[IconFile]

IconFile 是用来定义一个jpg，gif或者png文件的文件名的，它在你的自定义类中作为图标来使用。[Embed]元数据标签可以用来嵌入图片、SWF文件、音 乐文件以及视频文件等，而IconFile则只是用来嵌入用来作为自定义类图标的文件。下面是一个IconFile的例子：

[IconFile(”icon.png”)]
public class CustomButton extends Button
{}

[Inspectable]

在使用Flex Builder 2的时候，你可能会希望某些自定义组件的属性在代码提示和属性检查器（property inspector）中显示，Inspectable元数据标签就是用来定义那些属性的。

[InstanceType]

当在一个模板对象中声明一个像IDeferredInstance这样的变量时，InstanceType元数据标签就用来声明对象的类型。下面是InstanceType的用法：

[InstanceType(”package.className”)]

[NonCommittingChangeEvent]

NonCommittingChangeEvent元数据标签在某个特定事件发生的时候可以防止变量在事件发生的过程中被更改。

[RemoteClass]

RemoteClass 可以用来将一个ActionScript类绑定到一个Java类或一个ColdFusion CFC。这样做可以自动转换数据类型。下面的例子将包com.mydomain中的名为MyClass的ActionScript类绑定到了同一个包中名 为MyClass的Java类：

package com.mydomain {
[Bindable]
[RemoteClass(alias=”com.mydomain.MyClass”)]
public class MyClass {
public var id:int; public var myText:String;

}
}

[Style]

Style元数据标签用来为组件定义自定义样式属性的。只需要简单地将Sytle元数据标签添加到类的定义当然，然后就可以使用getSytle方法获取它的值了。

 

 

 

评论

1 楼 jyslb 2011-04-21  

代码格式太差了。