一、AXIS调用远程WebService,以国内手机号归属地查询为例
1、wsdl地址:http://ws.webxml.com.cn/WebServices/MobileCodeWS.asmx?wsdl
2、导入依赖:
使用axis远程调用webService需要使用到axis、jaxrpc-api、commons-logging、commons-discovery等jar包。方便起见可以新建maven项目,在pom中导入依赖
<dependencies>
<dependency>
<groupId>org.apache.axis</groupId>
<artifactId>axis</artifactId>
<version>1.4</version>
</dependency>
<dependency>
<groupId>commons-discovery</groupId>
<artifactId>commons-discovery</artifactId>
<version>0.5</version>
<exclusions>
<exclusion>
<groupId>commons-logging</groupId>
<artifactId>commons-logging</artifactId>
</exclusion>
</exclusions>
</dependency>
<dependency>
<groupId>commons-logging</groupId>
<artifactId>commons-logging</artifactId>
<version>1.2</version>
</dependency>
<dependency>
<groupId>org.apache.axis</groupId>
<artifactId>axis-jaxrpc</artifactId>
<version>1.4</version>
</dependency>
<dependency>
<groupId>org.apache.axis</groupId>
<artifactId>axis-saaj</artifactId>
<version>1.4</version>
</dependency>
<dependency>
<groupId>wsdl4j</groupId>
<artifactId>wsdl4j</artifactId>
<version>1.6.3</version>
</dependency>
<dependency>
<groupId>commons-io</groupId>
<artifactId>commons-io</artifactId>
<version>2.11.0</version>
</dependency>
</dependencies>
3、调用有入参的webservice接口
阅读wsdl文件,我们可以了解方法名、参数和返回类型
<wsdl:operation name="getMobileCodeInfo">
<wsdl:documentation xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"><br /><h3>获得国内手机号码归属地省份、地区和手机卡类型信息</h3><p>输入参数:mobileCode = 字符串(手机号码,最少前7位数字),userID = 字符串(商业用户ID) 免费用户为空字符串;返回数据:字符串(手机号码:省份 城市 手机卡类型)。</p><br /></wsdl:documentation>
<wsdl:input message="tns:getMobileCodeInfoSoapIn"/>
<wsdl:output message="tns:getMobileCodeInfoSoapOut"/>
</wsdl:operation>
方法名为:getMobileCodeInfo
参数有两个:mobileCode手机号码,字符串类型;userID用户id,字符串类型(可以为空)
返回类型为字符串
Java调用代码
public static void getMobileCodeInfo() throws ServiceException, RemoteException {
Service service = new Service();
Call call = (Call) service.createCall();
// wsdl完整地址
call.setTargetEndpointAddress("http://ws.webxml.com.cn/WebServices/MobileCodeWS.asmx?wsdl");
/**
* 设置方法名
* new QName(String namespaceURI, String localPart) namespaceURI即为wsdl中的targetNamespace, localPart即为接口名
*/
call.setOperationName(new QName("http://WebXml.com.cn/", "getMobileCodeInfo"));
/**
* 添加参数
* addParameter方法的参数包括:参数名(namespace+参数名)、参数类型、ParameterMode(入参即为IN)
*/
call.addParameter(new QName("http://WebXml.com.cn/", "mobileCode"), XMLType.XSD_STRING, ParameterMode.IN);
call.setUseSOAPAction(true);
// SOAPActionURI格式为targetNamespace+方法名
call.setSOAPActionURI("http://WebXml.com.cn/getMobileCodeInfo");
// 指定返回值类型,为字符串
call.setReturnType(XMLType.XSD_STRING);
call.setReturnClass(java.lang.String.class);
String result = (String) call.invoke(new Object[]{"手机号码"});
System.out.println(result);
}
4、调用无参的webservice接口
调用无参的webservice接口无需添加参数,并且在invoke方法中传入的是一个空的对象数组
T result = (T)call.invoke(new Object[]{});
阅读wsdl文件,了解方法名、参数和返回类型
<wsdl:operation name="getDatabaseInfo">
<wsdl:documentation xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"><br /><h3>获得国内手机号码归属地数据库信息</h3><p>输入参数:无;返回数据:一维字符串数组(省份 城市 记录数量)。</p><br /></wsdl:documentation>
<wsdl:input message="tns:getDatabaseInfoSoapIn"/>
<wsdl:output message="tns:getDatabaseInfoSoapOut"/>
</wsdl:operation>
方法名:getDatabaseInfo,参数:无,返回类型:一维字符串数组
Java调用代码
public static void getDatabaseInfo() throws ServiceException, RemoteException {
Service service = new Service();
Call call = (Call) service.createCall();
call.setTargetEndpointAddress("http://ws.webxml.com.cn/WebServices/MobileCodeWS.asmx?wsdl"); //?wsdl
call.setOperationName(new QName("http://WebXml.com.cn/", "getDatabaseInfo"));
call.setUseSOAPAction(true);
call.setSOAPActionURI("http://WebXml.com.cn/getDatabaseInfo");
call.setReturnType(XMLType.XSD_UNSIGNEDBYTE);
call.setReturnClass(java.lang.String[].class);
String[] returnContext = (String[]) call.invoke(new Object[]{});
for (String s : returnContext) {
System.out.println(s);
}
}
二、使用wsimport方法将wsdl转换为Java接口
wsimport命令是JDK自带的命令,它能够根据服务端说明书(wsdl)生成对应的本地java代码。这种方法相较于第一种要简单很多,不用阅读wsdl文件。
wsimport -d <生成.class文件的目录> -s <生成.java文件的目录> -p<包名> <wsdl地址>
在D:\wsdl下新建文件夹class用于存放.class文件,文件夹java用于存放.java文件
D:\wsdl>wsimport -d class -s java -p mobileCode http://ws.webxml.com.cn/WebServices/MobileCodeWS.asmx?wsdl
执行命令,生成java代码
将Java文件拷贝至原先项目中
Java代码示例
import mobileCode.MobileCodeWS;
import mobileCode.MobileCodeWSSoap;
import java.util.List;
public class Main {
public static void main(String[] args) {
MobileCodeWS mobileCodeWS = new MobileCodeWS();
MobileCodeWSSoap soap = mobileCodeWS.getMobileCodeWSSoap();
String mobileCodeInfo = soap.getMobileCodeInfo("手机号码", null);
System.out.println(mobileCodeInfo);
List<String> dbInfo = soap.getDatabaseInfo().getString();
System.out.println(dbInfo);
}
}
wsimport生成的Java代码中自定义了一个ArrayOfString数据结构,用于接收webservice返回的字符串数组,用getString()方法可以将之转化为列表
package mobileCode;
import java.util.ArrayList;
import java.util.List;
import javax.xml.bind.annotation.XmlAccessType;
import javax.xml.bind.annotation.XmlAccessorType;
import javax.xml.bind.annotation.XmlElement;
import javax.xml.bind.annotation.XmlType;
@XmlAccessorType(XmlAccessType.FIELD)
@XmlType(name = "ArrayOfString", propOrder = {
"string"
})
public class ArrayOfString {
@XmlElement(nillable = true)
protected List<String> string;
public List<String> getString() {
if (string == null) {
string = new ArrayList<String>();
}
return this.string;
}
}