初学webservice，使用axis2第一个例子

项目中需要使用webservice，所以抓紧时间研究了一下。

目前比较流行的webservice框架有axis2(1和2完全不同),xfire,CXF。

先试试axis2吧。从网上下了jar包和war包。

网上关于axis2发布websevice好像都是同一个例子，而且都是在tomcat

下手工单独发布的，所以自己就研究官方的war包吧。

中文资料少的可怜，英语还是很重要的，不然总是需要依赖谷歌翻译。

看看解压后的axis2。

axis2-web里面是jsp页面，所以从这里应该可以看到请求webservice的url怎么写的，

这个等下再看。

org里面是class文件，

接着看WEB-INF，这个很重要

web.xml,把里面的东西拷贝到自己工程的web.xml去。

内容就是配置了sevlet。

对应的services和modules也拷贝到工程的WEB-INF下。

conf，里面有个axis2.xml，这个也拷贝到WEB-INF下。

lib中的jar包当然是要拷贝的。

这样准备工作就算完成了。

关于axis2.xml，有个

<parameter name="hotdeployment">true</parameter> 热发布

<parameter name="hotupdate">false</parameter> 热更新

把热更新改成true，这样在不重启服务器的情况下，就可以发布webservice。

这个没试过，以后再研究吧

现在写一个测试的service吧。

package lsy.com;

public class HiGirl {

public String sayHi(String str){
return str+",你好";
}

public void goodfBye(String str){
System.out.println(str+"--bye");
}

}

这个类很简单，2个方法sayHi和goodfBye。

刷新一下工程，到workSpace找编译的class文件。

在services目录中有个例子version-1.6.2.arr,这个例子很好，参照它我们很轻松的可以写一个webservice。

解压后，有2个目录，一个META-INF，一个类的包名（里面是class文件）。

仿照这个结构，我也拷贝一个META-INF，类就是我刚才编译的HiGirl.class

，按照这个类建立它的包（一定要建立对应的包package lsy.com）；

然后打开META-INF下的services.xml，其他的文件不重要。

把其中的service改写成我们的。

<!--
~ Licensed to the Apache Software Foundation (ASF) under one
~ or more contributor license agreements. See the NOTICE file
~ distributed with this work for additional information
~ regarding copyright ownership. The ASF licenses this file
~ to you under the Apache License, Version 2.0 (the
~ "License"); you may not use this file except in compliance
~ with the License. You may obtain a copy of the License at
~
~ http://www.apache.org/licenses/LICENSE-2.0 ~
~ Unless required by applicable law or agreed to in writing,
~ software distributed under the License is distributed on an
~ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
~ KIND, either express or implied. See the License for the
~ specific language governing permissions and limitations
~ under the License.
-->

<service name="ServiceFirst">
<description>
first
</description>
<parameter name="ServiceClass">com.lsy.HiGirl</parameter>
<operation name="sayHi">
<messageReceiver  class="org.apache.axis2.rpc.receivers.RPCMessageReceiver" />
</operation>
</service>

service请求是ServiceFirst，

请求的方法是sayHi；消息接收类型是带参数有返回值的那种（org.apache.axis2.rpc.receivers.RPCMessageReceiver）

这个类型可以参照axis2.xml里面定义的。

改好后就要把这2个文件夹打包成aar。

怎么打包呢？eclipse有相关的插件，从axis官网apache也可以下载，目前我还未测试。

其实自己压缩成zip，然后重命名成aar文件就行。

这个压缩包名字随便起，没什么用，比如a.aar

然后把这个a.aar拷贝到WebContent/WEB-INF/services下，

重启工程，在地址栏输入

http://localhost:8080/AxisTest/services/listServices



这是axis2自带的servlet，可以返回目前可用的webservice列表

第二个ServletFirst就是我刚刚写的。

右键查看地址

http://localhost:8080/AxisTest/services/ServiceFirst?wsdl

返回：

<?xml version="1.0" encoding="UTF-8" ?>
- <wsdl:definitions xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/" xmlns:ns1="http://org.apache.axis2/xsd" xmlns:ns="http://lsy.com" xmlns:wsaw="http://www.w3.org/2006/05/addressing/wsdl" xmlns:http="http://schemas.xmlsoap.org/wsdl/http/" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:mime="http://schemas.xmlsoap.org/wsdl/mime/" xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/" xmlns:soap12="http://schemas.xmlsoap.org/wsdl/soap12/" targetNamespace="http://lsy.com">
<wsdl:documentation>ServiceFirst</wsdl:documentation>
- <wsdl:types>
- <xs:schema attributeFormDefault="qualified" elementFormDefault="qualified" targetNamespace="http://lsy.com">
- <xs:element name="sayHi">
- <xs:complexType>
- <xs:sequence>
<xs:element minOccurs="0" name="str" nillable="true" type="xs:string" />
</xs:sequence>
</xs:complexType>
</xs:element>
- <xs:element name="sayHiResponse">
- <xs:complexType>
- <xs:sequence>
<xs:element minOccurs="0" name="return" nillable="true" type="xs:string" />
</xs:sequence>
</xs:complexType>
</xs:element>
- <xs:element name="goodfBye">
- <xs:complexType>
- <xs:sequence>
<xs:element minOccurs="0" name="str" nillable="true" type="xs:string" />
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:schema>
</wsdl:types>
- <wsdl:message name="sayHiRequest">
<wsdl:part name="parameters" element="ns:sayHi" />
</wsdl:message>
- <wsdl:message name="sayHiResponse">
<wsdl:part name="parameters" element="ns:sayHiResponse" />
</wsdl:message>
- <wsdl:message name="goodfByeRequest">
<wsdl:part name="parameters" element="ns:goodfBye" />
</wsdl:message>
- <wsdl:portType name="ServiceFirstPortType">
- <wsdl:operation name="sayHi">
<wsdl:input message="ns:sayHiRequest" wsaw:Action="urn:sayHi" />
<wsdl:output message="ns:sayHiResponse" wsaw:Action="urn:sayHiResponse" />
</wsdl:operation>
- <wsdl:operation name="goodfBye">
<wsdl:input message="ns:goodfByeRequest" wsaw:Action="urn:goodfBye" />
</wsdl:operation>
</wsdl:portType>
- <wsdl:binding name="ServiceFirstSoap11Binding" type="ns:ServiceFirstPortType">
<soap:binding transport="http://schemas.xmlsoap.org/soap/http" style="document" />
- <wsdl:operation name="sayHi">
<soap:operation soapAction="urn:sayHi" style="document" />
- <wsdl:input>
<soap:body use="literal" />
</wsdl:input>
- <wsdl:output>
<soap:body use="literal" />
</wsdl:output>
</wsdl:operation>
- <wsdl:operation name="goodfBye">
<soap:operation soapAction="urn:goodfBye" style="document" />
- <wsdl:input>
<soap:body use="literal" />
</wsdl:input>
</wsdl:operation>
</wsdl:binding>
- <wsdl:binding name="ServiceFirstSoap12Binding" type="ns:ServiceFirstPortType">
<soap12:binding transport="http://schemas.xmlsoap.org/soap/http" style="document" />
- <wsdl:operation name="sayHi">
<soap12:operation soapAction="urn:sayHi" style="document" />
- <wsdl:input>
<soap12:body use="literal" />
</wsdl:input>
- <wsdl:output>
<soap12:body use="literal" />
</wsdl:output>
</wsdl:operation>
- <wsdl:operation name="goodfBye">
<soap12:operation soapAction="urn:goodfBye" style="document" />
- <wsdl:input>
<soap12:body use="literal" />
</wsdl:input>
</wsdl:operation>
</wsdl:binding>
- <wsdl:binding name="ServiceFirstHttpBinding" type="ns:ServiceFirstPortType">
<http:binding verb="POST" />
- <wsdl:operation name="sayHi">
<http:operation location="sayHi" />
- <wsdl:input>
<mime:content type="application/xml" part="parameters" />
</wsdl:input>
- <wsdl:output>
<mime:content type="application/xml" part="parameters" />
</wsdl:output>
</wsdl:operation>
- <wsdl:operation name="goodfBye">
<http:operation location="goodfBye" />
- <wsdl:input>
<mime:content type="application/xml" part="parameters" />
</wsdl:input>
</wsdl:operation>
</wsdl:binding>
- <wsdl:service name="ServiceFirst">
- <wsdl:port name="ServiceFirstHttpSoap11Endpoint" binding="ns:ServiceFirstSoap11Binding">
<soap:address location="http://localhost:8080/AxisTest/services/ServiceFirst.ServiceFirstHttpSoap11Endpoint/" />
</wsdl:port>
- <wsdl:port name="ServiceFirstHttpSoap12Endpoint" binding="ns:ServiceFirstSoap12Binding">
<soap12:address location="http://localhost:8080/AxisTest/services/ServiceFirst.ServiceFirstHttpSoap12Endpoint/" />
</wsdl:port>
- <wsdl:port name="ServiceFirstHttpEndpoint" binding="ns:ServiceFirstHttpBinding">
<http:address location="http://localhost:8080/AxisTest/services/ServiceFirst.ServiceFirstHttpEndpoint/" />
</wsdl:port>
</wsdl:service>
</wsdl:definitions>

从这里我们能看到一些信息，有一个targetNamespace="http://lsy.com

我的HiGirl.java的包名就是com.lsy

这就是我们在客户端QName是用到的参数。

查看内容还可以用这个方式：

http://localhost:8080/AxisTest/services/ServiceFirst?xsd

返回：

- <xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:ns="http://lsy.com" xmlns:ns1="http://org.apache.axis2/xsd" attributeFormDefault="qualified" elementFormDefault="qualified" targetNamespace="http://lsy.com">
- <xs:element name="sayHi">
- <xs:complexType>
- <xs:sequence>
<xs:element minOccurs="0" name="str" nillable="true" type="xs:string" />
</xs:sequence>
</xs:complexType>
</xs:element>
- <xs:element name="sayHiResponse">
- <xs:complexType>
- <xs:sequence>
<xs:element minOccurs="0" name="return" nillable="true" type="xs:string" />
</xs:sequence>
</xs:complexType>
</xs:element>
- <xs:element name="goodfBye">
- <xs:complexType>
- <xs:sequence>
<xs:element minOccurs="0" name="str" nillable="true" type="xs:string" />
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:schema>

url后面只是？后不一样，我想应该是访问的标准不一样吧。

wsdl是一种标准，xsd也是一种标准（个人这么觉的）。

无论哪种标准或格式，能把请求和返回说清楚，过程我们并不关心，怎么用才是重点。

里面无非说清楚了命名空间，方法，方法的参数及其类型，返回值及其类型。

axis2-web丽还有一个页面index.jsp

访问http://localhost:8080/AxisTest/axis2-web/index.jsp



这就是总的浏览页面，点击Service据进入刚才可用的Service列表页面。

所以说axis2-web这个jsp页面包还是有用的，web.xml里面配置的其他servlet我们最好也别注掉，

这样，我们测试更方便，有哪些可用的service，在页面就可以直接看出来，访问地址也

清楚明了。

我的第一个sayHi是有返回值的，访问以下

http://localhost:8080/AxisTest/services/ServiceFirst?sayHi

或者http://localhost:8080/AxisTest/services/ServiceFirst/sayHi

返回

- <ns:sayHiResponse xmlns:ns="http://lsy.com">
<ns:return>null,你好</ns:return>
</ns:sayHiResponse>

如果想要把参数传给webservice，地址这样写：

http://localhost:8080/AxisTest/services/ServiceFirst/sayHi?str=qq

参数名称就是你写的方法的参数名称，这个一旦写好，就固定了，例如

public String sayHi(String str){

return str+",你好";

}

这个参数叫str，在访问时也要用str。

返回：

- <ns:sayHiResponse xmlns:ns="http://lsy.com">
<ns:return>qq,你好</ns:return>
</ns:sayHiResponse>

这样wbservice就可以访问了，而webservice是为程序服务的，所以要在程序中写客户端访问代码。

ClientFirst.java

package com;

import javax.xml.namespace.QName;

import org.apache.axis2.AxisFault;
import org.apache.axis2.addressing.EndpointReference;
import org.apache.axis2.client.Options;
import org.apache.axis2.client.ServiceClient;
import org.apache.axis2.rpc.client.RPCServiceClient;

public class ClientFirst {

public static void main(String[] args) {
// 外接口返回值
String res = "";
try {
RPCServiceClient service = new RPCServiceClient();
Options o=service.getOptions();
String url="http://localhost:8080/AxisTest/services/ServiceFirst";
EndpointReference er=new EndpointReference(url);
o.setTo(er);

QName qn=new QName("http://lsy.com","sayHi");
Object[] param=new Object[]{"haha"};
Class[] retype=new Class[]{String.class};
Object result[]=service.invokeBlocking(qn, param, retype);

System.out.println("返回值是："+result[0].toString());
} catch (AxisFault e) {
// TODO Auto-generated catch block
e.printStackTrace();
}

}
}

要注意的就是引入的包，包名重复的类很多，写的时候一定要引对。

打印：

log4j:WARN No appenders could be found for logger (org.apache.axis2.context.AbstractContext).

log4j:WARN Please initialize the log4j system properly.

返回值是：haha,你好

这样就有返回值了。

这个工程结构如下：