当前位置: 王朝网络 >> java/jsp >> 实例讲解：JAVA SOAP技术（2）完

实例讲解：JAVA SOAP技术（2）完

王朝java/jsp·作者佚名 2006-01-08

Very Simple Object Access Protocol with Java

现在，我们来一步步的看看到底发生了什么。在Step 1里，HelloWorldClient将连接一个SOAP RPC Router，请求我们的SOAP Service并将包含我们名字的一个字符串传递给它。该SOAP RPC Router会检查是否它已经部署了这个SOAP Service。如果它被发现是被部署的，那么它将传递数据到这个SOAP Service并调用特定的方法，这个是Step 2。然后SOAP Service方法会被执行，将返回某个字符串值（该值就是SOAP Client的答复或者响应）（Step 3）。在Step4中，SOAP RPC Router将仅仅只是重定向这个数据到SOAP Client。所有在Step1和Step4里传输的数据是通过SOAP Envelope来完成的。正如你所看到的，算法是相当简单的，因此我们只准备关心实际的代码。

首先，我们要创建一个SOAP Service。下面是它的代码，请不要忘记将它放入HelloWorld/ 目录中（必须被包含在你的CLASSPATH中）：

1: // SOAPService.java

2: package HelloWorld;

3: public class SOAPService {

4: public String sayHi(String x) {

5: return("Hello my friend, " + x + "! Glad to see you!");

6: }

7: }

添加任何注释也是很容易的。要编译它，只需要用下列命令：

javac SOAPService.java

第二步，一旦我们准备好了SOAP Service，我们需要用SOAP Service Manager来部署它。这个可以通过很多方式来实现，但是为了能让初学SOAP的读者更容易理解SOAP，我提供了一个最容易的方式。我们假设你的Web Server（Tomcat或其他）已经正常运行，并且你已经正确安装了SOAP。那么当浏览器访问http://localhost:8080/soap/，你会看见Apache SOAP的欢迎页面。点击Run the admin client ，然后 Deploy。你会得到一个屏幕显示，在那里你需要填入ID，Scope，Method，Provider Type和JAVA Provider的信息到表单域中。你能忽略其他所有的表单域，除非你真的需要它们的信息。我们的“HelloWorld”例子不需要它们，所以，我们填的下面的值：

ID:

urn:HelloWorld_SOAPService

Scope:

Application

Methods:

sayHi

Provider Type:

java

Java Provider - Provider Class:

HelloWorld.SOAPService

Java Provider - Static?

一些注释：ID是我们要从SOAP Client标识我们的SOAP Service的唯一名字。Method包含SOAP Service提供的一系列方法。JAVA Provider-Provider Class是SOAP Service Java类的名字。

现在，点击Deploy 按钮，那么你的服务会被部署。再次强调，请注意正确设置CLASSPATH环境变量。然后，你的HelloWorld.SOAPService类能够被找到，并且所有必需的jar包也能被找到。这是个几乎每个人都会犯的普通错误。现在，你能够点击 List ，将会看见你的服务已经被部署进来。恭喜！

最后，让我们来创建一个SOAP Client。代码看起来有点复杂，但是在现实中不会只有这么点长。

1: // HelloWorldClient.java

2: import java.io.*;

3: import java.net.*;

4: import java.util.*;

5: import org.apache.soap.*;

6: import org.apache.soap.rpc.*;

7: public class HelloWorldClient {

8: public static void main(String[] arg) throws Exception {

9: Call c = null;

10: URL url = null;

11: Vector params = null;

12: Response rep = null;

13: String ourName = "Superman";

14: String ourUrn = "urn:HelloWorld_SOAPService";

15: String ourMethod = "sayHi";

16: url = new URL("http://localhost:8080/soap/servlet/

rpcrouter");

17: System.out.println("Passing to our deployed "+ourUrn+"

our name ("+ourName+"): ");

18: c = new Call();

19: c.setTargetObjectURI(ourUrn);

20: c.setMethodName(ourMethod);

21: c.setEncodingStyleURI(Constants.NS_URI_SOAP_ENC);

22: params = new Vector();

23: params.addElement(new Parameter("ourName", String.class,

ourName, null));

24: c.setParams(params);

25: System.out.print("and its answer is: ");

26: rep = c.invoke(url, "");

27: if (rep.generatedFault()) {

28: Fault fault = rep.getFault();

29: System.out.println("\nCall failed!");

30: System.out.println("Code = " + fault.getFaultCode());

31: System.out.println("String = " + fault.getFaultString());

32: } else {

33: Parameter result = rep.getReturnValue();

34: System.out.print(result.getValue());

35: System.out.println();

36: }

37: }

38:}

下面我要做一些解释。在第13行，我们设置了我们的名字，这个名字将会传递给SOAP Service。在第14行，我们设置了我们将要调用的服务的ID（service ID），和第15行里设置的服务方法（service method）。有了这个ID，服务能够被部署到SOAP服务管理器（SOAP Service Manager）中。我们没有设置任何其他值，仅仅只用刚才那些基础值就可以正常运作了。你能从SOAP的官方文档上得到相关信息，该文档来自SOAP包中，它们的解释超出了本文的范围。

用以下方式编译这个SOAP Client：

javac HelloWorldClient.java

为了圆满完成它，让我们检查一下针对我们的测试，是否所有事情都准备就绪。Tomcat正在运行，所有的环境变量都正确，SOAP Service被编译和部署，SOAP Client被成功编译。OK，让我们运行它，你将看到这个屏幕：