[转]Flex中itemRenderer使用(三)：通信相关

http://nianshi.iteye.com/blog/743828

flex itemRenderer使用(三)：通信
文章分类:Flash编程
在本系列的第 2 部分中, 我向您展示了如何使用 MXML 和 ActionScript 创建外部 itemRenderer。在我用过的示例中, 有一个调度自定事件 BuyBookEvent 的 Button－这样应用程序可以对它作出响应。本文进一步讨论与 itemRenderer 的通信。

我坚信有一条规则是永远不能违背的: 不能抓住 itemRenderer 的实例不放, 更改它 (设置公共属性) 或调用它的公共方法。这对我而言是一个禁忌。itemRenderer 是很难弄清的, 我在第 1 部分中说到了其中的缘由: itemRenderer 是循环使用的。抓住一个会破坏 Flex 框架。

请将这条规则谨记在心, 您可以使用 itemRenderer 完成以下操作:

•itemRenderer 可以通过它的列表所有者调度事件。 (您已经看到过冒泡; 这个做法更好, 接下来您就会看到。)
•itemRenderer 可以使用静态类成员。其中包括 Application.application。如果您的值“全局”存储在应用程序对象中, 您可以通过这种方式获得它们。
•itemRenderer 可以使用拥有它的列表的公共成员。接下来您就会看到。
•itemRenderer 可以使用数据记录中的任何内容。例如, 记录中的某个项目不用于直接显示, 但它却影响 itemRenderer 的行为方式。

以下是上一篇文章中用于 TileList 的 MXML itemRenderer。我将使它对外部源 (我将这个文件称为 BookItemRenderer.mxml) 的更改作出反应, 从而使它更生动:

Java代码

   1. <?xml version="1.0" encoding="utf-8"?> 
   2. <mx:HBox xmlns:mx="http://www.adobe.com/2006/mxml" width="250" height="115" > 
   3.      
   4.     <mx:Script> 
   5.     <![CDATA[         
   6.     ]]> 
   7.     </mx:Script> 
   8.      
   9.     <mx:Image id="bookImage" source="{data.image}" /> 
  10.     <mx:VBox height="115" verticalAlign="top" verticalGap="0"> 
  11.         <mx:Text text="{data.title}" fontWeight="bold" width="100%"/> 
  12.         <mx:Spacer height="20" /> 
  13.         <mx:Label text="{data.author}" /> 
  14.         <mx:Label text="Available {data.date}" /> 
  15.         <mx:Spacer height="100%" /> 
  16.         <mx:HBox width="100%" horizontalAlign="right"> 
  17.             <mx:Button label="Buy" fillColors="[0x99ff99,0x99ff99]"> 
  18.                 <mx:click> 
  19.                 <![CDATA[ 
  20.                     var e:BuyBookEvent = new BuyBookEvent(); 
  21.                     e.bookData = data; 
  22.                     dispatchEvent(e); 
  23.                 ]]> 
  24.                 </mx:click> 
  25.             </mx:Button> 
  26.         </mx:HBox> 
  27.     </mx:VBox> 
  28. </mx:HBox> 

<?xml version="1.0" encoding="utf-8"?>
<mx:HBox xmlns:mx="http://www.adobe.com/2006/mxml" width="250" height="115" >

<mx:Script>
<![CDATA[
]]>
</mx:Script>

<mx:Image id="bookImage" source="{data.image}" />
<mx:VBox height="115" verticalAlign="top" verticalGap="0">
<mx:Text text="{data.title}" fontWeight="bold" width="100%"/>
<mx:Spacer height="20" />
<mx:Label text="{data.author}" />
<mx:Label text="Available {data.date}" />
<mx:Spacer height="100%" />
<mx:HBox width="100%" horizontalAlign="right">
<mx:Button label="Buy" fillColors="[0x99ff99,0x99ff99]">
<mx:click>
<![CDATA[
var e:BuyBookEvent = new BuyBookEvent();
e.bookData = data;
dispatchEvent(e);
]]>
</mx:click>
</mx:Button>
</mx:HBox>
</mx:VBox>
</mx:HBox>



假设您在 TileList 中显示一个商品目录。您还有一个 Slider (不属于 itemRenderer), 它允许用户给出一个价格范围; 在此范围之外的所有商品应变灰 (itemRenderer 的 alpha 值应改变)。您需要告知所有 itemRenderer 标准已改变, 这样它们可以修改自己的 alpha 值。

覆盖 set data 可能如下:

Java代码

   1. override public function set data( value:Object ) : void 
   2. { 
   3.     super.data = value; 
   4.     if( data.price < criteria ) alpha = 0.4; 
   5.     else alpha = 1; 
   6. } 

override public function set data( value:Object ) : void
{
    super.data = value;
    if( data.price < criteria ) alpha = 0.4;
else alpha = 1;
}



问题是: 如何更改标准值？itemRenderer 的“最佳做法”是始终让它们处理为自己手头的数据。在本例中, 将测试标准作为数据的一部分不可能也不切实际。所以这在数据外留下了一个位置。您有两个选择:

•列表本身的一部分。即, 您的列表 (List、DataGrid、TileList 或其他) 可以是扩展列表控制并且将这个标准作为公共成员的类。
•作为全局数据的应用程序的一部分。
我选择第一个: 扩展一个类并将这个标准作为该类的一部分。毕竟, 这个类将用于显示数据, 而标准是显示内容的一部分。对于本例, 我将扩展 TileList 并将标准作为公共数据成员。

Java代码

   1. package 
   2. { 
   3.      
   4.     import mx.controls.TileList; 
   5.      
   6.     public class CatalogList extends TileList 
   7.     { 
   8.         public function CatalogList() 
   9.         { 
  10.             super(); 
  11.         } 
  12.          
  13.         private var _criteria:Number = 10; 
  14.          
  15.         public function get critera() : Number 
  16.         { 
  17.             return _criteria; 
  18.         } 
  19.          
  20.         public function set criteria( value:Number ) : void 
  21.         { 
  22.             _criteria = value; 
  23.         }        
  24.     } 
  25. } 

package
{

import mx.controls.TileList;

public class CatalogList extends TileList
{
public function CatalogList()
{
super();
}

private var _criteria:Number = 10;

public function get critera() : Number
{
return _criteria;
}

public function set criteria( value:Number ) : void
{
_criteria = value;
}
}
}



这个办法是, itemRenderer 外的控制可以通过更改列表控制上的这个属性来修改标准。

itemRenderer 可以访问另一块数据: 列表本身的相关信息以及它们渲染哪个行哪个列 (如果在面向列的控制中)。这称为 listData, 在 BookItemRenderer.mxml itemRenderer 示例中可以这样使用它:

Java代码

   1. override public function set data( value:Object ) : void 
   2. { 
   3.     super.data = value; 
   4.     var criteria:Number = (listData.owner as MyTileList).criteria; 
   5.     if( data.price < criteria ) alpha = 0.4; 
   6. else alpha = 1; 
   7. } 

override public function set data( value:Object ) : void
{
    super.data = value;
    var criteria:Number = (listData.owner as MyTileList).criteria;
    if( data.price < criteria ) alpha = 0.4;
else alpha = 1;
}




将这个代码放入上述示例 BooktItemRenderer.mxml 代码的 <mx:Script> 块中。

itemRenderer 的 listData property 有一个 owner 字段, 它是 itemRenderer 所属的控制。在本例中, 所有者是 MyTileList 控制－我的 TileList 扩展。将所有者字段转换为 MyTileList 即可取走标准。

IDropInListItemRenderer
当 itemRenderer 类实施 IDropInListItemRenderer 接口时, 即可访问 listData。不幸的是, UI 容器组件不实施提供 listData 访问权的接口。Button 和 Label 等控制组件提供这一访问权, 但对于容器, 您必须自己实施接口。

实施这个接口很简单, 您可以在 Flex 文档中找到说明。您必须为 BookItemRenderer 类执行以下操作:

1.由类实施接口。

Java代码

   1. <mx:HBox xmlns:mx="http://www.adobe.com/2006/mxml" ... 
   2. implements="mx.controls.listClasses.IDropInListItemRenderer"> 

<mx:HBox xmlns:mx="http://www.adobe.com/2006/mxml" ...
implements="mx.controls.listClasses.IDropInListItemRenderer">



2.将 set 和 get 函数添加到 itemRenderer 文件的 <mx:Script> 块。

Java代码

   1. import mx.controls.listClasses.BaseListData; 
   2.  
   3.     private var _listData:BaseListData; 
   4.     public function get listData() : BaseListData 
   5.     { 
   6.     return _listData; 
   7.     } 
   8.     public function set listData( value:BaseListData ) : void 
   9.     { 
  10.     _listData = value; 
  11.     } 

import mx.controls.listClasses.BaseListData;

    private var _listData:BaseListData;
    public function get listData() : BaseListData
    {
    return _listData;
    }
    public function set listData( value:BaseListData ) : void
    {
    _listData = value;
    }



Java代码

   1. 当列表控制看到 itemRenderer 实施 IDropInListItemRenderer 接口时, 它将创建一个 listData 项目并将它指派到每个 itemRenderer 实例。  
   2.  
   3. invalidateList() 
   4. 在我的类中设置这个标准并不像指派值这么简单。那样做无法告知 Flex 框架数据已更改。标准更改必须触发一个事件。以下是对 set criteria() 函数的修改内容: 

当列表控制看到 itemRenderer 实施 IDropInListItemRenderer 接口时, 它将创建一个 listData 项目并将它指派到每个 itemRenderer 实例。

invalidateList()
在我的类中设置这个标准并不像指派值这么简单。那样做无法告知 Flex 框架数据已更改。标准更改必须触发一个事件。以下是对 set criteria() 函数的修改内容:




Java代码

   1. public function set criteria( value:Number ) : void 
   2.         { 
   3.             _criteria = value; 
   4.              
   5.             invalidateList(); 
   6.         } 

public function set criteria( value:Number ) : void
{
_criteria = value;

invalidateList();
}



注意, 一旦设置 _criteria 值, 它会调用 invalidateList()。这将使用 dataProvider 的值重置所有 itemRenderer 并调用它们的 set data 函数。

随后的流程如下:

1.itemRenderer 在它的列表所有者中查找要使用的标准, 以帮助它决定如何渲染数据。
2.列表所有者类是某个 Flex 列表类的扩展, 它包含 itemRenderer 读取以及外部代码－另一个控制或 ActionScript 代码 (可能是从远程调用接收数据产生的) 设置的公共属性。
3.设置列表属性时, 它调用列表的 invalidateList() 方法。这触发了 itemRenderer 刷新, 使它们重置自己的数据 (并返回第 1 步)。




刚刚我向您展示了如何借助事件冒泡使 itemRenderer 与应用程序的其余部分通信。我认为这相当快。但我认为还有更好的方法, 它符合 itemRenderer 负责展示数据、控制负责处理数据的想法。

MyTileList 控制的构思是, 它是可售书籍目录的可见视图。当用户选中一本书籍并要购买它时, 列表控制应当将这个信息发送给应用程序。换言之:

Java代码

   1. <CatalogList bookBuy="addToCart(event)" /> 

<CatalogList bookBuy="addToCart(event)" />



万事俱备, 事件冒泡并跳过 MyTileList。冒泡方法没有将事件 (bookBuy) 与列表控制 (MyTileList) 关联在一起, 允许您将控制移到应用程序的其他部分。例如, 如果您在主 Application 中写入 bookBuy 的事件侦听器, 您无法将列表控制移到应用程序的其他部分。如果要移动, 您还得移动那个事件处理函数。另一方面, 如果您将事件与控制关联在一起, 只是移动控制。

我们这样看: 假设 Button 上的单击事件并不是 Button 调度的事件, 但由于按钮中的某个内容而冒泡。您将无法使用: <mx:Button click="doLogin()" label="Log in" />; 您必须将 doLogin() 函数放在其他位置, 这会使应用程序更难使用。

希望我已经说服您, 以下是如何将这个示例从冒泡更改为从列表控制调度。

1.将元数据添加到 CatalogList 控制, 告知编译器控制负责调度事件:

Java代码

   1. import events.BuyBookEvent; 
   2.     import mx.controls.TileList; 
   3.  
   4.     [Event(name="buyBook",type="events.BuyBookEvent")] 
   5.      
   6.     public class CatalogList extends TileList 
   7.     { 

import events.BuyBookEvent;
import mx.controls.TileList;

[Event(name="buyBook",type="events.BuyBookEvent")]

public class CatalogList extends TileList
{



2.将一个函数添加到 CatalogList 进行事件调度。itemRenderer 实例将调用这个函数:

Java代码

   1. public function dispatchBuyEvent( item:Object ) : void 
   2.         { 
   3.             var event:BuyBookEvent = new BuyBookEvent(); 
   4.             event.bookData = item; 
   5.             dispatchEvent( event ); 
   6.         } 
   7.          
   8.     } 

public function dispatchBuyEvent( item:Object ) : void
{
var event:BuyBookEvent = new BuyBookEvent();
event.bookData = item;
dispatchEvent( event );
}

}



3.将 itemRenderer 中的 Buy 按钮代码更改为调用该函数:

Java代码

   1. <mx:Button label="Buy" fillColors="[0x99ff99,0x99ff99]"> 
   2.     <mx:click> 
   3.     <![CDATA[ 
   4.         (listData.owner as CatalogList).dispatchBuyEvent(data); 
   5.     ]]> 
   6.     </mx:click> 
   7.     </mx:Button> 

<mx:Button label="Buy" fillColors="[0x99ff99,0x99ff99]">
    <mx:click>
    <![CDATA[
        (listData.owner as CatalogList).dispatchBuyEvent(data);
    ]]>
    </mx:click>
    </mx:Button>




现在, itemRenderer 中的 Button 可以使用记录数据 (或适合此操作的其他任何内容) 轻松调用列表控制中的函数, 并将与应用程序其余部分协调的职责转交给列表控制。

本例中的列表控制使用数据调度事件。应用程序可以使用 ActionScript 为这个事件添加事件侦听器, 也可以使用 MXML (因为 CatalogList.as 文件中的 [Event] 元数据) ; 使用 [Event] 元数据使开发人员能更轻松地使用您的代码。


总结：
itemRenderer 应使用事件进行任何操作通信。自定事件允许您将信息随事件传递, 这样事件使用者无需再通过 itemRenderer 获取数据。

itemRenderers 应通过覆盖它们的 set data 函数对数据更改作出“反应”。在该函数中, 它们可以访问其 listData.owner 中的值。它们还可以访问存储在静态类或通过 Application.application 存储在主应用程序中的数据。