一、Axis2的下载和安装
1.可从http://ws.apache.org/axis2/ 下载Axis2的最新版本:
可以下载如下三个zip包:
axis2-eclipse-service-plugin-1.7.1.zip
axis2-eclipse-codegen-plugin-1.7.1.zip
axis2-1.7.1-war.zip
前两个是eclipse的插件包,解压放到eclipse安装目录的dropins即可
重启eclipse可以看到
axis2-1.7.1-war.zip文件用于将WebService发布到Web容器中。解压下后将axis2.war放至tomcat安装目录下的webapps文件夹下,然后启动tomcat后,在webapps目录下会生成axis2文件夹。 访问http://localhost:8080/axis2/能看到以下页面表示axis2运行成功。
2 在Eclipse下新建Dtnamic Web Project,工程名:WebServiceServer(服务端)。新建包cn.test.webservice(包名小写,以免生成的java文件报错,后面的axis2自动生成的java文件包名都是小写,大写的包名生成java文件的包名都会变小写),在cn.test.webservice下新建IWebService
2:使用Axis2 代码生成器,完成WebService程序开发 (服务器端)根据接口生成 wsdl文件 (WebService 核心描述文件 )
选择项目,new other,选择axis2 的代码生成器,如图:
先用service接口生成wsdl文件,所以选择“从java代码生成wsdl文件”,点击【下一步】
填写类的名称,点击AddFolder 选择工作空间,项目下的bulid—>classes的目录,点击【测试类路径】显示成功!点击【下一步】
选择默认配置即可:
选择wsdl的输出路径,可以先放置到桌面
3:基于wsdl生成服务器代码。
选择项目,new other,选择axis2 的代码生成器,如图:
先用service接口生成wsdl文件,所以选择“从wsdl文件生成java代码”,点击【下一步】
选择wsdl文件的位置:如图:
选择代码选项为custom(自定义),并选择生成服务端代码和生成一个默认的services.xml文件,点击【下一步】。
选择输出路径,为项目的根路径,点击【结束】,刷新项目,即生成服务端代码。
服务端代码如图:
导入响应的jar包
把tomcat安装目录下的webapps/axis2/WEB-INF下的modules、service和conf文件拷至WebService下的WEB-INF目录下。同时把lib下jar包也拷到项目的lib包下(测试方便全部拷贝,实际开发有jar包冲突)。
拷贝webapps/axis2/WEB-INF/web.xml的servlet内容,放置到项目WebService的web.xml下 web.xml去掉出错的部分
<servlet>
<servlet-name>AxisServlet</servlet-name>
<servlet-class>org.apache.axis2.transport.http.AxisServlet</servlet-class>
<!--<init-param>-->
<!--<param-name>axis2.xml.path</param-name>-->
<!--<param-value>/WEB-INF/conf/axis2.xml</param-value>-->
<!--<param-name>axis2.xml.url</param-name>-->
<!--<param-value>http://localhost/myrepo/axis2.xml</param-value>-->
<!--<param-name>axis2.repository.path</param-name>-->
<!--<param-value>/WEB-INF</param-value>-->
<!--<param-name>axis2.repository.url</param-name>-->
<!--<param-value>http://localhost/myrepo</param-
<!--</init-param>-->
<load-on-startup>1</load-on-startup>
</servlet>
<servlet>
<servlet-name>AxisAdminServlet</servlet-name>
<servlet-class>
org.apache.axis2.webapp.AxisAdminServlet</servlet-class>
</servlet>
<!-- servlet>
<servlet-name>SOAPMonitorService</servlet-name>
<display-name>SOAPMonitorService</display-name>
<servlet-class>org.apache.axis2.soapmonitor.servlet.SOAPMonitorService</servlet-class>
<init-param>
<param-name>SOAPMonitorPort</param-name>
<param-value>5001</param-value>
</init-param>
<init-param>
<param-name>SOAPMonitorHostName</param-name>
<param-value>localhost</param-value>
</init-param>
<load-on-startup>1</load-on-startup>
</servlet -->
<servlet-mapping>
<servlet-name>AxisServlet</servlet-name>
<url-pattern>/servlet/AxisServlet</url-pattern>
</servlet-mapping>
<servlet-mapping>
<servlet-name>AxisServlet</servlet-name>
<url-pattern>*.jws</url-pattern>
</servlet-mapping>
<servlet-mapping>
<servlet-name>AxisServlet</servlet-name>
<url-pattern>/services/*</url-pattern>
</servlet-mapping>
<servlet-mapping>
<servlet-name>AxisAdminServlet</servlet-name>
<url-pattern>/axis2-admin/*</url-pattern>
</servlet-mapping>
将tomcat生成的axis2文件夹中的axis2-web文件放置到项目的WebContent的文件夹下。
4:服务端代码分析:
(1)ExtensionMapper:将实体类数据映射为XML文件
(2)GetScoreById:接口方法getScoreById的参数对象
(3) GetScoreByIdResponse:接口方法getScoreById的返回值对象
(4)IWebServiceMessageReceiverInOut 这个类,负责远程数据发送和接收
(5)IWebServiceSkeleton:服务器接口实现类,负责实现IWebService的接口IWebServiceSkeleton类,所有可以在该类上定义发布的方法,代码如下
5:WEB-INF/services下新建 test(可以是任何文件夹都可以)/META-INF路径,将生成的resources下的2个文件拷贝到 test/META-INF的文件夹下。例如:
5:启动tomcat后访问:
http://localhost:8080/WebService/services/IWebService.wsdl能看到服务信息了。 到此Axis2的WebService服务已成功发布。
其中IWebService是IWebService.wsdl中定义的<service name="IWebService">service的名称
注意:看懂webservice的使用说明书,记住要从下向上看。
Axis2客户端调用:
下面看看利用axis2客户端调用实例
第一步:客户端程序需要的jar包(为了测试方便全部拷贝axis2 lib下jar包也拷到项目的lib包下)
第二步:生成客户端代码
选择axis2的代码生成器,点击【下一步】
选择从wsdl文件生成java代码
选择桌面的services.wsdl文件
选择默认default,即生成客户端代码
选择客户端的程序目录,点击【完成】
选择项目,刷新,会生成客户端代码
jar包
客户端没有Skeleton类 (业务接口实现) ,多了 IWebSystemDDLServiceStub 客户端测试类
客户端程序,使用 IWebServiceStub.java来编写
在客户端的测试程序中使用:代码如下
ackage Test;
import java.rmi.RemoteException;
import cn.test.domain.xsd.Score;
import cn.test.webservice.GetScoreById;
import cn.test.webservice.GetScoreByIdResponse;
import cn.test.webservice.IWebServiceStub;
public class Test {
public static void main(String[] args) throws RemoteException {
/***调用网络服务axis调用webservice**/
IWebServiceStub iWebServiceStub = new IWebServiceStub("http://192.168.1.104:8080 /WebService/services/IWebService");
//传递参数
GetScoreById getScoreById = new GetScoreById();
getScoreById.setArgs0(1);
传递参数返回结果
GetScoreByIdResponse getScoreByIdResponse = iWebServiceStub.getScoreById(getScoreById);
Score[] get_return = getScoreByIdResponse.get_return();
for (int i = 0; i < get_return.length; i++) {
System.out.println("id:" +get_return[i].getId()+" score:"+get_return[i].getScore());
}
}
}