环境:
Eclipse SDK
3.2.2
,
Tomcat5.5.20
,
XFire-1.2.6
。
首先建立一个动态 web 项目,命名为“ WSProject ”,将 xfire-distribution-1.2.6.zip(http://xfire.codehaus.org/Download) 解压缩后,把 xfire-all-1.2.6.jar 和 lib 目录下的所有 jar 包都拷贝到项目的 WebContent/WEB-INF/lib 目录下。编写一个用于发布的类文件 HelloService.java 。这里我用一个简单的类,它接受传来的 name 参数,返回 “ { name } ,你好!”。代码如下:
先说services.xml,它是对所有要发布的服务的描述文件,xfire就是依据这些信息来发布你的服务。这里针对我们刚才那个类建立services.xml。内容如下:
service 标签的子标签不止这两个,但其余的都是可选的。关于 services 的更多描述,请参阅 xfire 的官方网站。文件建好了,就是把它放到项目的哪个位置的问题了,这里我在项目的 WebContent/ META-INF 目录下面新建一个 xfire 文件夹,把 services.xml 文件放到这个新建文件夹里。最后再把 META-INF 文件夹整个移到 WebContent/ WEB-INF 目录下,这时 services.xml 文件的配置全部完成,如果我说的还不清楚,请直接看图一,图中左侧有文件结构,只要照那个结构调整项目中的文件及文件夹的位置就可以了。
注意,如果services.xml文件的放置位置不对,在用http://localhost:8080/WSProject/services/网址访问服务器时,会抛出下面的异常:
到这里第一部分的所有步骤已经完成,打开Tomcat,在服务器上运行这个动态web项目。输入网址http://localhost:8080/WSProject/services/HelloService?wsdl,如果正确发布,会得到如图一中显示的wsdl文档。
图一
以后要访问这个web服务的wsdl文件,只需要把Tomcat打开,然后输入上面的网址就可以了,这在第二部分创建客户端访问web服务时要用到。好了,web服务的发布就完成了。
首先建立一个动态 web 项目,命名为“ WSProject ”,将 xfire-distribution-1.2.6.zip(http://xfire.codehaus.org/Download) 解压缩后,把 xfire-all-1.2.6.jar 和 lib 目录下的所有 jar 包都拷贝到项目的 WebContent/WEB-INF/lib 目录下。编写一个用于发布的类文件 HelloService.java 。这里我用一个简单的类,它接受传来的 name 参数,返回 “ { name } ,你好!”。代码如下:
1
package
hao;
2
3 public class HelloService {
4 public String sayHello(String name){
5 return name+",你好!";
6 }
7}
8
下一步就是对
XML
文件的配置,这些配置非常关键,大多错误也出在这上面。2
3 public class HelloService {
4 public String sayHello(String name){
5 return name+",你好!";
6 }
7}
8
先说services.xml,它是对所有要发布的服务的描述文件,xfire就是依据这些信息来发布你的服务。这里针对我们刚才那个类建立services.xml。内容如下:
<?
xml version="1.0" encoding="UTF-8"
?>
< beans xmlns ="http://xfire.codehaus.org/config/1.0" >
< service >
< name > HelloService </ name >
< serviceClass > hao.HelloService </ serviceClass >
</ service >
</ beans >
< beans xmlns ="http://xfire.codehaus.org/config/1.0" >
< service >
< name > HelloService </ name >
< serviceClass > hao.HelloService </ serviceClass >
</ service >
</ beans >
service 标签的子标签不止这两个,但其余的都是可选的。关于 services 的更多描述,请参阅 xfire 的官方网站。文件建好了,就是把它放到项目的哪个位置的问题了,这里我在项目的 WebContent/ META-INF 目录下面新建一个 xfire 文件夹,把 services.xml 文件放到这个新建文件夹里。最后再把 META-INF 文件夹整个移到 WebContent/ WEB-INF 目录下,这时 services.xml 文件的配置全部完成,如果我说的还不清楚,请直接看图一,图中左侧有文件结构,只要照那个结构调整项目中的文件及文件夹的位置就可以了。
注意,如果services.xml文件的放置位置不对,在用http://localhost:8080/WSProject/services/网址访问服务器时,会抛出下面的异常:
Exception:
javax.servlet.ServletException: Error initializing XFireServlet.
root cause:
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
然后是web.xml文件,在项目已有的web.xml文件基础上修改一下就可以。修改后的最终内容如下:
<?
xml version="1.0" encoding="UTF-8"
?>
< web-app 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" >
< 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-app 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" >
< 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 >
到这里第一部分的所有步骤已经完成,打开Tomcat,在服务器上运行这个动态web项目。输入网址http://localhost:8080/WSProject/services/HelloService?wsdl,如果正确发布,会得到如图一中显示的wsdl文档。
图一
以后要访问这个web服务的wsdl文件,只需要把Tomcat打开,然后输入上面的网址就可以了,这在第二部分创建客户端访问web服务时要用到。好了,web服务的发布就完成了。