AMF 作为 REST 格式，使用 BlazeDS 和 AS3 的 URLLoader

Question

我有一个带有 HTTP API 的 ColdFusion 服务器，当前返回 JSON 或 XML 格式的响应。在内部，所有这些响应都使用 ColdFusion“结构”类型表示，然后在呈现给请求客户端之前转换为适当的格式。

使用此 API 的客户端团队要求除了 JSON 和 XML 之外，我们还返回 AMF 对象。现在，我已经看到（并且我自己也提出了）反对在 REST 场景中使用 AMF 作为“返回格式”而不是作为 RPC 格式的论点。我对关于这是否是个好主意的评论不感兴趣——我只是想知道它是否有效。如果没有，我希望有明确的理由说明为什么不会。如果它有效，我希望得到一些关于如何“makeitgo”的指导。

因此，为了实现概念验证示例，我尝试使用 BlazeDS 序列化一个二元素 ColdFusion 数组，然后在 Flash Player 10/AS3 测试中使用该序列化对象。

这是服务器端代码的样子：

//the test object I'm trying to return (keeping it simple)
var testArray = ArrayNew(1); 
testArray[1]="test"; 
testArray[2]="monkey";

//set up output stream to requesting client
var pc       = getPageContext();
var response = pc.getResponse();
var out      = response.getOutputStream();

response.setHeader("Content-Type", "application/x-amf");

//not sure if AmfMessageSerializer is the appropriate class to be using here
var amfMessageSerializer = createObject("java", "flex.messaging.io.amf.AmfMessageSerializer");  
var amfTrace             = createObject("java", "flex.messaging.io.amf.AmfTrace");  //needed by initialize() method

amfMessageSerializer.initialize(variables.SerializationContext.getSerializationContext(), out, amfTrace);

amfMessageSerializer.writeObject(testArray);

out.close(); 

现在，这会生成某种类型的二进制数据。如果我将其粘贴在 .cfm 中并尝试加载页面，我会得到一些可以在十六进制编辑器中读取的内容，它看起来包含我设置的数组成员。这里需要注意一点：响应消息的一部分包括“flex.messaging.io.ArrayCollection”。我还不够了解这告诉我什么：任何能够提供有关在两个环境之间键入的详细信息的人都会非常感谢我。

下一步是尝试在 FlashPlayer 端使用它。下面是精简后的 AS3 的样子：

myURLloader.dataFormat = URLLoaderDataFormat.BINARY;
myURLloader.addEventListener(Event.COMPLETE, completeHandler);
myURLloader.load(myURLRequest); 

function completeHandler( event : Event) : void
{   
    var serverResponse : ByteArray = new ByteArray(); 
    serverResponse = event.target.data; 

    //read the response into a generic object
    var responseObject : Object = new Object(); 
    responseObject = serverResponse.readObject();   //fails here: error #2006
}

如注释所示，此操作失败并出现错误 #2006“提供的索引超出范围”。我已经搜索了此错误的常见原因，但没有找到任何明确的答案。在尝试 readObject() 之前，我尝试将 byteArray.position 重置为 byteArray 的开头和结尾 - 将其更改为结尾会出现错误 #2030“遇到文件结尾”（正如人们所期望的那样），但我已经验证 .position 默认为 0，这会生成 #2006 错误。

我很确定这里的问题在于我使用的 BlazeDS 调用的选择；我想当我想序列化一个对象时我可能会序列化一条消息。不幸的是，BlazeDS 的 JavaDoc 自动生成的文档……缺乏启发性。我发现的所有更具可读性的资源都集中在 Flash Remoting 和 RPC 示例上。令人惊讶的是，我知道；但事实就是如此。我正在使用 Adobe BlazeDS 文档；如果其他人有更好的资源，我将非常感激。

提醒所有回答的人：我意识到这不是 AMF 的典型用途。我对建议典型 RPC 方法或切换到 Flash Remoting 而不是 HTTP/GET 的响应不感兴趣。我需要的是来自 HTTP 请求的 AMF 序列化响应，该响应可以在 Flash Player 客户端上反序列化。在这件事上我别无选择。我确实需要知道这是否可行，如果可以，我希望获得一些关于如何使其发挥作用的指导。除了“不要使用 AMF！”之外，我欢迎任何和所有建议。或“只需切换到 Flash Remoting！”

更新：在此方面取得了一些进展：
1）在服务器端，我使用blazeDS的ASObject类创建一个简单的ASObject并用键值对填充它。
2）在客户端和服务器端，我必须确保将对象编码设置为 AMF0。 AMF3 中的相同技术会生成 #2006/Out ofbounds 错误，我还不知道为什么。

现在服务器端的代码如下所示：

//set up output stream to requesting client
var pc       = getPageContext();
var response = pc.getResponse();
var out      = response.getOutputStream();

response.setHeader("Content-Type", "application/x-amf");

//not sure if AmfMessageSerializer is the appropriate class to be using here
var amfMessageSerializer = createObject("java", "flex.messaging.io.amf.AmfMessageSerializer");  
amfMessageSerializer.setVersion(variables.MessageIOConstants.AMF0);

var amfTrace  = createObject("java", "flex.messaging.io.amf.AmfTrace");  //needed by initialize() method
amfMessageSerializer.initialize(variables.SerializationContext.getSerializationContext(), out, amfTrace); 

var ASObject = createObject("java", "flex.messaging.io.amf.ASObject"); 
ASObject.put("testKey", "testValue"); //simple key-value map to return to caller

amfMessageSerializer.writeObject(testArray);

out.close(); 

这里的主要区别是，我不是尝试序列化 CF 数组，而是手动构建响应对象（ASObject 类型）。

在客户端，代码现在如下所示：

myURLloader.dataFormat = URLLoaderDataFormat.BINARY;
myURLloader.addEventListener(Event.COMPLETE, completeHandler);
myURLloader.load(myURLRequest); 

function completeHandler( event : Event) : void
{   
    var serverResponse : ByteArray = new ByteArray(); 
    serverResponse = event.target.data; 
    serverResponse.objectEncoding = ObjectEncoding.AMF0; //important

    //read the response into a generic object
    var responseObject : Object = new Object(); 
    responseObject = serverResponse.readObject(); 
    trace(responseObject.testKey);                       //displays "testValue", as expected
}

此处的区别在于我已将 ObjectEncoding 显式设置为 AMF0（默认为 AMF3）。

如果我在服务器和客户端上将 objectEncoding 切换为 AMF3，我希望一切正常，但我仍然收到 2006：越界错误。 AMF0 和 AMF3 情况下的 ByteArray.length 属性相同，但返回对象的内容不同（在十六进制编辑器中查看时）。

更改我提供的第一个示例中的 objectEncoding 对所产生的错误没有影响。

那么，问题似乎是尝试序列化 ColdFusion 数组：AMFSerializer 不知道如何处理它。它需要显式构建为 ASObject。我将构建一个清理函数来执行两种类型之间的转换。

我觉得已经取得了进展（并感谢评论和答案中的所有反馈），但我仍然有很多未解答的问题。有谁知道为什么当我尝试在 AMF3 中编码时可能会失败，但在 AMF0 中不会？我对其中之一没有任何依恋，但我不喜欢这种“把东西扔到墙上，看看哪些粘住”的解决问题的方法......我想知道为什么它失败了=/

Answer 1

我不久前就这样做了..您可以从 查看我的博客文章这里，也许对你有帮助。我在服务器端使用Java，而不是CF。