Google 开放式 WebServices 查询接口

类别:Java 点击:0 评论:0 推荐:
  查找引擎之王 google 于 4/11 开放了它的查询接口,可以让全世界各地的 Java 以及 .NET 程序员,免费地以 WebServices 的方式,对 google 下查找指令,并且可以将结果使用于自己的程序或网页中。不过使用上也有限制,它一天只允许未付费的程序员查找 1000 次。要使用前,必须先向 google 注册帐号,取得一个 32 位长度的 license key ,每次呼叫查询时,必须带入这个 license key 即可使用。因为 WebServices 以 WSDL (Web Service Definition Language) 的方式描述所开放的接口,走的通讯协定是 SOAP on HTTP ,所以理论上可以穿越防火墙。 Java 范例程序如下∶



import java.io.*;

import com.google.soap.search.*; // 这是 googleapi.jar ,由 google 所提供



public class SearchGoogle {



public static void main(String[] args) {

if (args.length != 2)

{

System.err.println("Usage: java SearchGoogle LicenseKey 查询字符串 ");

System.exit(1);

}

String clientKey = args[0];

String queryString = args[1];



System.out.println(" 查询字符串 = " + queryString);



// 产生查找对象,设定输出编码 (big5)

GoogleSearch s = new GoogleSearch();

s.setKey(clientKey);

s.setOutputEncoding("big5");



try

{

s.setQueryString(qyeryString);

GoogleSearchResult r = s.doSearch();

System.out.println(" 查找结果 :");

System.out.println("======================");

System.out.println(r.toString());

}

catch (GoogleSearchFault e)

{

System.out.println(" 查找失败 ");

}

}

}







使用方法以及查询结果(执行环境∶ Linux + JDK 1.3.1_01 ,主机位于防火墙后端)∶







java -classpath .:../lib/googleapi.jar

SearchGoogle xxxxxxxxx- 我的 LicenseKey-xxxxxxxxx LinuxFab









查询字符串 = LinuxFab



查找结果 :





======================

{

TM = 0.048257

Q = "LinuxFab"

CT = ""

TT = ""

CATs =

{

{SE="Big5", FVN="Top/World/Chinese_Traditional/

计算机 /Operating_Systems/Unix/Linux"}

}

Start Index = 1

End Index = 10

Estimated Total Results Number = 11500

Document Filtering = true

Estimate Correct = false

Rs =

{



[

URL = "http://bbs.ee.ntu.edu.tw/boards/Linux/21/"

Title = " ◆ 【 LinuxFab 早报】 "

Snippet = " ◆ 【 LinuxFab 早报】 . ... 5, ◇

【 LinuxFab 本周专栏】 如何制作简易 Floppy Liunx, linuxfab. 07/13/01. ... "

Directory Category = {SE="", FVN=""}

Directory Title = ""

Summary = ""

Cached Size = "11k"

Related information present = true

Host Name = ""

],



[

URL = "http://bbs.ee.ntu.edu.tw/boards/Linux/21/73.html"

Title = " ◇ 【 LinuxFab 早报】 - Linux 2.4.10 内核中剽窃了 ┅ "

Snippet = " ◇ 【 LinuxFab 早报】 - Linux 2.4.10 内核中 剽窃了 ┅ .

发信人 : linuxfab.bbs ... "

Directory Category = {SE="", FVN=""}

Directory Title = ""

Summary = ""

Cached Size = "10k"

Related information present = true

Host Name = "bbs.ee.ntu.edu.tw"

],



[

URL = "http://www.lslnet.com/linux/docs/linux-3033.htm"

Title = "LinuxFab: Red Hat7.0 ? 新特色 - [? 森林 - 自由 ? 件 ]"

Snippet = " ... LinuxFab: Red Hat7.0 ? 新特色 ? 森林

http://www.lslnet.com 2000 年 9 月 24 日 09:59 ... 摘自∶

http:linuxfab.cx [ ?? 窗口 ]. ... "

Directory Category = {SE="", FVN=""}

Directory Title = ""

Summary = ""

Cached Size = "5k"

Related information present = true

Host Name = ""

],

下略







当然,输出结果不是这么杂乱, google 所提供的 api 有各种查找设定方法,例如从第几笔开始查找、设定传回笔数、偏好查找(避免查找 java 时传回 咖啡 的结果) ... 等等,各位可以好好玩一玩。



如果您不想使用 google 的 library ,您也可以利用手边的 WebServices 工具程序,自动抓取 google 所提供的 WSDL 文档(位于∶ http://api.google.com/GoogleSearch.wsdl ),并且产生相关的 java 对象。以下以 GLUE 这套 Java WebServices 软体包做范例∶







$ wsdl2java http://api.google.com/GoogleSearch.wsdl -p example -d example/



write file example/IGoogleSearchPort.java

write file example/GoogleSearchServiceHelper.java

write file example/ResultElement.java

write file example/DirectoryCategory.java

write file example/GoogleSearchResult.java

write file GoogleSearchService.map









GLUE 的强处在于它自动为您处理所有 XML <-> Java Object Mapping 以及 SOAP 传输的问题,您甚至不需要看懂 WSDL 便可直接使用 WebServices !我们现在已经将 WSDL 转换成 Java 对象, package 名为 example ,接下来便是撰写 Client 去连接 google ∶







import java.io.*;

import electric.registry.Registry;

// 包含于 GLUE-STD.jar ,为 GLUE 标准版的 library

import example.*; //GLUE 自动为您由 WSDL 产生出来的 Java 对象



public class SearchGoogle2 {



public static void main(String[] args) {

if (args.length != 2)

{

System.err.println("Usage: java SearchGoogle LicenseKey 查询字符串 ");

System.exit(1);

}

String clientKey = args[0];

String queryString = args[1];



System.out.println(" 查询字符串 = " + queryString );

String url = "http://api.google.com/GoogleSearch.wsdl";



try

{

// 利用 GLUE 产生的接口,去 bind google 的 WSDL

IGoogleSearchPort searcher

= (IGoogleSearchPort) Registry.bind(url , IGoogleSearchPort.class);

// 查询

GoogleSearchResult result = searcher.doGoogleSearch

( clientKey ,

queryString ,

0 , 1 , false ,

"" , false , "" , "Big5" , "Big5" );



System.out.println(" 查找结果 :");

System.out.println("======================");

System.out.println(" 回应数量∶ " + result.resultElements.length );

System.out.println(" 第一笔结果∶ ");

System.out.println(" 简介∶ " + result.resultElements[0].summary );

System.out.println("URL ∶ " + result.resultElements[0].URL );

System.out.println(" 片段∶ " + result.resultElements[0].snippet );

System.out.println(" 标头∶ " + result.resultElements[0].title );

System.out.println(" 主机∶ " + result.resultElements[0].hostName );

System.out.println(" 目录∶ " + result.resultElements[0].directoryTitle );

}

catch (electric.registry.RegistryException e)

{

System.out.println(" 错误∶ " + e.getMessage());

}

}

}







执行结果指令如下∶







$ java -classpath .:../lib/GLUE-STD.jar:../lib/j2ee.jar:../lib/jnet.jar

SearchGoogle2 xxxxxxxxx- 我的 LicenseKey-xxxxxxxxx LinuxFab

查询字符串 = LinuxFab







查找结果 :





======================

回应数量∶ 1

第一笔结果∶

简介∶

URL ∶ http://bbs.ee.ntu.edu.tw/boards/Linux/21/

片段∶◆ 【 LinuxFab 早报】 . ... 5, ◇

【 LinuxFab 本周专栏】

如何制作简易 Floppy Liunx, linuxfab. 07/13/01. ...

标头∶◆ 【 LinuxFab 早报】

主机∶

目录∶



要注意的是,这只是 google beta2 版本的 WSDL ,未来接口一定会有所更动,而且远端主机 (api.google.com) 仍然不太稳定,有时候会连不过去,有时又会出现 Internal Server Error 的错误。不过以上的介绍应该可以给大家一个简单的 WebServices 概念了吧?目前几乎所有的程序语言都有 WebServices 的相关软体包,不论您是 PHP 网页制作者,或是 VB 窗口程序员,应该都找到相关的软体包,直接在您的网页 / 程序上面撰写 WebServices 的 Client 以及 Server 。



截稿前消息∶全球最大的网络书店 Amazon ,也开始提供 WebServices 接口给代销商( associates ,可以在个人网页上放置连往 Amazon 的 icon 或连结,藉此赚取部分成交金额)使用。代销商现在可以利用 Amazon 提供的 WebServices 撰写 Web/Desktop 应用程序了!看来类似的 WebServices 将会逐渐在许多大站点中陆续被采用,或许 LinuxFab/SourceFab 可以考虑引进此技术,使本站成为华人 Open Source 界的网络运算中心。



参考资料
google web APIS

O'Reilly Network: Google Web API [April 21, 2002]'   原作者: smallufo

本文地址:http://com.8s8s.com/it/it18269.htm