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对象中添加脚本代码元素。这就是该应用程序的逻辑。

<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函数。

Security.loadPolicyFile("http://api.bing.net/crossdomain.xml");

复制代码
第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.<BR/></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开发人员一个强大的网络搜索服务