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

时间:2021-12-04 18:07:52

首先说一下使用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.java
wsTestClient.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,AXISCLASSPATHTOMCAT_HOME都已配置,包括下面所说的将tomcatservlet.jar添加到系统classpath后面,结果还是不能编译总是报上面的错误。最后想起来在配置servlet时需要将servlet-api.jar commons-fileupload-1.2.jar commons-io-1.3.2.jar tomcatlib文件夹下拷贝到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.jar
axis-ant.jar
commons-discovery-0.2.jar
commons-logging-1.0.4.jar
jaxrpc.jar
log4j-1.2.8.jar
saaj.jar
wsdl4j-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里面的文件。