终于,使用Java完成了一个WebService的例子,其中的一个非常小的问题,折腾了我将近一天的时间。下面给出步骤,说明在Java平台上如何开发WebService。
采用的工具:Eclipse3.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:
XFireZhuweiTest
index.html
index.htm
index.jsp
default.html
default.htm
default.jsp
XFireServlet
org.codehaus.xfire.transport.http.XFireConfigurableServlet
XFireServlet
/servlet/XFireServlet
/*
XFireServlet
/services/*
web.xml中添加的servlet映射表明,所有匹配“/services/*”的url请求全部交给org.codehaus.xfire.transport.http.XFireConfigurableServlet来处理。
(5)编写需要发布为WebService的Java类,这个例子中是一个非常简单的MathService.java。
packagecom.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内容如下:
xmlversion
=
"
1.0
"
encoding
=
"
UTF-8
"
?>
<
beansxmlns
=
"
http://xfire.codehaus.org/config/1.0
"
>
<
service
>
<
name
>
MathService
name
>
<
namespace
>
http:
//
com.zhuweisky.xfireDemo/MathService
<
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)在Package Explorer中选中XFireZhuweiTest项目,右键->Run As ->Run On Server,关联到你机器上的TomCat,然后会启动Tomcat,以启动web服务。(注意,在进行此步骤之前,请先停止TomCat)
(10)测试刚发布的webService。我使用C#动态调用Web服务:
//
C#
string
url
=
"
http://localhost:8080/XFireZhuweiTest/services/MathService
"
;
object
[]args
=
{
1
,
2
};
object
result
=
ESFramework.WebService.WebServiceHelper.InvokeWebService(url,
"
Add
"
,args);
MessageBox.Show(result.ToString());
(关于C#动态调用Web服务,请参见
这里
)
执行后,弹出对话框,显示结果是3。