本文描述了一个用Java编写的不使用专门SOAP库的简单通用SOAP客户机。该客户机可以让您用任何 XML 编辑器（或文本编辑器）创建自己的请求， 而不是在暗中为您创建 SOAP 请求 XML 文档。 该客户机向您显示实际的 SOAP 响应 XML 文档，而不是仅仅提供远程方法的返回值。 这个简短的 Java 程序精确显示了什么是 SOAP：打开 HTTP 连接、发送适当 XML 以调用远程方法、接着读取服务器返回的 XML 响应。
通用 Java SOAP 客户机
SOAP（简单对象访问协议）是 IBM、Microsoft、DevelopMentor 和 UserLand Software 为在网络上交换信息而开发的一种已在发展的 W3C 标准。 随着Web上可以公开使用的SOAP服务器的不断增加，SOAP几乎对用任何语言编写的程序——即使是用流行的简单语言（如 Visual Basic、JavaScript 和 perl）编写的非常短小的程序——执行着HTML对Web浏览器所做的事：它为这些程序提供一个简单的方法来利用万维网上不断增加的可用信息源。
与 HTML 类似，SOAP 提供一套标记来表示在Web上使用HTTP传输协议（从 SOAP 1.1 以来，SMTP 也可以）发送的不同信息块的作用。但是，SOAP向您提供的能力远远强于HTML。使用SOAP，您的程序向 SOAP服务器发送“SOAP请求”（一个简短的XML文档，描述在远程机器上要调用的方法和所有要传递给它的参数）。SOAP服务器将尝试用那些参数执行该方法，并将SOAP响应发回程序。响应可以是执行的结果，也可以是相应的错误消息。可以使用公共SOAP服务器为提出请求的客户机提供股票价格、最新的货币兑换率、FedEx 包裹跟踪信息、代数表达式的解决方案以及其它各类信息。
在SOAP存在之前，尝试使用这种信息的程序必须先捕获Web页面，然后“刮下”HTML，以查找适当的文本。 对这些Web页面进行可视的重新设计（例如，将当前股票价格放到表中第三列而不是第二列中）就可以使这些程序无用。SOAP规范以及它所携带的简要的SOAP请求和响应模式为客户机和服务器之间的联络提供了一个框架，该框架是那些强健得多的信息收集工具的基础。
有许多SOAP客户机可用于大多数的流行编程语言；有关详尽列表，请参阅 SOAP::Lite for Perl 主页上的 SOAP Toolkits 部分（请参阅参考资料）。大多数 SOAP 客户机都提供类库、COM 对象或从您自己程序调用的等同对象。通常，使用这些客户机库遵循以下模式：
· 程序传递要调用的远程方法的名称和所有必需参数。
· 库组装 SOAP 请求的适当 XML 文档以将这一信息打包。
· 库将这一 XML 文档传递给 SOAP 端点 URL 标识的 SOAP 服务器，这与通过指定服务器的 URL 将浏览器指向 Web 服务器地址很类似。
· SOAP 服务器尝试执行方法后，它组装包含执行结果的 SOAP 响应 XML 文档，并将它发回 SOAP 客户机。
· 接收SOAP响应时，客户机库对XML进行语法分析以获得方法调用的结果，并将结果传递给使用库的程序。
SOAPClient4XG
SOAP 的介绍（请参阅 developerWorks 上 Graham Glass 编写得极佳的“ Web 服务革命”专栏）总是讨论用于 SOAP 请求和响应的 XML 的结构，但是我接触到的 SOAP 客户机总是会暗中进行 XML 组装和语法分析，所以我从来不用知道。 作为使用 XML 的人员，我曾想自己执行 XML 部分；我认为如果 SOAP 这样简单，那么我应该能够编写一个简单的 SOAP 客户机来读取 SOAP 请求的 XML 文档、将它发送到命令行上指定的 SOAP 端点 URL、读回响应文档并输出该响应。这将使它成为一个真正的通用 SOAP 客户机，因为它调用任何 SOAP 服务器上的任何方法。
清单1中显示的 SoapClient4XG（“SOAP Client for XML Geeks”）Java类执行该任务，而不使用早先提到的 SOAP Toolkits 页面上列出的任何专用 Java SOAP 类（请参阅参考资料）。 检查了必需的 SOAP 端点 URL 和 SOAP XML 文档文件名参数及可选的 SOAP 操作参数后，读入文件，将它发送到 SOAP 服务器，读回响应，然后将其输出到标准出口。
清单1
Listing 1. The complete SOAP client
/**
* SOAPClient4XG. Read the SOAP envelope file passed as the second
* parameter, pass it to the SOAP endpoint passed as the first parameter, and
* print out the SOAP envelope passed as a response. with help from Michael
* Brennan 03/09/01
*
*
* @author Bob DuCharme
* @version 1.1
* @param SOAPUrl URL of SOAP Endpoint to send request.
* @param xmlFile2Send A file with an XML document of the request.
*
* 5/23/01 revision: SOAPAction added
*/
import java.io.*;
import java.net.*;
public class SOAPClient4XG {
public static void main(String[] args) throws Exception {
if (args.length < 2) {
System.err.println("Usage: java SOAPClient4XG " +
"http://soapURL soapEnvelopefile.xml" +
" [SOAPAction]");
System.err.println("SOAPAction is optional.");
System.exit(1);
}
String SOAPUrl = args[0];
String xmlFile2Send = args[1];
String SOAPAction = "";
if (args.length > 2)
SOAPAction = args[2];
// Create the connection where we're going to send the file.
URL url = new URL(SOAPUrl);
URLConnection connection = url.openConnection();
HttpURLConnection httpConn = (HttpURLConnection) connection;
// Open the input file. After we copy it to a byte array, we can see
// how big it is so that we can set the HTTP Cotent-Length
// property. (See complete e-mail below for more on this.)
FileInputStream fin = new FileInputStream(xmlFile2Send);
ByteArrayOutputStream bout = new ByteArrayOutputStream();
// Copy the SOAP file to the open connection.
copy(fin,bout);
fin.close();
byte[] b = bout.toByteArray();
// Set the appropriate HTTP parameters.
httpConn.setRequestProperty( "Content-Length",
String.valueOf( b.length ) );
httpConn.setRequestProperty("Content-Type","text/xml; charset=utf-8");
httpConn.setRequestProperty("SOAPAction",SOAPAction);
httpConn.setRequestMethod( "POST" );
httpConn.setDoOutput(true);
httpConn.setDoInput(true);
// Everything's set up; send the XML that was read in to b.
OutputStream out = httpConn.getOutputStream();
out.write( b );
out.close();
// Read the response and write it to standard out.
InputStreamReader isr =
new InputStreamReader(httpConn.getInputStream());
BufferedReader in = new BufferedReader(isr);
String inputLine;
while ((inputLine = in.readLine()) != null)
System.out.println(inputLine);
in.close();
}
// copy method from From E.R. Harold's book "Java I/O"
public static void copy(InputStream in, OutputStream out)
throws IOException {
// do not allow other threads to read from the
// input or write to the output while copying is
// taking place
synchronized (in) {
synchronized (out) {
byte[] buffer = new byte[256];
while (true) {
int bytesRead = in.read(buffer);
if (bytesRead == -1) break;
out.write(buffer, 0, bytesRead);
}
}
}
}
}
| |