Java WebService 简单实例

前言：朋友们开始以下教程前，请先看第五大点的注意事项，以避免不必要的重复操作。
一、准备工作（以下为本实例使用工具）
1、MyEclipse10.7.1
2、JDK 1.6.0_22
二、创建服务端
1、创建【Web Service Project】，命名为【TheService】。

2、创建【Class】类，命名为【ServiceHello】，位于【com.hyan.service】包下。


3、编写供客户端调用的方法，即编译方法代码。
image
4、进行编译
说明：编译失败的话，请将该项目引用的jdk设置为1.6.0_17版本或更高版本
image
image
5、测试结果
测试地址：http://localhost:9001/Service/ServiceHello?wsdl
image
三、生成客户端
1、创建【Web Service Project】，命名为【TheClient】。
image
image
image
2、命令提示窗口执行生成命令。
格式：wsimport -s "src目录" -p “生成类所在包名” -keep “wsdl发布地址”
示例：
wsimport -s G:\workspace\webService\TheClient\src -p com.hyan.client -keep http://localhost:9001/Service/ServiceHello?wsdl
说明：
1）"src目录"地址不可含空格
2）“wsdl发布地址”不要漏了“?wsdl”
image
3、刷新项目，检查生成类
image
image

四、最终测试
1、创建【Class】类，命名为【ServiceTest】，位于【com.hyan.test】包下。

image
image
image
2、编写测试方法，调用服务端方法，并打印返回的结果。
image
image
五、注意事项
1、JDK版本过低问题
报类似如下的异常：runtime modeler error: Wrapper class com.hyan.service.jaxws.GetValue is not found. Have you run APT to generate them?
image
原因：JDK版本低于1.6.0_17
解决方法：调整该服务端项目所引用的JDK版本为安装的高版本JDK
image
image
image
image
image
image
image
image
image
image
image
2、生成命令路径含空格问题
报类似如下的异常：directory not found: G:\SVN_FILE\GB\05
image
原因：客户端src路径不可含有空格
解决方法：在不含空格路径的文件夹下重新创建客户端即可。
3、生成命令不完整问题
报类似如下的异常：[ERROR] failed.noservice=Could not find wsdl:service in the provided WSDL(s):
image
原因：生成命令末尾缺少“?wsdl”
解决方法：补上即可。
错误不完整的命令示例：
wsimport -s G:\workspace\webService\TheClient\src -p com.hyan.client -keep http://localhost:9001/Service/ServiceHello
正确完整的命令示例：
wsimport -s G:\workspace\webService\TheClient\src -p com.hyan.client -keep http://localhost:9001/Service/ServiceHello?wsdl
六、示例源码
服务端源码 下载
客户端源码 下载

七、参考
1、真正的轻量级WebService框架——使用JAX-WS(JWS)发布WebService
2、 使用 CXF 做 webservice 简单例子
3、 WebService--CXF以及CXF与Spring的整合（jaxws:server形式配置）
4、WebService之CXF和Spring整合
5、 推荐--CXF和spring整合实现webservice实例
6、 Apache CXF 与 Spring 整合简单例子