XFire+MyEclipse+Tomcat6.0 开发Webservice 中遇到问题及解决方案(初级)
2007-12-05 01:59
终于,使用Java 完成了一个WebService 的例子,其中的一个非常小的问题,折腾了我将近一天的时间。下面给出步骤,说明在Java 平台上如何开发WebService 。 采用的工具:Eclipse
3.1.2
+ Tomcat5.5 + XFire1.1 。使用XFire 开发WebService 应该说非常的容易,只需要按照下面例子的步骤来做: (1 )在Eclipse 中新建一个dynamic Web Project ,假设名为XFireZhuweiTest 。 (2 )导入XFire 用户库。该库中应包含xfire-1.1 目录下的xfire-all-1.1.jar 文件,以及xfire-1.1/lib 目录下的所有文件。 (3 )将上述的XFire 用户库中的所有文件拷贝到XFireZhuweiTest 项目的WebContent/WEB-INF/lib 目录下。 (4 )修改WebContent/WEB-INF/web.xml 配置文件的内容,下面是修改后web.xml :
<?xml version="1.0" encoding="UTF-8"?> <web-app id="WebApp_ID" version="2.4" xmlns="http://java.sun.com/xml/ns/j2ee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd"> <display-name> XFireZhuweiTest</display-name> <welcome-file-list> <welcome-file>index.html</welcome-file> <welcome-file>index.htm</welcome-file> <welcome-file>index.jsp</welcome-file> <welcome-file>default.html</welcome-file> <welcome-file>default.htm</welcome-file> <welcome-file>default.jsp</welcome-file> </welcome-file-list> <servlet> <servlet-name>XFireServlet</servlet-name> <servlet-class> org.codehaus.xfire.transport.http.XFireConfigurableServlet </servlet-class> </servlet> <servlet-mapping> <servlet-name>XFireServlet</servlet-name> <url-pattern>/servlet/XFireServlet/*</url-pattern> </servlet-mapping> <servlet-mapping> <servlet-name>XFireServlet</servlet-name> <url-pattern>/services/*</url-pattern> </servlet-mapping> </web-app>
web.xml 中添加的servlet 映射表明,所有匹配“/services/*” 的url 请求全部交给org.codehaus.xfire.transport.http.XFireConfigurableServlet 来处理。 (5 )编写需要发布为WebService 的Java 类,这个例子中是一个非常简单的MathService.java 。
package com.zhuweisky.xfireDemo; public class MathService { public int Add( int a , int b) { return a+b ; } }
(6 )在WebContent/META-INF 目录下新建xfire 文件夹 ,然后在xfire 目录下添加一个XFire 使用的配置文件services.xml ,该配置文件中的内容反映了要将哪些java 类发布为web 服务。本例中的services.xml 内容如下:
<?xml version="1.0" encoding="UTF-8"?> <beans xmlns="http://xfire.codehaus.org/config/1.0"> <service> <name>MathService</name> < namespace >http: //com.zhuweisky.xfireDemo/MathService</namespace> <serviceClass>com.zhuweisky.xfireDemo.MathService</serviceClass> </service> </beans>
XFire会借助Spring 来解析services.xml ,从中提取需要发布为WebService 的配置信息。 很多文章介绍到这里就完了,然而当我按照他们所说的启动WebService ,然后通过http://localhost:8080/XFireZhuweiTest/services/MathService?wsdl 来访问服务描述时,却抛出了异常,说services.xml 文件不存在-- “org.springframework.beans.factory.BeanDefinitionStoreException: IOException parsing XML document from class path resource [META-INF/xfire/services.xml]; nested exception is java.io.FileNotFoundException: class path resource [META-INF/xfire/services.xml] cannot be opened because it does not exist” 。 (7 )非常关键的一点,就是这个小难题花费了我将近一天的时间。 在WebContent/WEB-INF 目录下新建classes 文件夹,然后需要将WebContent 下的整个META-INF 文件夹剪切到新建的classes 文件夹下。 到这里,项目的完整目录结构如下:
(8 )在处理完这个问题后. 从新部署并运Tomcat. 但接着问题又来了错误内容如下:Unrecognized xbean element mapping: services in namespace http://xfire.codeh . 经过分析得出XFire1.26 需要xalan.jar 包的支持. 但它自身的Lib 下无此jar 。需要我们在apache 官方下载. 然后将此包放入工程的lib 下 (9 )再次从新编译运行. 本以为一切OK 了. 但还是出来问题java.lang.NoClassDefFoundError: org/apache/xml/serializer/TreeWalker 错误 这次通过在Apache 官方找到了出错误的原因: 原本这个类是包含在xalan.jar 中的,但是xalan-j
2.7.0
版的发布包中,将serializer 包中的类单独打包成serializer.jar ,不再包含在xalan.jar 中,所以才会即使添加了 xalan.jar 也无法找到该类,添加后即可解决问题 (10 )OK 。一切搞定在IE 中输入 http://localhost:8080/XFireZhuweiTest/services/MathService?wsdl 会得到正确的web 服务描述文档