初学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,你好
这样就有返回值了。
这个工程结构如下：
