实例讲解�Q�JAVA SOAP技�?�?

JavaBird — Thu, 20 Dec 2012 06:57:00 GMT

转自�Q?div>http://www.cnblogs.com/mingzi/archive/2009/03/23/1419385.html

开始之前，我想��本文即��讨论的主题和读者需要具备的��L��知识做一些必需的描叙。本文的主题是讨论SOAP技术，我们��尽可能的讲得通俗易懂一些，所以，我们引入了一个普通的“Hello World”范例来给读者说明它们是怎么�q�作的，让读者知道它们的�q�作方式。我认�ؓ�Q�如果光看官�Ҏ��档是很难开始学习这门新技术的�Q�官�Ҏ��档中包含大量�?范例�Q��ƈ解释了所有的�Ҏ��和优点�Q�但是没解释它们的运作方式。在�q�篇文章中，我不打算只肤��的解释SOAP技术的定义�Q�我们假设读者熟悉JAVA语言�Q?a target="_blank">Web 技术，��h��XML �?�a��Q�XML Namespaces�Q�XML Schema的基��。在�q�种情况下，理解本文��不存在��M��困难。然而，即��没有�q�些知识�Q�你也不必担心，我们��尽可能的解释得��单，但是当你开始做自己�? SOAP应用�E�序时会遇到一些问题和�ȝ��。因此，��p��一定时间来学习上面的知识是很有必要的�?/span>

从技术的角度来说�Q�有必要提一下我们的调试环境。我们��用的�?a target="_blank">Windows XP操作�pȝ�� Q�安装有JAVA 2 SDK 1.4.1�Q�Apache SOAP 2.3.1�Q�JAF 1.0.2�Q?a target="_blank">JavaMail 1.3.1和Xerces 2.6.0。上面所提及的都能在Tcomcat 4.1.29 JSP /Servlet 容器中正常运行。所有的软�g都是免费自由软�g�Q�因此你能够很容易的下蝲它们�q�自己在��M��你喜�Ƣ的�q�_��如Windows或UNIX上安装它们。Java SDK�Q�JAF和JAVAMAIL位于SUN的官方网站（ http://java.sun.com �Q�，其他的��Y件在Jakarta��目�l�的官方�|�站�Q?/span> http://jakarta.apache.org �Q�上有down的。可能你在看到我们需要这么多不同的包�Q�package�Q�时已经有点担心和不安了�Q�但是实际上你不应该担心�q�些的。一旦你懂了基础�Q�那么对你将相当�Ҏ��。安装不是一件很隄��事情�Q�你只需要在讄��环境变量的时候仔�l�些�Q�比�?em>CATALINA_HOME , CLASSPATH , JAVA_HOME �{�等�Q�所有这些步骤都是手工的。由于我仅仅是想��你的注意力再次集中到它们��n上，所以你能很快的��完成以上配�|�过�E�。我只是��d��下面的一些字�W�串到Tomcat�?em>bin/setclasspath.bat 文�g中：

... set CATALINA_HOME=C:\Tomcat4.1.29 set CLASSPATH=%JAVA_HOME%\lib\tools.jar set CLASSPATH=%JAVA_HOME%\soap-2.3.1\lib\soap.jar set CLASSPATH=%CLASSPATH%;%JAVA_HOME%\javamail-1.3.1\mail.jar set CLASSPATH=%CLASSPATH%;%JAVA_HOME%\jaf-1.0.2\activation.jar set CLASSPATH=%CLASSPATH%;%JAVA_HOME%\xerces-2_6_0\xercesImpl.jar set CLASSPATH=%CLASSPATH%;%JAVA_HOME%\xerces-2_6_0\xercesSamples.jar set CLASSPATH=%CLASSPATH%;%JAVA_HOME%\xerces-2_6_0\xml-apis.jar set CLASSPATH=%CLASSPATH%;%JAVA_HOME%\xerces-2_6_0\xmlParserAPIs.jar set CLASSPATH=%CLASSPATH%;%CATALINA_HOME%\common\lib\servlet.jar set CLASSPATH=%CLASSPATH%;%CATALINA_HOME%\common\lib\tools.jar ...

如果你的安装路径�Q�installation paths�Q�和上面使用的不同，你需要更正它们，然后关闭和重启Tomcat以��它们生效。这��P��你就有�ؓ�q�行SOAP作好了准备。但是现在，我要忘记有关的技术部分，来学一点理论知识�?/span>

SOAP意思是��单对象访问协议（S imple O bject A ccess P rotocol�Q�。的��如它的名字一��P��SOAP是很��单的。它是一个基于XML的协议，允许�E�序�l��g和应用程序彼此��用一�U�标准的Internet协议 --HTTP来通讯。SOAP是一�U�独立的�q�_��Q�它不依赖程序语�a��Q�它是简单的�Q�弹性的�Q�很�Ҏ��扩展的。目前，应用�E�序能够彼此使用一�U�基于DCOM�? CORBA技术的�q�程�q�程调用�Q�RPC�Q�来�q�行�怺�通讯�Q�但HTTP不被设计��个目的。RPC在Internet上应用是非常困难的，它们会出现许多兼 �Ҏ��和安全性的问题�Q�因�?a target="_blank">防火�?/span> 和代�?a target="_blank">服务�?/span> 通常都会��L��Q�block�Q�这些类型的��量。应用程序之间最好的通讯方式是通过HTTP协议�Q�因为HTTP是支持所有Internet��览器和服务器的。基于这个目的，SOAP协议被创建出来�?/span>

那么�Q�它们是如何�q�作的呢�Q�比如，一个应用程序（A�Q�需要和另一个应用程序（B�Q�在SOAP的帮助下�q�行彼此通讯。它们将使用下面的框架图来完成这个过�E�：

�q�个SOAP信封�Q�SOAP envelope�Q�是一个包含以下内容的XML文档�Q?/span>

正如你看到的�Q�它是非常简单的。它看�v来确实就象一个普通的信封或者你�? email。你想看看它们是如何动作的吗�Q�下面跟我们一��h��吧。其实我们有很多�Ҏ��是不用SOAP来在创徏和运行我们自��q��“Hello World”应用�E�序的，但是因�ؓ我们要保持它的简单性，我会�l�你一个它�q�作方式的框架图�Q�scheme�Q��?/span>

我们�?#8220;Hello World”范例会包含一个SOAP Service。我们的SOAP Client��发送它们的名字到该SOAP Service�Q��ƈ试图得到一些答复或响应。这个SOAP Service需要部�|�到一个SOAP Admin的工��P��以至重定位所有请求的SOAP�Q�Proxy�Q?RPC Router能够知道它们应该使用哪种服务来运作。总而言之，�q�个是以下面的方式来�q�作的：

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

首先�Q�我们要创徏一个SOAP Service。下面是它的代码�Q�请不要忘记��它攑օ�HelloWorld/ 目录中（必须被包含在你的CLASSPATH中）�Q?/span>

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: }

��d��M��注释也是很容易的。要�~�译它，只需要用下列命��o�Q?/span>

javac SOAPService.java

�W�二步，一旦我们准备好了SOAP Service�Q�我们需要用SOAP Service Manager来部�|�它。这个可以通过很多方式来实玎ͼ�但是��Z��能让初学SOAP的读者更�Ҏ��理解SOAP�Q�我提供了一个最�Ҏ��的方式。我们假设你�?a target="_blank">Web Server�Q�Tomcat或其他）已经正常�q�行�Q��ƈ且你已经正确安装了SOAP。那么当��览器访�?/span> http://localhost:8080/soap/ �Q�你会看见Apache SOAP的欢�q�页面。点�?em>Run the admin client �Q�然�?Deploy �?你会得到一个屏�q�显�C�，在那里你需要填入ID�Q�Scope�Q�Method�Q�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?	No

一些注释：ID是我们要从SOAP Client标识我们的SOAP Service的唯一名字。Method包含SOAP Service提供的一�p�d��Ҏ��。JAVA Provider-Provider Class是SOAP Service Java�cȝ��名字�?/span>

现在�Q�点�?em>Deploy 按钮�Q�那么你的服务会被部�|�Ӏ�再�ơ强调，��h��意正��设�|�CLASSPATH环境变量。然后，你的HelloWorld.SOAPService�c�能够被扑ֈ��Q��ƈ且所有必需的jar包也能被扑ֈ�。这是个几乎每个人都会犯的普通错误。现在，你能够点�?List �Q�将会看见你的服务已�l�被部��v�q�来。恭喜！

最后，让我们来创徏一个SOAP Client。代码看��h��有点复杂�Q�但是在现实中不会只有这么点�ѝ�?/span>

 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:}

下面我要做一些解释。在�W?3行，我们讄��了我们的名字�Q�这个名字将会传递给 SOAP Service。在�W?4行，我们讄��了我们将要调用的服务的ID�Q�service ID�Q�，和第15行里讄��的服务方法（service method�Q�。有了这个ID�Q�服务能够被部��v到SOAP服务��理器（SOAP Service Manager�Q�中。我们没有设�|��Q何其他��|��仅仅只用刚才那些基础值就可以正常�q�作了。你能从SOAP的官�Ҏ��档上得到相关信息�Q�该文档来自SOAP�?中，它们的解释超��Z��本文的范围�?/span>

用以下方式编译这个SOAP Client�Q?/span>

javac HelloWorldClient.java

��Z��圆满完成它，让我们检查一下针�Ҏ��们的��试�Q�是否所有事情都准备��q�A。Tomcat正在�q�行�Q�所有的环境变量都正��，SOAP Service被编译和部��v�Q�SOAP Client被成功编译。OK�Q�让我们�q�行它，你将看到�q�个屏幕�Q?/span>

正如你所看到的，我们的SOAP Client使用SOAP协议成功发送它的名字和接收了一个答复。正如前面所说的�Q�SOAP Service发送和接收的是SOAP envelope。这个是SOAP envelope的源代码�?/span>

�?strong>发�?/strong> 到SOAP Service的SOAP Envelope

XML  version='1.0' encoding='UTF-8'?>    Superman   :

从SOAP Service接收的SOAP Envelope

    Hello my friend, Superman! Glad to see you!

要理解SOAP Envelope中的所有标�{��含义�Q�我��你花一�Ҏ��间阅�?http://www.w3.org/2001/06/soap-envelope 命名�I�间规范�?/span>

我希望本文能够在你理解SOAP技术上有一定帮助。这个技术是��单的�Q�有��的�Q�强大的�Q�弹性的。它被用在许多Web应用中，�q�些应用的数量也在不断增加。学习SOAP是值得的，臛_��你要知道它是什么和它是怎么�q�作�?/span>

JavaBird 2012-12-20 14:57 发表评论

亚洲国产精品无码久久一线,亚洲最大福利视频网站,99亚洲乱人伦aⅴ精品

实例讲解�Q�JAVA SOAP技�?�?