使用Java调用以WSDL形式发布的web service

首先说一下使用AXIS调用WSDL文件时需要的JAR包：（1）axis    其中包括axis.jar、axis-ant.jar、commons-discovery-0.2.jar、commons-logging-1.0.4.jar、jaxrpc.jar、log4j-1.2.8.jar、log4j.properties、saaj.jar、wsdl4j-1.5.1.jar。http://www.apache.org/dyn/closer.cgi/ws/axis/（2）javamail    mail.jar。http://java.sun.com/products/javamail/（3）jaf    activation.jar。http://java.sun.com/javase/technologies/desktop/javabeans/jaf/downloads/index.html

 

 

webservice的 发布一般都是使用WSDL（web service descriptive language）文件的样式来发布的，在WSDL文件里面，包含这个webservice暴露在外面可供使用的接口。今天搜索到了非常好的 webservice provider列表

http://www.webservicex.net/WCF/default.aspx

这上面列出了70多个包括很多方面的free webservice provider，utilities->global weather就可以获取全球的天气预报。

下面我们来看Java如何通过WSDL文件来调用这些web service：

注意，以下的代码并没有经过真正的测试，只是说明这些情况，不同版本的Axis相差很大，大家最好以apache网站上的例子为准，这里仅仅用于说明其基本用法。 

1,直接AXIS调用远程的web service

我觉得这种方法比较适合那些高手，他们能直接看懂XML格式的WSDL文件，我自己是看不懂的，尤其我不是专门搞这行的，即使一段时间看懂，后来也就忘记了。直接调用模式如下：

import java.util.Date;

import java.text.DateFormat;

import org.apache.axis.client.Call;

import org.apache.axis.client.Service;

import javax.xml.namespace.QName;

import java.lang.Integer;

import javax.xml.rpc.ParameterMode;

 

public class caClient {

            

       public static void main(String[] args) {

 

              try {

                     String endpoint = "http://localhost:8080/ca3/services/caSynrochnized?wsdl";

                     //直接引用远程的wsdl文件

                    //以下都是套路                      Service service = new Service();

                     Call call = (Call) service.createCall();

                     call.setTargetEndpointAddress(endpoint);

                     call.setOperationName("addUser");//WSDL里面描述的接口名称

                     call.addParameter("userName", org.apache.axis.encoding.XMLType.XSD_DATE,

                                   javax.xml.rpc.ParameterMode.IN);//接口的参数

                     call.setReturnType(org.apache.axis.encoding.XMLType.XSD_STRING);//设置返回类型  

                     String temp = "测试人员";

                     String result = (String)call.invoke(new Object[]{temp});

                     //给方法传递参数，并且调用方法

                     System.out.println("result is "+result);

              }

              catch (Exception e) {

                     System.err.println(e.toString());

              }

       }

}

2,直接SOAP调用远程的webservice

这种模式我从来没有见过，也没有试过，但是网络上有人贴出来，我也转过来 

import org.apache.soap.util.xml.*;

import org.apache.soap.*;

import org.apache.soap.rpc.*;

 

import java.io.*;

import java.net.*;

import java.util.Vector;

 

public class caService{

       public static String getService(String user) {

       URL url = null;

       try {

           url=new URL("http://192.168.0.100:8080/ca3/services/caSynrochnized");

       } catch (MalformedURLException mue) {

          return mue.getMessage();

         }

             // This is the main SOAP object

       Call soapCall = new Call();

       // Use SOAP encoding

       soapCall.setEncodingStyleURI(Constants.NS_URI_SOAP_ENC);

       // This is the remote object we're asking for the price

       soapCall.setTargetObjectURI("urn:xmethods-caSynrochnized");

       // This is the name of the method on the above object

       soapCall.setMethodName("getUser");

       // We need to send the ISBN number as an input parameter to the method

       Vector soapParams = new Vector();

 

       // name, type, value, encoding style

       Parameter isbnParam = new Parameter("userName", String.class, user, null);

       soapParams.addElement(isbnParam);

       soapCall.setParams(soapParams);

       try {

          // Invoke the remote method on the object

          Response soapResponse = soapCall.invoke(url,"");

          // Check to see if there is an error, return "N/A"

          if (soapResponse.generatedFault()) {

              Fault fault = soapResponse.getFault();

             String f = fault.getFaultString();

             return f;

          } else {

             // read result

             Parameter soapResult = soapResponse.getReturnValue ();

             // get a string from the result

             return soapResult.getValue().toString();

          }

       } catch (SOAPException se) {

          return se.getMessage();

       }

    }

}

3,使用wsdl2java把WSDL文件转成本地类，然后像本地类一样使用，即可。

这是像我这种懒人最喜欢的方式，仍然以前面的global weather report为例。

首先   java org.apache.axis.wsdl.WSDL2Java http://www.webservicex.net/globalweather.asmx.WSDL

原本的网址是http://www.webservicex.net/globalweather.asmx?WSDL，中间个各问号，但是Linux下面它不能解析，所以去掉问号，改为点号。

那么就会出现4个文件：

GlobalWeather.java  GlobalWeatherLocator.java  GlobalWeatherSoap.java  GlobalWeatherSoapStub.java其中GlobalWeatherSoap.java是我们最为关心的接口文件，如果你对RMI等SOAP实现的具体细节不感兴趣，那么你只需要看接口文件即可，在使用的时候，引入这个接口即可，就好像使用本地类一样。

 

注意：

Axis客户端程序编译时找不到包问题

首先，在这篇文章之前笔者有一篇关于Axis基本配置的文章《axis基本配置以及应用》大家可以先看看这篇文章再来看这篇文章，这篇文章是对上一篇文章的修改。该文章有部分问题，那就是关于在服务器端服务部署后，但是在客户端编译java文件时找不到包的情况。当你在服务器端服务部署成功后（具体看下面介绍，比较简单），接下来需要做的便是编写客户端测试程序。当用上篇文章给的测试程序wsTestClient.java，经常遇到找不到包的情况（如下所示）：

D:/java>javac wsTestClient.javawsTestClient.java:1: 软件包 org.apache.axis.client 不存在import org.apache.axis.client.Call;                             ^wsTestClient.java:2: 软件包 org.apache.axis.client 不存在import org.apache.axis.client.Service;                             ^wsTestClient.java:11: 找不到符号符号： 类 Service位置： 类 wsTestClient      Service service = new Service();      ^wsTestClient.java:11: 找不到符号符号： 类 Service位置： 类 wsTestClient      Service service = new Service();                            ^wsTestClient.java:12: 找不到符号符号： 类 Call位置： 类 wsTestClient      Call call = (Call)      ^wsTestClient.java:12: 找不到符号符号： 类 Call位置： 类 wsTestClient      Call call = (Call)                   ^6 错误

刚开始以为是环境配置有问题，按照下面的配置方法配置了一遍结果还是不能编译成功。AXISHOME,AXISLIB,AXISCLASSPATH，TOMCAT_HOME都已配置，包括下面所说的将tomcat的servlet.jar添加到系统classpath后面，结果还是不能编译总是报上面的错误。最后想起来在配置servlet时需要将servlet-api.jar commons-fileupload-1.2.jar commons-io-1.3.2.jar 从tomcat的lib文件夹下拷贝到C:/Program Files/Java/jdk1.6.0_03/jre/lib/ext文件夹下，于是将D:/Program Files/Apache Software Foundation/Tomcat 6.0/webapps/axis/WEB-INF/lib下的8个文件（如下）

axis.jaraxis-ant.jarcommons-discovery-0.2.jarcommons-logging-1.0.4.jarjaxrpc.jarlog4j-1.2.8.jarsaaj.jarwsdl4j-1.5.1.jar

拷贝到C:/Program Files/Java/jdk1.6.0_03/jre/lib/ext编译终于成功了！

附：jdk1.6.0_02/jre/lib/ext和jre1.6.0_02/lib/ext区别：（转自网上）

Jre是运行java程序的时候用的jdk是编译等高级工作的，并且包括了JRE中的所有文件。jre会自动配置系统路径，jdk不会，所以运行java程序的时候会调用jre里面的文件，而在用IDE编辑的时候调试和运行所调用的文件一般是JDK里面的文件。