1. 从官网apache.org上下载:
axis2-1.6.2-war.zip成功解压后,把包含的axis2.war包放置TomCat的webapps目录下即可,然后启动TomCact(本文所使用的Web容器)输入:http://IP:PORT/axis2/即表示Axis2安装成功。
2. 编写与发布属于你的第一个0配置的Service服务
既然都已经成功安装好Axis2了,接下来我们要做的事情就是开始编写及发布我们的Service服务了,打开你的eclipse,新建一个工程,然后随便写个POJO
public class Myservice {
public String getName() {
return "My Webservice Axis2";
}
}
仅仅只是包含一个简单的返回值为String的getName()方法,没错,就这么简单。接下来如何将这个简单的方法发不成WebService方法呢???这其实不难,你只需要将该源文件的字节码(.class)文件拷贝至<TomCat安装目录>\webapps\axis2\WEB-INF\POJO中即可(如果没有POJO目录则自己新建)。
当发布成功后,我们可以打开浏览器输入http://localhost:8888/axis2/services/listServices便可以看见我们发布的Service方法了:
注意看,Service的名称就是咱们的类名,而该Service中所包含的方法就是咱们的getName()方法。
通过点击Service名称连接,你可以查看详细的WSDL文件,那么什么是WSDL呢???简单来说WSDL(Web Services Description Language),是一个用来描述Web服务和说明如何与Web服务通信的XML语言。我们可以在WSDL文件中来测试我们发布的Service方法,输入http://localhost:8888/axis2/services/MyService/getName:
3. 如果pojo带包了,就不要放在POJO目录下了
想要将带包的POJO顺利发布成Service,那么必不可少的条件就是需要services.xml文件,因为该文件描绘了包与类的关系结构。
你首先需要在工程目录下新建一个\META-INF\文件夹,然后新建一个service.xml文件即可。
- <span style="font-size: small;"><?xml version="1.0" encoding="UTF-8"?>
- <!-- Service名称 -->
- <service name="myService">
- <!-- Service描述 -->
- <description>
- 登陆效验Service
- </description>
- <!-- 描绘包与类的关系结构 -->
- <parameter name="ServiceClass">
- org.johngao.service.LoginValidate
- </parameter>
- <!-- 定义方法处理器 -->
- <messageReceivers>
- <messageReceiver mep="http://www.w3.org/2004/08/wsdl/in-out"
- class="org.apache.axis2.rpc.receivers.RPCMessageReceiver" />
- <messageReceiver mep="http://www.w3.org/2004/08/wsdl/in-only"
- class="org.apache.axis2.rpc.receivers.RPCInOnlyMessageReceiver" />
- </messageReceivers>
- </service></span>
如果你在services.xml文件中需要发布多个Service,那么你可以使用<serviceGroup/>标签:
- <span style="font-size: small;"><serviceGroup>
- <service>
- <!-- 第一个Service -->
- </service>
- <service>
- <!-- 第二个Service -->
- </service>
- </serviceGroup></span>
接下来要做的事情就是你最期待的,那便是将带包的POJO发布成Service进行调用。当然你选择使用service.xml文件的形式发布Service,首先则必须将项目打包成".aar"文件(也就是".jar")。你可以先将项目打包成jar,然后再将文件后缀改变为aar即可,当然不改也行,只是为了遵循Axis2的规范,笔者还是建议你将文件后缀改成aar。
这里笔者需要提醒你的是,在将项目打包时,你只需要选择\META-INFA\service.xml即可,字节码文件不需要一起打包:
接下来我们需要将打包好的aar文件放置在\axis2\WEB-INF\services\目录下。当然这样还并没有结束,你还需要将项目的字节码文件放置在\axis2\WEB-INF\classes\目录下,或者以jar包的形式放置在\axis2\WEB-INF\lib\目录下都可以。当然笔者还是选择将字节码文件放置在classes目录下。
启动你的Web容器,输入http://ip:port/axis2/services/listServices进行访问: