本文将介绍如何编写一个简单的、基于控制台的Java SOAP客户机，以访问Open Calais Web服务。本教程所介绍的概念同样适用于为任何其它Web服务编写SOAP客户机。
目录
»
§ 用于Open Calais的SOAP客户机
§ 简介：Calais Web服务
§ 运行原理
§ 前提条件
§ 为Open Calais创建SOAP客户机
§ 使用Open Calais API构造和发送SOAP请求
§ 在RDF中获取和显示结果
§ 更多练习
§ 结束语
§ 参考资料
简介：Calais Web服务
根据 http://opencalais.mashery.com/Overview 的定义，Calais Web服务可以自动将富语义元数据附加到所提交的内容中，整个过程不会超过1秒钟。通过自然语言处理、机器学习和其它方法，Calais能够对文档进行分类并将它们与实体（人、位置、组织等）、事实（在‘y’公司工作的职员‘x’）和事件（职员‘z’于‘x’日被任命为‘y’公司的主席）相链接。元数据结果将集中保存，并以行业标准的RDF结构随全局唯一标识符（GUID）一并返回给用户。借助Calais GUID，任何下游用户都可以通过简单的Calais调用来获取该元数据。
通过该元数据，您可以建立文档与人、公司、地点、产品、事件以及地理等任何事物之间的链接映射（或者图表、网络）。您可以使用这些映射改善站点的导航，提供上下文联合，标记和组织内容，创建结构化的folksonomies，筛选并去除重复新闻资料或分析内容中是否包含您所关心的主题。此外，还可以与内容生态系统中的任何人共享这些映射。
运行原理
以编程人员的观点来看，您可以构建SOAP请求并将其发送给Web服务的远程端点。Web服务以 资源描述框架 的输出作为响应。
前提条件
NetBeans IDE（最好6.0以上）、Web和Java EE安装包
JDK 1.6.0以上
了解RDF的基础知识
了解语义Web的基础知识
了解Web服务的基础知识
为Open Calais创建SOAP客户机
创建Java应用程序项目。在该项目中，创建一个Web服务客户机来使用Open Calais enlighten服务。
在新建项目向导中，创建一个Java应用程序项目。将其命名为contextualizer。接受所有的默认设置，然后创建一个Main类。
右键单击项目节点。这将弹出上下文菜单。
选择新建->Web服务客户机。
添加enlighten WSDL的URL：http://api.opencalais.com/enlighten/?wsdl。
现在代码将通过WSDL获取Web服务相关信息。
信息获取完成后，展开项目浏览器中“Web服务引用”节点。可以看到Web服务中可用的SOAP函数。
使用Open Calais API构造和发送SOAP请求
Open Calais API为SOAP 1.1和SOAP 1.2都提供了一个名称为”enlighten”的函数。我们将在客户机中使用SOAP 1.1函数。
单击左侧的"enlighten"节点，并将其拖拽到"contextualiser.Main"类中。以下代码将添加到主函数的已有类中：
try { // Call Web Service Operation
contextualiser.Calais service = new contextualiser.Calais();
contextualiser.CalaisSoap port = service.getCalaisSoap();
// TODO initialize WS operation arguments here
java.lang.String licenseID = "";
java.lang.String content = "";
java.lang.String paramsXML = "";
// TODO process result here
java.lang.String result = port.enlighten(licenseID, content, paramsXML);
System.out.println("Result = "+result);
} catch (Exception ex) {
// TODO handle custom exceptions here
}
要了解调用API的各种参数，请参阅Open Calais API指南。
特别地，我们必须通过SOAP请求发送以下信息：
许可ID，或开发人员密钥（注册Open Calais网站获得）
希望获取的语义元数据文本
ParamsXML：预定义XML格式的字符串
使用"water"作为文本。ParamsXML就是Open Calais API文档中说明的那个。 现在，源代码应如下所示：
/*
* To change this template, choose Tools | Templates
* and open the template in the editor.
*/
package contextualiser;
import java.io.BufferedReader;
import java.io.FileReader;
import java.io.IOException;
/**
*
* @author amit
*/
public class Main {
/**
* @param args the command line arguments
*/
public static void main(String[] args) {
// TODO code application logic here
try { // Call Web Service Operation
contextualiser.Calais service = new contextualiser.Calais();
contextualiser.CalaisSoap port = service.getCalaisSoap();
// TODO initialize WS operation arguments here
java.lang.String licenseID = "1234567890134"; //replace this with your own license key
java.lang.String content = "water";
java.lang.String paramsXML="";
String line;
try{
FileReader input = new FileReader("paramsXML.xml");
BufferedReader bufRead = new BufferedReader(input);
while((line=bufRead.readLine())!=null){
paramsXML+= line;
System.out.println(line);
}
}catch(IOException e){
System.out.println(e);
}
// TODO process result here
java.lang.String result = port.enlighten(licenseID, content, paramsXML);
System.out.println("Result = "+result);
} catch (Exception ex) {
// TODO handle custom exceptions here
}
}
}
发表于 @ 2008年04月30日 14:25:03|评论(loading...)|编辑