[新闻资讯] Flex使用Bing WebService

[新闻资讯] Flex使用Bing WebService

Bing, Flex, 搜索功能

• 资讯类型: 翻译
• 来源页面: http://www.brighthub.com/hubfolio/matthew-casperson/articles/49184.aspx
• 资讯原标题: Using the Bing WebService from Flex
• 资讯原作者: Matthew Casperson

  Microsoft已经提供flex使用Bing搜索引擎的可用API。本教程将告诉你如何使用它。 导言 Bing是Microsoft最近针对搜索引擎巨头Google推出的，缓慢而稳定的吸引大部分用户向Bing转移。就像任何Web 2.0应用程序，Bing有API能使第三方开发人员访问其功能。该API可以通过JSON，XML或SOAP访问，但在正式文档中Microsoft还是侧重于VB.NET and C#语言，任何平台可以在网络服务中使用那些API。在这里，我们将建立一个简单的AIR应用程序，使用Bing执行搜索。 首先你要决定使用三种协议的哪种。as3corelib库提供了便捷的JSON对象转换工具，ActionScript支持XML做为本地存储数据类型，但是SOAP是最容易使用的协议，感谢Flex Builders提供了导入WSDL网络服务的能力。 第1步 你需要注册一个Bing的API密钥。你可以从这里进入。 第2步 创建一个新的Flex项目。在这里我们将创建一个AIR应用程序，但代码是一个Flash Web应用程序几乎是相同的。单击Data->Import Web Service (WSDL.)…选项。 使用默认的source文件夹，接着键入该WSDL URL：http://api.bing.net/search.wsdl?AppID=YourAppKeyHere&Version=2.2 保留默认设置完成导入过程。将创建与Bing服务互动所需的类文件。 第3步 Bing的API定义一个名叫Error的类，另一个类叫ArrayOfError处理引用错误。不幸的是，Flex已经包括Error类，当ArrayOfError被编译时它不能区别到底是属于Bing还是Flex的Error。在ArrayOfError类（位置在src/net/bing/ArrayOfError.as）里替换所有Error的引用进行简单的修复。 第4步 现在，Bing的API已经被导入，我们可以开始使用它。在你的图形用户界面中添加一个TextInput用于问题输入，一个TextArea显示结果，和一个按钮启动搜索。 下载 (2.17 KB) 昨天 21:42 设置显示结果的TextArea为不可编辑。 下载 (6.8 KB) 昨天 21:42 设置按钮点击事件函数search。 下载 (8.61 KB) 昨天 21:42 第5步 在WindowedApplication对象中添加脚本代码元素。这就是该应用程序的逻辑。 <mx:Script> <![CDATA[ // Code goes here ]]> </mx:Script> 复制代码 Step 6 导入需要的类。 import net.bing.InstantAnswerResult; import net.bing.AdultOption; import net.bing.SearchResultEvent; import net.bing.SourceType; import net.bing.ArrayOfSourceType; import net.bing.Error; import net.bing.SearchRequest; import net.bing.BingService; import mx.rpc.AsyncToken; import mx.rpc.events.FaultEvent; 复制代码 第7步 由于Flash安全限制，如果没有首先加载策略文件则防止任何数据被外部域加载。策略文件名称crossdomain.xml。要加载该策略文件，我们需要使用Security.loadPolicyFile函数。 [b]Security.loadPolicyFile("http://api.bing.net/crossdomain.xml"); [/b] 复制代码 第8步 我们的应用程序将直接地使用Bing的搜索功能，不是返回一个网页列表而是列出问题的具体回答。这里大部分代码与C# / VB.NET的例子类似，可以从这里查看。尽管如此，我还是将会指出一些重要的区别。 public function search():void { var bing:BingService = new BingService(); bing.addEventListener(SearchResultEvent.Search_RESULT, searchResult); bing.addEventListener(FaultEvent.FAULT, fault); var adult:AdultOption = new AdultOption(); adult._AdultOption = "Strict"; var request:SearchRequest = new SearchRequest(); request.AppId = "Your API Key"; request.Query = this.txtQuery.text; request.Market = "en-us"; request.Adult = adult; request.Latitude = 0; request.Longitude = 0; request.Radius = 0; request.Sources = new ArrayOfSourceType(["InstantAnswer"]); var token:AsyncToken = bing.search(request); } 复制代码 首先，我们创建一个新的BingService对象。这个类（几乎所有的类都在这里使用）是由Web服务导入过程中创建的。 var bing:BingService = new BingService(); 复制代码 我们需要留意两个事件，SearchResultEvent.Search_RESULT和FaultEvent.FAULT。顾名思义，该 SearchResultEvent.Search_RESULT事件当Bing成功地返回了部分搜索数据时被触发，FaultEvent.FAULT事件是出现错误时触发。 bing.addEventListener(SearchResultEvent.Search_RESULT, searchResult); bing.addEventListener(FaultEvent.FAULT, fault); 复制代码 如果你留意Bing的API示例，他们建议需要为搜索提供一个参数AppID，查询和来源，这可能是.NET应用程序导致如此（或更具体的是由.NET工具产生的网络服务类），但是Flex程序不会产生一个有效的搜索结果，在没有供应Market市场，Adult成人，Latitude纬度，Longitude经度和Radius半径参数的情况下，其中大多数是简单的字符串或整型值，但Adult参数需要建立和初始化一个新的AdultOption对象。 var adult:AdultOption = new AdultOption(); adult._AdultOption = "Strict"; 复制代码 接下来，我们创建并初始化一个新的SearchRequest对象。不言而喻，也许除了源参数，可以是下面一个或多个搜索类型： [•]        Spell [•]        Web [•]        Image [•]        RelatedSearch [•]        Phonebook [•]        Showtimes [•]        Weather [•]        Video [•]        Ad [•]        XRank [•]        InstantAnswer [•]        News [•]        QueryLocation [•]        MobileWeb [•]        Translation 不同的搜索类型返回不同的信息。通过Bing网站搜索结果是包括图像，视频和相关搜索的组合。我们正在做InstantAnswer搜索，所以我们在ArrayOfSourceType中传递一个字符串给源参数。 var request:SearchRequest = new SearchRequest(); request.AppId = "Your API Key"; request.Query = this.txtQuery.text; request.Market = "en-us"; request.Adult = adult; request.Latitude = 0; request.Longitude = 0; request.Radius = 0; request.Sources = new ArrayOfSourceType(["InstantAnswer"]); 复制代码 最后，我们发送搜索请求给Bing。与.NET例子不同的是搜索调用是异步的。.NET的例子简单的使用搜索功能显示搜索结果。Flex中我们必须使用提供的信息搜索在searchResult函数（SearchResultEvent.Search_RESULT事件侦听器）去显示结果。如果搜索请求失败，fault函数（FaultEvent.FAULT事件侦听器）将被调用。 var token:AsyncToken = bing.search(request); 复制代码 第9步 当Bing 已成功地返回结果，searchResult函数将被调用。 protected function searchResult(event:SearchResultEvent):void { if (event.result.InstantAnswer != null) { if (event.result.InstantAnswer.Results.length != 0) { var answer:InstantAnswerResult = event.result.InstantAnswer.Results[0]; var answerXML:XML = new XML(answer.InstantAnswerSpecificData); var answerText:String = answerXML.children()[0].children()[0].valueOf(); var regex:RegExp = /<BR//>/g; answerText = answerText.replace(regex, "/n"); this.txtResult.text = answerText; } } } 复制代码 InstantAnswer搜索结果包含在event.result.InstantAnswer属性。如果这个属性不为null并且包含至少1个结果，我们抓取它并将其转换为一个XML对象。 if (event.result.InstantAnswer != null) { if (event.result.InstantAnswer.Results.length != 0) { var answer:InstantAnswerResult = event.result.InstantAnswer.Results[0]; var answerXML:XML = new XML(answer.InstantAnswerSpecificData); ... } ... } 复制代码 搜索的结果如下面的XML： <?xml version="1.0" encoding="utf-8" ?> <?pageview_candidate?> <Encarta xmlns="http://schemas.microsoft.com/LiveSearch/2008/04/XML/encarta"> <Value>- uninhabited continent surrounding the South Pole, consisting of an ice-covered plateau and high mountain peaks.&lt;BR/&gt;</Value> </Encarta> 复制代码 我们希望文本中包含有Value标记，所以这样提取。 var answerText:String = answerXML.children()[0].children()[0].valueOf(); 复制代码 你会注意到，结果中包含有HTML标记，所以我们得将所有<BR/>标记替换为换行符 var regex:RegExp = /<BR//>/g; answerText = answerText.replace(regex, "/n"); 将结果发送至GUI（用户图形界面） this.txtResult.text = answerText; 第10步 Error函数现在是空的，但是在这里你需要处理所有Bing服务调用失败的响应。 protected function fault(event:FaultEvent):void { } 总结 随着最近手机宽带互联网接入发展，假定如桌面PC一样，整合桌面应用与网络服务将会变得越来越重要。一旦你理解使用Bing 与Flex和Bing与.NET两者间的不同之处，.NET的例子将会很容易地翻译成ActionScript，它给予Flex/Flash开发人员一个强大的网络搜索服务