通过浏览器提交、接收和分析 XML Web 服务消息

级别： 中级

Nicholas Chase (nicholas@nicholaschase.com), 开放源代码开发和分析人员, Studio B

2004 年 10 月 01 日

Applet 被设计成在“沙箱”中运行，不会对用户系统造成任何损害，因此其安全性要高于基于服务器的应用程序对等物。比方说，Java? 应用程序很容易让其他服务器的网络连接请求 Web 服务响应，applet 也能做到，只不过只能和最初发起的服务器对话。但是如果希望 applet 能够发出任意的 Web 请求，该怎么办呢？本文说明如何通过建立基于服务器的代理来解决这个问题。它还说明了如何使用 JavaScript 代码访问基于 applet 的信息。

本文将介绍如何创建一个系统，从而可以使用浏览器请求和交互任意来源的 Web 服务数据。首先创建一个基本的 applet，然后再创建从 Web 页面中提取数据的 JavaScript 代码，最后创建一个 servlet 作为非本地请求的代理。

本文假设您熟悉 Java 技术和（初步了解）XML。除了 J2SE 1.4 或更高版本这样的 Java 开发环境之外，本文还需要用到几个软件。为了发送和接收 SOAP 消息，您需要 SOAP with Attachments Application Program Interface (API) for Java（SAAJ，关于如何设置它，请参阅“ Send and receive SOAP messages with SAAJ”），以及 servlet 引擎，如 IBM? WebSphere? Application Server 或者 Apache Tomcat 来运行 servlet。关于所需各种软件包的链接，请参阅 参考资料。

一个简单的请求

首先看一看最终由 applet 发出的请求。虽然这项技术适用于任何能够通过 URL 传递的数据，但本文主要讨论 Web 服务，因此我们从一个简单的 SOAP 消息开始，如清单 1 所示。

清单 1. 一个简单的 SOAP 消息

The early bird gets the worm, but it's the second mouse that gets the cheese…

该消息允许您创建一个简单的 Java 应用程序（清单 2）来检索和解析该 URL。

清单 2. 通过 Java 应用程序访问 URL

import java.net.URLConnection;
import java.net.URL;
import javax.xml.parsers.DocumentBuilder;
import javax.xml.parsers.DocumentBuilderFactory;
import org.w3c.dom.Document;
public class SendRequest {
public static void main(String args[]){
try{
URL url = new URL("http://www.nicholaschase.com/testsoap.php");
URLConnection urlconn = url.openConnection();
Document doc = null;
try {
DocumentBuilderFactory dbf = DocumentBuilderFactory.newInstance();
DocumentBuilder db = dbf.newDocumentBuilder();
doc = db.parse(urlconn.getInputStream());
System.out.println(doc.getDocumentElement()
.getFirstChild().getNextSibling()
.getFirstChild().getNextSibling()
.getFirstChild().getNextSibling().getFirstChild().getNodeValue());
} catch (IOException e) {
System.out.println("can't find the file:"+e.getMessage());
} catch (Exception e) {
System.out.print("Problem parsing the XML.");
}
} catch (Exception e){
e.printStackTrace();
}
}
}

签名 applet 和未签名 applet

通常，applet 只能与有限的几台服务器建立连接。为了绕开这一限制，applet 需要进行数字签名。这样做虽然避开了限制，但是会造成浏览器弹出告警对话框，询问用户是否接受该签名。如果认为用户会对此类警告感到担忧，最好像下面这样来避开这一限制。

首先，创建真正的 URLConnection 。在此，需要把 InputStream 提供给 DocumentBuilder ，作为构造 Document 对象的来源。我发现输出语句不是很好，但本文主要讨论如何访问数据而不是分析数据，所以我就采用了直接引用的方法。

编译该程序然后在命令行中运行就可以得到预期的结果：

The early bird gets the worm, but it's the second mouse that gets the cheese…

您可能奇怪我为何宁愿这么麻烦地直接处理 XML，而不去使用（比方说）SAAJ。这是因为最终要把这些代码打包成一个 applet，它要在我无法控制的计算机上运行，因此希望坚持使用作为 Java 技术本身一部分的类。

创建 applet

applet 本身很简单，如清单 3 所示：

清单 3. 一个简单的 applet

import java.applet.*;
import java.awt.*;
public class SendRequest extends Applet {
public void paint(Graphics g) {
g.drawRect(0, 0, 499, 149);
g.drawString("Printing…", 5, 70);
}
}

每次打开这个 applet 时，applet 都仅仅绘制一个矩形，并在其中显示“Printing…”。保存并编译这个类，然后打开第二个文本文件创建来显示这个 applet 的 HTML 页面，如清单 4 所示。

清单 4. 显示 applet 的 HTML 页面

    **<APPLET CODE="SendRequest.class" WIDTH="500" HEIGHT="150">
  </APPLET>**

注意，通常 HTML 页面都包含用来调用 applet 代码的 APPLET 标签。将该 HTML 页面保存到 SendRequest.class 文件所在的目录中，然后在浏览器中打开它。您应该看到与图 1 类似的结果。

图 1. 简单的 applet

现在添加检索 URL 的代码。

回页首

从 applet 中访问响应

在 applet 中添加检索 URL 的代码很简单，如清单 5 所示。

清单 5. 在 applet 中添加检索 URL 的代码

import java.applet.*;
import java.awt.*;
import java.net.URLConnection;
import java.net.URL;
import javax.xml.parsers.DocumentBuilder;
import javax.xml.parsers.DocumentBuilderFactory;
import org.w3c.dom.Document;
public class SendRequest extends Applet {
public void paint(Graphics g) {
g.drawRect(0, 0, 499, 149);
g.drawString(

    **getResponseText()**, 5, 70);

}

    **public String getResponseText(){
try{
  URL url = new URL("http://www.nicholaschase.com/testsoap.php");
  URLConnection urlconn = url.openConnection();
  Document doc = null;
  try {
   DocumentBuilderFactory dbf = DocumentBuilderFactory.newInstance();
   DocumentBuilder db = dbf.newDocumentBuilder();
   doc = db.parse(urlconn.getInputStream());
   return (doc.getDocumentElement()
        .getFirstChild().getNextSibling()
        .getFirstChild().getNextSibling()
        .getFirstChild().getNextSibling()
           .getFirstChild().getNodeValue());
  } catch (Exception e) {
   return "Can't get the string.";
  }
} catch (Exception e){
  return "Problem accessing the response text.";
}

}**
}

这里包含了大量原来应用程序中的代码，只是将 main() 方法改成了 getResponseText() 方法，并在浏览器显示 applet 时输出到页面中。

一切都准备就绪，但在刷新页面时，会看到情况并非如此，如图 2 所示。（要看到变化，必须在刷新页面时按下 Ctrl键）。

图 2. 从本地文件系统中调用 applet

那么，问题出在哪儿呢？前面已经提到，applet 在设计时有一些安全性限制，其中之一就是不能访问服务器，但是不包括最初下载 applet 的服务器。因此，为了从 www.nicholaschase.com 上请求 URL，只需要把 applet 和 HTML 文件上传到那台服务器上。然后再调用 applet，就能得到预期的结果，如图 3 所示。

图 3. 从适当的服务器上访问 applet

现在已经获得了数据，可以从 HTML 页面中访问了。

回页首

通过 JavaScript 访问 applet 数据

这个过程的最终目标是使用 JavaScript 代码分析检索的数据。其中的关键是将 applet 看作一个对象，事实上， APPLET 标签最后将被替换为 object 标签。为了替换标签，必须为其指定 id 属性，如清单 6 所示。

清单 6. 作为对象访问 applet

**The returned data is:

**

为 applet 指定一个 id 属性，从而能够将其作为简单的对象处理，并且可以直接调用 applet 的方法。如果保存该页面并刷新它，就会看到从页面中提取的信息（参见图 4）。

图 4: 通过 JavaScript 访问 applet 数据

现在就只剩下能够访问任意 URL 的问题了。

回页首

创建代理

现在万事俱备，但是因为安全性要求，您只能访问下载 applet 的服务器。如何才能访问不同的服务器呢？

比方说，假设要从 Quote of the Day service 获得实时报价。由于 applet 只能连接到自己的服务器，所以您就不能直接连接到 applet。但是服务器可以连接任何事物，就是说除了直接连接到数据，您还可以连接到检索数据的 servlet。

清单 7 中的代码创建了一个从 Quote of the Day service 中检索响应的 servlet。

清单 7. 检索远程信息的 servlet

import javax.servlet.http.*;
import javax.servlet.*;

import javax.xml.soap.SOAPConnectionFactory;
import javax.xml.soap.SOAPConnection;
import javax.xml.soap.MessageFactory;
import javax.xml.soap.SOAPMessage;
import javax.xml.soap.SOAPPart;
import javax.xml.soap.SOAPEnvelope;
import javax.xml.soap.SOAPBody;
import javax.xml.soap.SOAPElement;
import javax.xml.transform.TransformerFactory;
import javax.xml.transform.Transformer;
import javax.xml.transform.Source;
import javax.xml.transform.stream.StreamResult;
public class SendingServlet extends HttpServlet {
public void doGet(HttpServletRequest req, HttpServletResponse resp)
throws ServletException {
try {

   //First create the connection
   SOAPConnectionFactory soapConnFactory = 
                  SOAPConnectionFactory.newInstance();
   SOAPConnection connection = 
                    soapConnFactory.createConnection();

   //Next, create the actual message
   MessageFactory messageFactory = MessageFactory.newInstance();
   SOAPMessage message = messageFactory.createMessage();

   //Create objects for the message parts            
   SOAPPart soapPart =     message.getSOAPPart();
   SOAPEnvelope envelope = soapPart.getEnvelope();
   SOAPBody body =         envelope.getBody();
   //Populate the body
   //Create the main element and namespace
   SOAPElement bodyElement = 
       body.addChildElement(envelope.createName("getQuote" , 
                                 "ns1", 
                                 "urn:xmethods-qotd"));
   //Save the message
   message.saveChanges();
   //Send the message and get a reply   

   //Set the destination
   String destination = 
          "http://webservices.codingtheweb.com/bin/qotd";
   //Send the message
   SOAPMessage reply = connection.call(message, destination);
   //Check the output
   //Create the transformer
   TransformerFactory transformerFactory = 
                     TransformerFactory.newInstance();
   Transformer transformer = 
                   transformerFactory.newTransformer();
   //Extract the content of the reply
   Source sourceContent = reply.getSOAPPart().getContent();
   resp.setHeader("Content-Type", "text/plain");
   //Set the output for the transformation
   StreamResult result = new StreamResult(resp.getWriter());
   transformer.transform(sourceContent, result);
   //Close the connection            
   connection.close();

 } catch(Exception e) {
  System.out.println(e.getMessage());
 }

}
}

这段脚本看起来又长又复杂，但实际上非常简单。它首先创建 SOAPConnection 和消息对象，然后根据 Quote of the Day service 的要求使用 getQuote 元素填充该对象。

创建完成请求消息之后，将其发送到服务并检索答复。将答复作为 SOAPMessage 对象返回，但是您需要把消息的实际文本传递给 servlet 的 Response 对象。为此，只需要使用以响应为目标的 XSLT 恒等转换。

编译上述 servlet，并按照一般的 servlet 方式安装它（如果需要帮助，请参阅 参考资料），然后就可以直接从浏览器中调用它，并看到图 5 所示的结果。

图 5: 本地 servlet 检索得到的远程响应

现在，把远程信息放到 applet 中就与调用 servlet 一样简单了，如清单 8 所示：

清单 8. 从 applet 中调用远程数据

…
public void paint(Graphics g) {
g.drawRect(0, 0, 499, 149);
g.drawString(getResponseText(), 5, 70);
}
public String getResponseText(){
try{
URL url = new URL("

    **http://localhost:8080/servlet/SendingServlet**");
    URLConnection urlconn = url.openConnection();
    Document doc = null;
    try {
       DocumentBuilderFactory dbf = DocumentBuilderFactory.newInstance();
       DocumentBuilder db = dbf.newDocumentBuilder();
       doc = db.parse(urlconn.getInputStream());

       return (doc.getDocumentElement()


    **.getFirstChild().getFirstChild().getFirstChild()
               .getFirstChild().getNodeValue());** 
    } catch (Exception e) {
       return "Can't get the string:"+e.toString();
    }
 } catch (Exception e){
    return "Problem accessing the response text."+e.toString();
 }

}
}

注意，这里的代码基本上是相同的，只有两个地方不一样。首先，这里没有直接调用数据，而是调用检索数据的 servlet。其次，因为服务返回的消息没有断行，所以在这里稍微整理了一下。

如需查看结果，可以将 applet 和 HTML 页面复制到安装 serlevt 的服务器上，然后就可以访问 applet 并察看结果了，如图 6 所示。

图 6: 查看结果

回页首

结束语

本文介绍了如何创建一个系统，可以使浏览器访问任意的 Web 服务。JavaScript 代码在 applet 中调用了一个方法，而 applet 又调用了检索远程信息的 servlet，这样就避开了 applet 访问能力的限制。

现在，您可以从几个方面来理清整个过程或者增强其功能。因为数据是被拖放入 JavaScript 代码中的，所以您不需要在页面上显示真正的 applet。您还可以修改 applet，从服务中检索多条信息，或者在单个请求中传回信息，而不必在每次用户更改窗口时发送新的请求。

如果想更进一步，还可以修改 servlet 的选项，使它从 applet 中获取参数。这些参数可以决定 servlet 调用什么服务，或者传递给服务什么参数。使用这些方法（如本文中的 getResponseText() ），您甚至可以编写 JavaScript 代码，将这些参数导入 applet，让用户决定最终显示什么信息。

关于作者

Nicholas Chase是 Studio B的作者，曾参与过许多公司网站的开发，其中包括 Lucent Technologies、Sun Microsystems、Oracle 和 Tampa Bay Buccaneers。Nick 曾经做过高中物理教师、低级放射性废弃设备管理员、在线科幻杂志的编辑、多媒体工程师以及 Oracle 教员。最近，他在担任美国佛罗里达州克利尔沃特市一家交互通信公司的首席技术官，同时，他还是几本介绍 XML 和 Web 开发的书籍的作者，其中包括 XML Primer Plus ( Sams)。目前，他正准备购买一座农场，打算和妻子饲养羊驼和小鸡。他很想听到读者的意见，您可以通过 nicholas@nicholaschase.com 与他联系。