使用axis2构建webservice
axis2是可以实现webservice的一个插件,使用这个插件可以发布webservice
1:可以使用这个插件来发布webservice,可以看网址:http://clq9761.iteye.com/blog/976029/======个人感觉一般不太适合我们做项目时候使用
2:我们这里将axis2的夹包引入到一个web工程里,运行这个web工程来发布webservice=====
这是我们常用的,比如要你写一个webservice客户端,你要怎么做呢?创建一个web工程,然后引入axis2的夹包,使用axis2来实现一个webservice,这是一个最基本的想法
想使用axis2实现webservice要做几件事如下:
1:创建一个web工程,====还可以说是创建一个web服务====或者是创建一个web项目
2:要引入需要的夹包到web工程的lib文件夹内
3:创建service.xml文件 =====axis2发布webservice需要配置的xml文件
4:配置web工程的web.xml,扫描axis2的service.xml文件
5:书写对应的类来实现
然后运行写好的web项目,在网页上执行路径就可以了,其实按着步骤走挺简单的,下面是每一步的详细介绍
第一步:创建一个web项目
第二步:引入需要的夹包
有个问题夹包从哪里来呢,去axis的官网下载
插件的下载网址:http://axis.apache.org/axis2/java/core/download.html
下载后解压。解压文件里有lib文件夹,里面有需要的所有的jar包
这里需要注意的是夹包的版本,在官网上下载的可能与本章中图片显示的不同,这个不用管,名字一样就行
如果不行再换,先试试 ===============这样我们就可以把所有需要的夹包复制到web项目的lib下
第三步:创建service.xml文件,看下图吧
在WEB-INF下创建services文件夹然后创建------conf----META-INF----services.xml
services.xml的内容如下:
=================services.xml内容开始=========================
<?xml version="1.0" encoding="UTF-8"?>
<service name="Testservice"> <!-- 指定服务名,随便定义 -->
<description>测试axis2webservices</description><!-- 服务的作用说明,可写可不写 -->
<!-- 指定要发布的类路径 -->
<parameter name="ServiceClass"> <!-- 自定义 name-->
com.axiswevservice.test.TestService <!-- 写的类路径 -->
</parameter>
<!-- 类里面的方法,有其他方法就在写个operation标签 -->
<operation name="test"> <!-- 类里面的方法名 -->
<messageReceiver class="org.apache.axis2.rpc.receivers.RPCMessageReceiver" />
</operation>
</service>
<!-- http://localhost:8080/testaxis2webservice/services/Testservice?wsdl -->
=================services.xml内容结束=========================
http://localhost:8080/testaxis2webservice/services/Testservice?wsdl
注释:上面的路径是搭建好web项目后要运行的wsdl路径
1: 指定服务名 =====就是要运行的wsdl路径的?和/之间的那一部分===可以说指定的服务名是wsdl路径的一部分
2:服务的作用说明====这个不用管===就相当于一个注释,说说你要发布的webservice是干啥的
3:指定要发布的类路径======就是你要把那个类做成webservice
4:类里面的方法,有其他方法就在写个operation标签=======配置你写的类里面的方法
第四步:配置web.xml
=================web.xml内容开始=========================
<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://java.sun.com/xml/ns/javaee" xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd" id="WebApp_ID" version="3.0">
<display-name>testaxis2webservice</display-name><!-- 项目名,创建项目时候自动生成的 -->
<welcome-file-list>
<welcome-file>index.jsp</welcome-file>
</welcome-file-list>
<servlet>
<servlet-name>AxisServlet</servlet-name>
<servlet-class>org.apache.axis2.transport.http.AxisServlet</servlet-class>
<load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
<servlet-name>AxisServlet</servlet-name>
<url-pattern>/services/*</url-pattern>
</servlet-mapping>
</web-app>
=================web.xml内容结束=========================
第五步:书写发布类
============================书写的类开始======================
package com.axiswevservice.test;
public class TestService {
public String test(String test){
return "测试axis2webservice:"+test;
}
}
==========================书写的类结束=========================
类写的简单点,现在只是测试没必要写复杂,就写一个类,类里写一个方法
写完这里之后,就要和上面的service.xml对应起来了,service.xml里面的类路径,方法名要和这里写的一样
写完之后就可以了,这是项目的结构图如下
在eclipce中加载tomcate,将项目加载到tomcate中,运行tomcate 启动项目
然后在网页上输入http://localhost:8080/testaxis2webservice/services/Testservice?wsdl
wsdl路径的组成:tomcate里配置的ip和端口号 + 项目名 + web.xml里配置的<url-pattern> + service.xml里面指定的服务名+?wsdl
运行结果如下:
这样就成功了,使用axis2来实现webservice服务端,这样在写个客户端调用就可以了
=====================================================================================
开始写客户端调用服务端写的接口通不通,
我们可以使用soupui这个软件来测试服务端,也可以自己写代码测试
这里我们自己写:要怎么做呢?很简单,需要做如下:
1:建个java工程 ------创建一个java工程
2:引入夹包
3:写个测试类
===========================开始==================================
第一步:创建一个java工程======就是创建一个java项目,我们的项目一般分为java项目,web项目,maven项目。。。。。。
第二步:引入夹包,夹包引入的方法和上面写服务端引入的一样,但是多了两夹包httpcore-4.4.4.jar,commons-codec-1.3.jar
这两个夹包在axis2的插件的lib下也可以找到
第三步:书写测试类
其实就是建个java项目,把写的web工程的夹包复制到java项目下,在从解了压的axis2插件的lib下把少的两个夹包加进来,写个类测一下就行了
======================测试类开始=======================
package testwebserver;
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.rpc.client.RPCServiceClient;
public class test {
public static void main(String[] args) {
try {
//本机tomcat端口默认为8081,参数是wsdl网址的一部分
EndpointReference targetEPR = new EndpointReference("http://localhost:8081/testaxis2webservice/services/Testservice");
RPCServiceClient sender = new RPCServiceClient();
Options options = sender.getOptions();
options.setTimeOutInMilliSeconds(2*20000L);//超时时间20s
options.setTo(targetEPR);
/**
* 参数:
* 1:在网页上执行 wsdl后xs:schema标签的targetNamespace路径
* <xs:schema targetNamespace="http://test.axiswevservice.com">
* 2:<xs:element name="test"> ======这个标签中name的值
*
*/
QName qname = new QName("http://test.axiswevservice.com", "test");
String str = "客户端调用成功"; //方法的入参
Object[] param = new Object[]{str};
Class<?>[] types = new Class[]{String.class}; //这是针对返值类型的
/**
* RPCServiceClient类的invokeBlocking方法调用了WebService中的方法。
* invokeBlocking方法有三个参数
* 第一个参数的类型是QName对象,表示要调用的方法名;
* 第二个参数表示要调用的WebService方法的参数值,参数类型为Object[];
* 第三个参数表示WebService方法的返回值类型的Class对象,参数类型为Class[]。
*
* 当方法没有参数时,invokeBlocking方法的第二个参数值不能是null,而要使用new Object[]{}。
*/
Object[] response1 = sender.invokeBlocking(qname, param, types);
System.out.println(response1[0]);
} catch (AxisFault e) {
// TODO Auto-generated catch block
e.printStackTrace();
}
}
}
======================测试类结束=========================
这是个java项目,直接写在main方法内,直接运行main方法就可以了,
注意:你这里写好的服务端得一直起着,这里写的测试调用才能调通,看下图:
总结:如果都测通了,我们要明白一下几点
1:axis2要实现webservice需要哪些夹包,夹包是哪里来的
需要哪些夹包看截图,夹包是从axis2的官网下的,官网有个.....bin.zip的文件,解压这个文件,里面有个lib文件夹,那里面有所有的夹包
2:怎么才能使用axis2发布一个webservice,
需要axis2的一个service.xml配置文件,我们要确保项目启动时要扫描到这个配置文件,并且要和写的类/方法等一致
那么程序就会将service.xml里面配置的类和方法做成一个webserce发布,
我们这里是将service.xml引入到了一个web工程里,使用web工程的web.xml来扫描service.xml文件,当运行这个web工程的时候 程序就将service.xml里面的配置的做成一个webservce服务发布了,只要这个web工程一直起着,我们就可以调用发布的服务
3:要发布的类,中的方法怎么写
方法有个返回值和入参就行,不管写方法在复杂,格式就是那样的
4:客户端怎么写的?
客户端就是写个java工程写个类测试下就行,夹包看上面截图,调用的代码要好好看看