MXML 代码

以下示例中的应用程序使用 RemoteObject 组件调用 ColdFusion 组件。ColdFusion 组件查询一个名为 users 的 MySQL 数据库表。它将查询结果返回到应用程序，在该应用程序中，查询结果将绑定到 DataGrid 控件的?dataProvider?属性并显示在 DataGrid 控件中。应用程序还将新用户的用户名和电子邮件地址发送到 ColdFusion 组件，ColdFusion 组件会在用户数据库表中执行插入操作。

<?xml version="1.0" encoding="utf-8"?> 
<s:Application xmlns:fx="http://ns.adobe.com/mxml/2009" 
        xmlns:s="library://ns.adobe.com/flex/spark" 
        xmlns:mx="library://ns.adobe.com/flex/mx" minWidth="955" minHeight="600"> 
    <fx:Declarations> 
        <mx:RemoteObject 
            id="userRequest" 
            destination="ColdFusion" 
            source="flexapp.returnusers"> 
             
            <mx:method name="returnRecords" result="returnHandler(event)" 
                       fault="mx.controls.Alert.show(event.fault.faultString)"/> 
            <mx:method name="insertRecord" result="insertHandler()" 
                       fault="mx.controls.Alert.show(event.fault.faultString)"/> 
        </mx:RemoteObject> 
    </fx:Declarations> 
     
    <fx:Script> 
        <![CDATA[ 
            import mx.rpc.events.ResultEvent; 
             
            private function returnHandler(e:ResultEvent):void  
            { 
                dgUserRequest.dataProvider = e.result; 
            } 
            private function insertHandler():void  
            { 
                userRequest.returnRecords(); 
            } 
            private function clickHandler():void  
            { 
                userRequest.insertRecord(username.text,emailaddress.text); 
            }  
        ]]> 
    </fx:Script> 
     
    <mx:Form x="22" y="10" width="300"> 
        <mx:FormItem> 
            <s:Label text="Username" />     
            <s:TextInput id="username"/> 
        </mx:FormItem> 
        <mx:FormItem> 
            <s:Label text="Email Address" />     
            <s:TextInput id="emailaddress"/> 
        </mx:FormItem> 
        <s:Button label="Submit" click="clickHandler()"/> 
    </mx:Form> 
 
    <mx:DataGrid id="dgUserRequest" x="22" y="200"> 
        <mx:columns> 
            <mx:DataGridColumn headerText="User ID" dataField="userid"/> 
            <mx:DataGridColumn headerText="User Name" dataField="username"/> 
        </mx:columns> 
    </mx:DataGrid> 
</s:Application>

在此应用程序中，RemoteObject 组件的?destination?属性设置为?Coldfusion，source?属性设置为 ColdFusion 组件的完全限定名称。

与之相反，在使用 LiveCycle Data Services ES 或 BlazeDS 时，需要在配置文件（默认情况下为 remoting-config.xml 文件）内为远程服务目标的?source?属性指定完全限定的类名，并在 RemoteObject 组件的destination?属性中指定目标的名称。目标类还必须具有不带任何参数的构造函数。在使用 ColdFusion 时，您可以选择按这种方式配置目标，而不是使用 RemoteObject 组件的?source?属性。

ColdFusion 组件

应用程序调用下面的 ColdFusion 组件。此 ColdFusion 代码执行 SQL 数据库插入和查询，并将查询结果返回到应用程序。ColdFusion 页使用?cfquery?标签在数据库中插入数据并查询数据库，使用?cfreturn?标签将查询结果的格式设置为 ColdFusion 查询对象。

<cfcomponent name="returnusers">  
    <cffunction name="returnRecords" access="remote" returnType="query"> 
 
        <cfquery name="alluserinfo" datasource="flexcf"> 
                SELECT userid,username,emailaddress FROM users 
        </cfquery> 
        <cfreturn alluserinfo> 
    </cffunction> 
    <cffunction name="insertRecord" access="remote" returnType="void"> 
 
        <cfargument name="username" required="true" type="string"> 
        <cfargument name="emailaddress" required="true" type="string"> 
        <cfquery name="addempinfo" datasource="flexcf"> 
            INSERT INTO users (username,emailaddress) VALUES ( 
            <cfqueryparam value="#arguments.username#" cfsqltype="CF_SQL_VARCHAR" maxlength="255">,<cfqueryparam value="#arguments.emailaddress#" cfsqltype="CF_SQL_VARCHAR" maxlength="255"> ) 
        </cfquery>     
        <cfreturn> 
    </cffunction>     
</cfcomponent>

将数据从 ActionScript 转换为 Java

当方法参数将数据从应用程序发送到 Java 对象时，数据会自动从 ActionScript 数据类型转换为 Java 数据类型。当 LiveCycle Data Services ES 或 BlazeDS 搜索 Java 对象的合适的方法时，它会进一步使用更宽松的转换来查找匹配项。

客户端上的简单数据类型（如 Boolean 和 String 值）通常与远程 API 完全匹配。但是，Flex 在搜索 Java 对象的合适的方法时，会尝试一些简单的转换。

ActionScript Array 可以通过两种方法来编制条目索引。严格 Array?中的所有索引均为 Number 类型。关联 Array?中至少有一个索引是基于 String 类型的。一定要了解向服务器发送的 Array 的类型，因为 Array 类型会更改用来针对 Java 对象调用方法的参数的数据类型。密集 Array?中所有的数值索引都是连续的（即没有间隔），从 0（零）开始。稀疏 Array?的数值索引之间有间隔；这种 Array 作为对象来处理，数值索引会变为属性，这些属性会序列化为 java.util.Map 对象，以免发送许多空条目。

下表列出了对于简单数据类型所支持的 ActionScript (AMF 3) 到 Java 转换。

在 Java 中，基元值不能设置为?null。在将 Boolean 和 Number 值从客户端传递到 Java 对象时，Flex 将?null?值解释为基元类型的默认值，例如，0（对于 double、float、long、int、short 和 byte）、u0000（对于 char）和?false（对于 Boolean）。只有基元 Java 类型才能获得默认值。

LiveCycle Data Services ES 和 BlazeDS 会像处理任何其它已设置类型的对象那样处理 java.lang.Throwable 对象。处理 java.lang.Throwable 对象时遵循的规则是查找公共字段和 bean 属性，并将有类型对象返回到客户端。这些规则与普通的 bean 规则相似，区别在于这些规则会检查 getter 是否具有只读属性。这允许您从 Java 异常获取更多信息。如果需要 Throwable 对象的旧行为，则可以将通道的?legacy-throwable?属性设置为?true；有关更多信息，请参阅为通道配置 AMF 序列化。

可以将严格 Array 以参数形式传递给要求 java.util.Collection 实现或本机 Java Array API 的方法。

Java Collection 可以包含任意数量的 Object 类型，而 Java Array 要求各个条目具有相同的类型（例如，java.lang.Object[ ] 和 int[ ])）。

LiveCycle Data Services ES 和 BlazeDS 也将 ActionScript 严格 Array 转换为常见 Collection API 接口的适当实现。例如，如果将 ActionScript 严格 Array 发送到 Java 对象方法?public void addProducts(java.util.Set products)，则 LiveCycle Data Services ES 和 BlazeDS 会先将其转换为 java.util.HashSet 实例然后再以参数形式传递它，这是由于 HashSet 是 java.util.Set 接口的适当实现。同样，LiveCycle Data Services ES 和 BlazeDS 将 java.util.TreeSet 实例传递到用 java.util.SortedSet 接口设置类型的参数。

LiveCycle Data Services ES 和 BlazeDS 会将 java.util.ArrayList 实例传递到使用 java.util.List 接口以及任何其它扩展了 java.util.Collection 的接口来设置类型的参数。这些类型随后将作为 mx.collections.ArrayCollection 实例发回到客户端。如果需要将标准 ActionScript Array 发送回客户端，则必须在通道定义的属性的?serialization?部分中将?legacy-collection?元素设置为?true。有关更多信息，请参阅为通道配置 AMF 序列化。

显式映射 ActionScript 和 Java 对象

对于 LiveCycle Data Services ES 和 BlazeDS 不隐式处理的 Java 对象，在公共 bean 属性中找到的具有 get/set 方法和公共变量的值将作为 0bject 的属性发送到客户端。私有属性、常量、静态属性和只读属性等将不会进行序列化。对于 ActionScript 对象，用 get/set 访问器和公共变量定义的公共属性将发送到服务器。

LiveCycle Data Services ES 和 BlazeDS 使用标准的 Java 类 (java.beans.Introspector) 获取 JavaBean 类的属性描述符，还使用反射功能收集类的公共字段，并且优先使用 bean 属性（而不是字段）。Java 属性名与 ActionScript 属性名应该匹配。本机 Flash Player 代码用来确定 ActionScript 类如何在客户端上进行内部检查。

在 ActionScript 类中，可以使用?[RemoteClass(alias=" ")]?元数据标签来创建直接映射到 Java 对象的 ActionScript 对象。数据所转换到的 ActionScript 类必须在 MXML 文件中使用或引用，才能链接到 SWF 文件并在运行时可用。实现上述操作的一个好办法是对结果对象进行强制转换，如下面的示例所示：

var result:MyClass = MyClass(event.result);

类本身应该使用强类型引用，以便它的依赖项也可以被链接。

下面的示例显示了一个使用?[RemoteClass(alias=" ")]?元数据标签的 ActionScript 类的源代码：

package samples.contact { 
    [Bindable] 
    [RemoteClass(alias="samples.contact.Contact")] 
    public class Contact { 
        public var contactId:int; 
 
        public var firstName:String; 
 
        public var lastName:String; 
 
        public var address:String; 
 
        public var city:String; 
 
        public var state:String; 
 
        public var zip:String; 
    } 
}

如果您不映射到服务器上的 Java 对象，但需要将对象类型从服务器发回，则可以使用没有别名的?[RemoteClass]?元数据标签。在将 ActionScript 对象发送到服务器时，它会序列化为一个特殊的 Map 对象，但是从服务器返回到客户端的对象还是最初的 ActionScript 类型。

为了禁止将特定属性从 ActionScript 类发送到服务器，需要在 ActionScript 类中该属性声明的上方使用?[Transient]?元数据标签。

将数据从 Java 转换为 ActionScript

从 Java 方法返回的对象将由 Java 转换为 ActionScript。LiveCycle Data Services ES 和 BlazeDS 也处理在对象中找到的对象。LiveCycle Data Services ES 隐式处理下表中的 Java 数据类型。

为通道配置 AMF 序列化

您可以支持早期版本的 Flex 中所使用的旧 AMF 类型序列化，并在 services-config.xml 文件的通道定义中配置其它序列化属性。

下表描述了可以在通道定义的?<serialization>?元素中设置的属性：

<ignore-property-errors>    true</ignore-property-errors>