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显示结果，和一个按钮启动搜索。

设置显示结果的TextArea为不可编辑。

设置按钮点击 事件函数search。

第5步
在WindowedApplication对象中添加脚本代码元素。这就是该应用程序的逻辑。

1. <mx:Script>
2. <![CDATA[
3. // Code goes here
4. ]]>
5. </mx:Script>

复制代码

Step 6
导入需要的类。

1. import net.bing.InstantAnswerResult;
2. import net.bing.AdultOption;
3. import net.bing.SearchResultEvent;
4. import net.bing.SourceType;
5. import net.bing.ArrayOfSourceType;
6. import net.bing.Error;
7. import net.bing.SearchRequest;
8. import net.bing.BingService;
9. import mx.rpc.AsyncToken;
10. import mx.rpc.events.FaultEvent;

复制代码

第7步
由于Flash安全限制，如果没有首先 加载策略文件则防止任何数据被外部域加载。策略文件名称crossdomain.xml。要加载该策略文件，我们需要使用Security.loadPolicyFile函数。

1. [b]Security.loadPolicyFile("http://api.bing.net/crossdomain.xml"); [/b]

复制代码

第8步
我们的应用程序将直接地使用Bing的搜索功能，不是返回一个网页列表而是列出问题的具体回答。这里大部分代码与C# / VB.NET的例子类似，可以从这里查看。尽管如此，我还是将会指出一些重要的区别。

1. public function search():void
2. {
3. var bing:BingService = new BingService();
4. bing.addEventListener(SearchResultEvent.Search_RESULT, searchResult);
5. bing.addEventListener(FaultEvent.FAULT, fault);
6. var adult:AdultOption = new AdultOption();
7. adult._AdultOption = "Strict";
8. var request:SearchRequest = new SearchRequest();
9. request.AppId = "Your API Key";
10. request.Query = this.txtQuery.text;
11. request.Market = "en-us";
12. request.Adult = adult;
13. request.Latitude = 0;
14. request.Longitude = 0;
15. request.Radius = 0;
16. request.Sources = new ArrayOfSourceType(["InstantAnswer"]);
17. var token:AsyncToken = bing.search(request);
18. }

复制代码

首先，我们创建一个新的BingService对象。这个类（几乎所有的类都在这里使用）是由Web服务导入过程中创建的。

1. var bing:BingService = new BingService();

复制代码

我们需要留意两个事件，SearchResultEvent.Search_RESULT和FaultEvent.FAULT。顾名思义，该 SearchResultEvent.Search_RESULT事件当Bing成功地返回了部分搜索数据时被触发，FaultEvent.FAULT事件是出现错误时触发。

1. bing.addEventListener(SearchResultEvent.Search_RESULT, searchResult);
2. bing.addEventListener(FaultEvent.FAULT, fault);

复制代码

如果你留意Bing的API示例，他们建议需要为搜索提供一个 参数AppID，查询和来源，这可能是.NET应用程序导致如此（或更具体的是由.NET工具产生的网络服务类），但是Flex程序不会产生一个有效的搜索结果，在没有供应Market市场，Adult成人，Latitude纬度，Longitude经度和Radius半径参数的情况下，其中大多数是简单的字符串或整型值，但Adult参数需要建立和初始化一个新的AdultOption对象。

1. var adult:AdultOption = new AdultOption();
2. adult._AdultOption = "Strict";

复制代码

接下来，我们创建并初始化一个新的SearchRequest对象。不言而喻，也许除了源参数，可以是下面一个或多个搜索类型：

• 
  [•]        Spell
  [•]        Web
  [•]        Image
  [•]        RelatedSearch
  [•]        Phonebook
  [•]        Showtimes
  [•]        Weather
  [•]        Video
  [•]        Ad
  [•]        XRank
  [•]        InstantAnswer
  [•]        News
  [•]        QueryLocation
  [•]        MobileWeb
  [•]        Translation
  
  

不同的搜索类型返回不同的信息。通过Bing网站搜索结果是包括图像，视频和相关搜索的组合。我们正在做InstantAnswer搜索，所以我们在ArrayOfSourceType中传递一个字符串给源参数。

1. var request:SearchRequest = new SearchRequest();
2. request.AppId = "Your API Key";
3. request.Query = this.txtQuery.text;
4. request.Market = "en-us";
5. request.Adult = adult;
6. request.Latitude = 0;
7. request.Longitude = 0;
8. request.Radius = 0;
9. request.Sources = new ArrayOfSourceType(["InstantAnswer"]);

复制代码

最后，我们发送搜索请求给Bing。与.NET例子不同的是搜索 调用是异步的。.NET的例子简单的使用搜索功能显示搜索结果。Flex中我们必须使用提供的信息搜索在searchResult函数（SearchResultEvent.Search_RESULT事件侦听器）去显示结果。如果搜索请求失败，fault函数（FaultEvent.FAULT事件侦听器）将被调用。

1. var token:AsyncToken = bing.search(request);

复制代码

第9步
当Bing 已成功地返回结果，searchResult函数将被调用。

1. protected function searchResult(event:SearchResultEvent):void
2. {
3. if (event.result.InstantAnswer != null)
4. {
5. if (event.result.InstantAnswer.Results.length != 0)
6. {
7. var answer:InstantAnswerResult = event.result.InstantAnswer.Results[0];
8. var answerXML:XML = new XML(answer.InstantAnswerSpecificData);
9. var answerText:String = answerXML.children()[0].children()[0].valueOf();
10. var regex:RegExp = /<BR//>/g;
11. answerText = answerText.replace(regex, "/n");
12. this.txtResult.text = answerText;
13. }
14. }
15. }

复制代码

InstantAnswer搜索结果包含在event.result.InstantAnswer属性。如果这个属性不为null并且包含至少1个结果，我们抓取它并将其转换为一个XML对象。

1. if (event.result.InstantAnswer != null)
2. {
3. if (event.result.InstantAnswer.Results.length != 0)
4. {
5. var answer:InstantAnswerResult = event.result.InstantAnswer.Results[0];
6. var answerXML:XML = new XML(answer.InstantAnswerSpecificData);
7. ...
8. }
9. ...
10. }

复制代码

搜索的结果如下面的XML：

1. <?xml version="1.0" encoding="utf-8" ?>
2. <?pageview_candidate?>
3. <Encarta xmlns="http://schemas.microsoft.com/LiveSearch/2008/04/XML/encarta">
4. <Value>- uninhabited continent surrounding the South Pole, consisting of an ice-covered plateau and high mountain peaks.&lt;BR/&gt;</Value>
5. </Encarta>

复制代码

我们希望文本中包含有Value标记，所以这样提取。

1. var answerText:String = answerXML.children()[0].children()[0].valueOf();

复制代码

你会注意到，结果中包含有HTML标记，所以我们得将所有<BR/>标记替换为换行符

1. var regex:RegExp = /<BR//>/g;
2. answerText = answerText.replace(regex, "/n");

将结果发送至GUI（用户图形界面）

1. this.txtResult.text = answerText;

第10步
Error函数现在是空的，但是在这里你需要处理所有Bing服务调用失败的响应。

1. protected function fault(event:FaultEvent):void
2. {
3. }

总结
随着最近手机宽带互联网接入发展，假定如桌面PC一样，整合桌面应用与网络服务将会变得越来越重要。一旦你理解使用Bing 与Flex和Bing与.NET两者间的不同之处，.NET的例子将会很容易地 翻译成ActionScript，它给予Flex/Flash开发人员一个强大的网络搜索服务