axis2 webservice入门知识(JS,Java,PHP调用实例源码)

背景简介

最近接触到一个银行接口的案子，临时需要用到axis2webservice。自己现学现总结的一些东西，留给新手。少走弯路。

Axis2简介

①采用名为AXIOM（AXIsObjectModel）的新核心XML处理模型，利用新的XML解析器提供的灵活性按需构造对象模型。

②支持不同的消息交换模式。目前Axis2支持三种模式：In-Only、Robust-In和In-Out。In-Only消息交换模式只有SOAP请求，而不需要应答；Robust-In消息交换模式发送SOAP请求，只有在出错的情况下才返回应答；In-Out消息交换模式总是存在SOAP请求和应答。

③提供阻塞和非阻塞客户端API。

④支持内置的Web服务寻址(WS-Addressing)。

⑤灵活的数据绑定，可以选择直接使用AXIOM，使用与原来的Axis相似的简单数据绑定方法，或使用XMLBeans、JiBX或JAXB2.0等专用数据绑定框架。

⑥新的部署模型，支持热部署。

⑦支持HTTP，SMTP，JMS，TCP传输协议。

⑧支持REST(RepresentationalStateTransfer)。

测试环境

【jdk1.6.0】+【tomcat-6.0.18】+【axis2-1.6.1】+【PHPVersion5.3.5】

未测试最低支持配置。

环境准备

一、部署Axis2环境.

1.下载安装

apache官网下载地址：http://ws.apache.org/axis2/选择StandardBinaryDistribution和WARDistribution

2.配置系统环境变量：

①添加AXIS2_HOME变量并指向StandardBinaryDistribution解压目标目录。例如：$AXIS2_HOME$＝D:\axis2-1.6.1；

②将axis2.bat所在目录添加到系统环境变量path里。例如：将D:\axis2-1.6.1\bin添加到path现有值的最后面；

③将$AXIS2_HOME$\lib添加到系统环境变量classpath里。例如：将D:\axis2-1.6.1\lib添加到classpath现有值的最后面。

3.把WARDistribution解压到$tomcat_home$\webapps\axis2下(新建axis2文件夹)，当然你也可以参照axis2文档里列出的步骤使用ant创建一个axis2.war，放到$tomcat_home$\webapps下，然后启动tomcat，那么tomcat会在webapps下自动创建一个axis2文件夹。

二、测试Axis2环境.

1.访问http://localhost:[port]/axis2（请将[port]修改成你的Tomcat对应端口，默认为8080）；进入axis2的欢迎界面了。点击“Validate”。

如果有报错，则需根据错误信息检查上述步骤。如果没有错误信息，那么Axis2的环境测试算是通过了。

2.可以点击“Administration”并使用初始用户名和密码：admin；axis2登录，可以看到SystemComponents以及可以使用UploadServiceTools。部署新的arr文件了。另可去$tomcat_home$\webapps\axis2\WEB-INF\conf\axis2.xml下修改用户名和密码。

创建DemoHelloWorld

一、service端开发

1.创建一个java项目

2.新建类HelloWorld.java

参考代码：

packagesample;

importorg.apache.axiom.om.OMAbstractFactory;

importorg.apache.axiom.om.OMElement;

importorg.apache.axiom.om.OMFactory;

importorg.apache.axiom.om.OMNamespace;

publicclassHelloWorld{

publicOMElementsayHello(OMElementin){

Stringname=in.getText();

Stringinfo="你好"+name+",给你推荐http://www.sietoo.com";

OMFactoryfac=OMAbstractFactory.getOMFactory();

OMNamespaceomNs=fac.createOMNamespace("http://www.sietoo.com/","hw");

OMElementresp=fac.createOMElement("sayHelloResponse",omNs);

resp.setText(info);

returnresp;

}

}

3.新建文件META-INF\services.xml

参考代码：

<?xmlversion="1.0"encoding="UTF-8"?>

<servicename="HelloWorld">

<description>

ThisisasampleWebService.

</description>

<parametername="ServiceClass"locked="false">sample.HelloWorld</parameter>

<operationname="sayHello">

<messageReceiverclass="org.apache.axis2.receivers.RawXMLINOutMessageReceiver"/>

</operation>

</service>

二、项目打包并发布

1.可使用你熟悉的IDE进行打包成HelloWorld.aar

参考直接打包方式：

在命令符行境下，将当前目录切换到该项目包下。如博主的例子就需要切换到sample所在的文件夹，注意并非切换进sample。使用如下命令：jarcvfHelloWorld.aar.完成在当前目录生成HelloWorld.aar。请注意命令末尾的点“.”。

2.发布,使用前面提到的登录axis2后看到的UploadService工具将HelloWorld.arr部署到Tomc上。

3.发布测试,如博主例子访问http://localhost:8088/axis2/services/HelloWorld?wsdl查看第2步骤中部署的HelloWrold的描述文件。

如果有报错，则需根据错误信息检查上述步骤。如果没有错误信息，那么HelloWorld的service端就算完成了。

三、简单客户端调用

1.一个简单的Java调用客户端。

参考代码：

packageexample.client;

importorg.apache.axiom.om.OMAbstractFactory;

importorg.apache.axiom.om.OMElement;

importorg.apache.axiom.om.OMFactory;

importorg.apache.axiom.om.OMNamespace;

importorg.apache.axis2.addressing.EndpointReference;

importorg.apache.axis2.client.Options;

importorg.apache.axis2.client.ServiceClient;

publicclassTestClient{

privatestaticEndpointReferencetargetEPR=newEndpointReference

("http://localhost:8080/axis2/services/HelloWorld");

publicstaticOMElementgetSayHelloOMElement(){

OMFactoryfac=OMAbstractFactory.getOMFactory();

OMNamespaceomNs=fac.createOMNamespace("http://www.sietoo.com/","hw");

OMElementmethod=fac.createOMElement("sayHello",omNs);

method.setText("andy");

returnmethod;

}

publicstaticvoidmain(String[]args){

try{

Optionsoptions=newOptions();

options.setTo(targetEPR);

ServiceClientsender=newServiceClient();

sender.setOptions(options);

OMElementsayHello=TestClient.getSayHelloOMElement();

OMElementresult=sender.sendReceive(sayHello);

System.out.println(result);

}

catch(ExceptionaxisFault){

axisFault.printStackTrace();

}

}

}

编译此文件，并执行。

如果有报错，则需根据错误信息检查上述步骤。如果没有错误信息，那么DemoHelloWorld就完满完成。

各类客户端调用实例

一、java调用axis2webservice(包括单个参数和多个参数方法的调用)

参考代码：

packageexample.client;

importorg.apache.axiom.om.OMAbstractFactory;

importorg.apache.axiom.om.OMElement;

importorg.apache.axiom.om.OMFactory;

importorg.apache.axiom.om.OMNamespace;

importorg.apache.axis2.addressing.EndpointReference;

importorg.apache.axis2.client.Options;

importorg.apache.axis2.client.ServiceClient;

publicclasss2{

privatestaticEndpointReferencetargetEPR=newEndpointReference("http://www.sietoo.com/axis2/services/SVAMobileWebService");

publicstaticOMElementgetSayHelloOMElement(){

OMFactoryfac=OMAbstractFactory.getOMFactory();

OMNamespaceomNs=fac.createOMNamespace("http://www.sietoo.com","andy");

//测试调用bandMobileNo（多参数方法）

OMElementbandMobileNo=fac.createOMElement("bandMobileNo",omNs);

OMElementUserId=fac.createOMElement("UserId",omNs);

OMElementpassword=fac.createOMElement("password",omNs);

OMElementbindingBank=fac.createOMElement("bindingBank",omNs);

UserId.addChild(fac.createOMText(UserId,"18629078140"));

password.addChild(fac.createOMText(password,"mynewpassword"));

bindingBank.addChild(fac.createOMText(bindingBank,"622260062001991159"));

bandMobileNo.addChild(UserId);

bandMobileNo.addChild(password);

bandMobileNo.addChild(bindingBank);

returnbandMobileNo;

//测试调用getAccountInfo（单参数方法）

//OMElementgetAccountInfo=fac.createOMElement("getAccountInfo",omNs);

//OMElementaccountNum=fac.createOMElement("accountNum",omNs);

//accountNum.addChild(fac.createOMText(accountNum,"18629078140"));

//getAccountInfo.addChild(accountNum);

//returngetAccountInfo;

}

publicstaticvoidmain(Stringargs[]){

try{

Optionsoptions=newOptions();

options.setTo(targetEPR);

ServiceClientsender=newServiceClient();

sender.setOptions(options);

OMElementsayHello=s2.getSayHelloOMElement();

OMElementresult=sender.sendReceive(sayHello);

System.out.println(result);

}

catch(ExceptionaxisFault){

axisFault.printStackTrace();

}}}

二、PHP调用axis2webservice（包括调用多参数，但参数方法）

1.使用Soap调用(需要PHP的版本支持)

<?php

$wsdl='http://www.sietoo.com/axis2/services/SVAMobileWebService?wsdl';

$soap=newSoapClient($wsdl,array('trace'=>false,'cache_wsdl'=>WSDL_CACHE_NONE));

$soap=newSoapClient($wsdl);

$method="bandMobileNo";

if(isset($_POST['passwd'])&&isset($_POST['UserId'])&&isset($_POST['bindingBank'])){

$params=array('UserId'=>$_POST['UserId'],'password'=>$_POST['passwd'],'bindingBank'=>$_POST['bindingBank']);

try{

$result=$soap->$method($params);

echo$result->return;

echo'<br>';

}catch(SoapFault$e){echo$e->getMessage();}

}

?>

<html>

<head>

<title>bandMobileNo</title>

</head>

<body>

<formmethod="Post"action="">

tel.

<inputtype="text"name="UserId"value="18629078888"/>

pwd.

<inputtype="password"name="passwd"value="admin"/>

cardno.

<inputtype="text"name="bindingBank"value="622260062001991159"/>

<inputtype="submit"name="submit"value="Submit"/>

</form>

</body>

</html>

2使用Nusoap调用(需要下载nusoap.php附下载地址：http://download.csdn.net/detail/mr_z_andy/3845711)

分如下两种方式：

①直接调用

<?

/*************************************************************/

/*文件名:soapclient.php

/*说明:WebService接口客户端例程

/*作者：www.sietoo.com

/*************************************************************/

include('NuSoap.php');

//创建一个soapclient对象，参数是server的WSDL

$client=newsoapclient('http://localhost/Webservices/Service.asmx?WSDL','wsdl');

//参数转为数组形式传递

$aryPara=array('strUsername'=>'username','strPassword'=>MD5('password'));

//调用远程函数

$aryResult=$client->call('login',$aryPara);

//echo$client->debug_str;

/*

if(!$err=$client->getError()){

print_r($aryResult);

}else{

print"ERROR:$err";

}

*/

$document=$client->document;

echo<<<SoapDocument

<?xmlversion="1.0"encoding="GB2312"?>

<SOAP-ENV:EnvelopeSOAP-ENV:encodingstyle="http://schemas.xmlsoap.org/soap/encoding/"xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"xmlns:xsd="http://www.w3.org/2001/XMLSchema"xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/"xmlns:si="http://soapinterop.org/xsd">

<SOAP-ENV:Body>

$document

</SOAP-ENV:Body>

</SOAP-ENV:Envelope>

SoapDocument;

?>

②代理调用

<?

/*************************************************************/

/*文件名:soapclient.php

/*说明:WebService接口客户端例程

/*作者：www.sietoo.com

/*************************************************************/

require('NuSoap.php');

//创建一个soapclient对象，参数是server的WSDL

$client=newsoapclient('http://localhost/Webservices/Service.asmx?WSDL','wsdl');

//生成proxy类

$proxy=$client->getProxy();

//调用远程函数

$aryResult=$proxy->login('username',MD5('password'));

//echo$client->debug_str;

/*

if(!$err=$proxy->getError()){

print_r($aryResult);

}else{

print"ERROR:$err";

}

*/

$document=$proxy->document;

echo<<<SoapDocument

<?xmlversion="1.0"encoding="GB2312"?>

<SOAP-ENV:EnvelopeSOAP-ENV:encodingstyle="http://schemas.xmlsoap.org/soap/encoding/"xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"xmlns:xsd="http://www.w3.org/2001/XMLSchema"xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/"xmlns:si="http://soapinterop.org/xsd">

<SOAP-ENV:Body>

$document

</SOAP-ENV:Body>

</SOAP-ENV:Envelope>

SoapDocument;

?>

三、JS客户调用axis2webservice（包括调用多参数，但参数方法）

1实例①

<%@PageLanguage="C#"AutoEventWireup="true"CodeFile="Default3.aspx.cs"Inherits="Default3"%>

<!DOCTYPEhtmlPUBLIC"-//W3C//DTDXHTML1.0Transitional//EN""http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<htmlxmlns="http://www.w3.org/1999/xhtml">

<headrunat="server">

<title></title>

<scripttype="text/javascript">

functionRequestWebService(){

//这是我们在第一步中创建的Web服务的地址

varURL="http://localhost/YBWS/WebService.asmx";

//在这处我们拼接

vardata;

data='<?xmlversion="1.0"encoding="utf-8"?>';

data=data+'<soap12:Envelopexmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"xmlns:xsd="http://www.w3.org/2001/XMLSchema"xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">';

data=data+'<soap12:Body>';

data=data+'<HelloWorldxmlns="http://tempuri.org/"/>';

data=data+'</soap12:Body>';

data=data+'</soap12:Envelope>';

//创建异步对象

varxmlhttp=newActiveXObject("Microsoft.XMLHTTP");

xmlhttp.Open("POST",URL,false);

xmlhttp.SetRequestHeader("Content-Type","application/soap+xml");

xmlhttp.Send(data);

document.getElementById("data").innerHTML=xmlhttp.responseText;

}

</script>

</head>

<body>

<formid="form1"runat="server">

<div>

<inputid="One"type="button"value="JsCallWebService"onclick="RequestWebService()"/>

</div>

<divid="data">

</div>

</form>

</body>

</html>

2实例②Ajax直接调用，不推荐

下面仅贴出JS段代码，供参考。

varxmlHttp=null;

varbankno=null;

vartelno=null;

varcheckid=false;

functioncreateXMLHttpRequest(){

if(window.XMLHttpRequest){

//Firefox,Mozillar,Opera,Safari,IE7,IE8

xmlHttp=newXMLHttpRequest();

//Mozillar浏览器的BUG进行修正的

if(xmlHttp.overrideMimeType){

xmlHttp.overrideMimeType("text/html");

}

}elseif(window.ActiveXObject){

//针对IE的各种版本

varversions=['Microsoft.XMLHTTP','MSXML.XMLHTTP',

'Microsoft.XMLHTTP','Msxml2.XMLHTTP.7.0',

'Msxml2.XMLHTTP.6.0','Msxml2.XMLHTTP.5.0',

'Msxml2.XMLHTTP.4.0','MSXML2.XMLHTTP.3.0',

'MSXML2.XMLHTTP'];

//尝试创建XMLHttpRequest对象

for(vari=0;i<versions.length;i++){

try{

xmlHttp=newActiveXObject(versions[i]);

break;

}catch(e){

}

}

}

}

functionAsynRequest(){

createXMLHttpRequest();

if(xmlHttp==null)

{

alert("不能创建XmlHttpRequest对象");

return;

}

xmlHttp.open("GET","http://www.sietoo.com/axis2/services/demoService/doTest?Userid="+telno+"&bindingBank="+"&bindingBank="+bankno,false);

xmlHttp.setRequestHeader("Connection","close");

xmlHttp.onreadystatechange=function()

{

if(xmlHttp.readyState==4)

{

if(xmlHttp.status==200)

{

if(xmlHttp.responseXML==null)

{

return;

}

varres2=xmlHttp.responseXML.getElementsByTagName("ns:return")[0].firstChild.nodeValue;

//res2即为返回值。

return;

}

}

}

}

xmlHttp.send();

return;

}

欢迎更多讨论：andy#sietoo.com