应用XFire开发WebService实例 xfire+myeclipse+weblogic 8

1. XFire介绍

XFire和Axis都是新一代的java web服务框架。XFire提供了非常方便的API，使用这些API可以开发面向服务(SOA)的程序。他比axis性能要高，支持各种标准，性能优良，基于低内存的STAX模型，也是其于流的XML。

• 支持多个重要的Web Service标准，包括SOAP、WSDL、WS-I Basic Profile、 WSAddressing、WS-Security等

• 高性能的SOAP栈

• 可选的绑定(binding)方式，如POJO、XMLBeansJAXB1.1、JAXB2.0、CastorJiBX等

• 支持JSR181 API

• 多种传输方式，如HTTP、JMS、XMPP、In－JVM等

• 灵活的接口

• 支持多个容器，如Spring、Pico

关于XFire就知道这么多，关于它的更祥细的资料或更深层次东西，就不去研究了，当然关于webservice的基本的知识还要学习的。作为技术人员不能光知其然，不知其所以然。(行了，又废话了)。

2. 准备

在开始介绍开发实例之前，你首先要准备工具有:eclipse、Myeclipse、weblogic8，当然你也可以自己下载最新xfire。http://repository.codehaus.org/org/codehaus/xfire/xfire-distribution/1.2.6/xfire-distribution-1.2.6.zip都准备好了 ，那就正式开工吧!

3. 开发

l  服务端

首先，eclipse新建一个webservice工程

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

工程名字就叫JuneService，web root、content root都为June

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

一路next后，点击”Finish”,会看到如下结构，有了工具就是好，什么东西都自己生成，那先看看WEB-INF/web.xml都生成了什么吧。。

 

 

 

 

 

 

 

 

 

 

 

 

<?xml version="1.0" encoding="UTF-8"?>

<web-app xmlns="http://java.sun.com/xml/ns/j2ee"

    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="2.4"

    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>

        <load-on-startup>0</load-on-startup>

    </servlet>

    <servlet-mapping>

        <servlet-name>XFireServlet</servlet-name>

        <url-pattern>/services/*</url-pattern>

    </servlet-mapping>

    <welcome-file-list>

        <welcome-file>index.jsp</welcome-file>

    </welcome-file-list>

</web-app>

在这个web.xml文件中定义了一个 XfireServlet，它负责提供Web Services，并提供

每个Web Service的WSDL。如果你发布了一个Web Service，比如叫JuneService，你

就可以通过网址http://<server_url[:port]>/<context>/ services/JuneService来访问这个Web Service，并且通过网址http://<server_url[:port]>/<context>/

services/BookService?WSDL得到这个Web Service的WSDL信息。

在源文件夹WEB-INF/src下新建一个java package：com.june,在这个package下新建一个接口JuneService,(往往很多文章在介绍某项技术怎么用时，都会用helloworld这个例子，这个例子确实应用广泛，不过，咱换一种例子，或都另一种方式的HelloWorld)

这个接口定义了只定义了一个addDate方法。这个方法要求传入一个整数的参数，返回类型为一个字符串，用来得到当的时间的加上n天以后的日期，也很简单吧。。

package com.june;

 

public interface JuneService {

    public String addDate(int d);

}

最写一个实现这个接口的类

package com.june;

 

import java.util.Calendar;

 

public class JuneServiceImpl implements JuneService {

 

    public String addDate(int d) {

        Calendar cal = Calendar.getInstance();

        cal.add(Calendar.DATE, d);

        SimpleDateFormat dateFormat = new SimpleDateFormat();

        dateFormat.applyPattern("yyyy年MM月dd日");

        return dateFormat.format(cal.getTime());

}

}

实现的很简单，就是加上天数后，直接tostring反回就可以了。

现在看来很简单吧，webserice的类跟普通的没有什么区别。好，继续吧。在WebServices目录下有一个services.xml文件，他就是用来发布你上面的这两个类做为webservice的，好，我们来配置一下这个文件。

<?xml version="1.0" encoding="UTF-8"?>

<beans xmlns="http://xfire.codehaus.org/config/1.0">

    <service>

        <name>HelloService</name>

        <namespace>http://services.june.come/JuneService</namespace>

        <serviceClass>

            com.june.JuneService

        </serviceClass>

        <implementationClass>

            com.june.JuneServiceImpl

        </implementationClass>

    </service>

</beans>

好了，services.xml配置好了，关于services.xml配置结构这里也不说明了，大家可以去查资料，这里能说明问题就行了，那我就开始发布我们的webservice吧!说明一点，如果使用的不是eclipse工具，你可能要手动装services.xml文件考到WEB-INF/classes/META-INF/xfire下面。但是myeclipe都不用你关心这些事情，它替你搞定。

那就先发布到weblogic上，启动服务。在地址里输入http://localhost:7001/June/services

就可以看到我们的服务了，可是这是在其它web容器，但是在weblogic8上就不行，会出现如下的错误：org.springframework.beans.factory.BeanDefinitionStoreException: Error registering bean with name 'xfire.typeMappingRegistry' defined in class path resource [org/codehaus/xfire/spring/xfire.xml]: Class that bean class [org.codehaus.xfire.aegis.type.DefaultTypeMappingRegistry] depends on not found; nested exception is java.lang.NoClassDefFoundError: null

这个问题是怎么会事，难道是配置错了，可是查来查去没有什么错误呀。那到google上找(真不知道现在程序员如果没有Google会是什么样？)，找了好长时间，终于在xfire的官网上找到相关的资料。如下：

XFire requires a newer version of the javax.xml.namespace.QName than is included in weblogic.jar. The QName jar can be found here

To override the weblogic.jar with your own QName.jar, your need to do the following:

Add the QName JAR file (qname.jar) into the WEB-INF/lib folder in your WAR file

Add a file weblogic.xml into the WEB-INF folder in your WAR file

Below is an example weblogic.xml file:

<!DOCTYPE weblogic-web-app PUBLIC

  "-//BEA Systems, Inc.//DTD Web Application 8.1//EN"

  "http://www.bea.com/servers/wls810/dtd/weblogic810-web-jar.dtd">

<weblogic-web-app>

  <container-descriptor>

    <prefer-web-inf-classes>true</prefer-web-inf-classes>

  </container-descriptor>

</weblogic-web-app>

The purpose of the weblogic.xml file is to tell WebLogic that the the WEB-INF/lib folder should take precedence over the global weblogic.jar file. This allows you to override the system classloader with your own application-specific JAR files.

The other solution is to put qname.jar at the beginning of WLS classpath in startweblogic batch file.

Qname.jar 下载地址：http://docs.codehaus.org/download/attachments/27836/qname.jar?version=1

原来发生错误原因，是因为weblogic.jar包的qname.jar太旧了，确切的说是 qname.class，好那就按照解决方法做，把qname.jar加到工程中，在weblogic server也加上qname.jar,还要在startweblogic.cmd的classpath里加放%WL_HOME%/server/lib/qname.jar,或是直接替换weblogic.jar里的qname.class，这样启动时就会用这个新包了。加入weblogic.xml就是要用户自己的jar先于系统的jar加载。好了，再重启一下服务。

再输入地址http://localhost:7001/June/services，好，终于看我们期盼已久的界面了。这样我们webservice服务就发布成功了。

l  客户端

有了服务端，那我们就应用一下，下面我们来做webservice的客户端。

首先建一个java application工程。就叫JuneClient吧，这个工程很简单，什么也没有，那我先建一下src源目录，并做为建我们的java package com.june,client来做为webservice的客户端。在工程上右键new->others选择webservice client.

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

然后，next按照提示来设置。

Wsdl url填写刚发布成功的webservice的地址http://localhost:7001/June/services/JuneService?wsdl

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

这一步next,我这里的eclipse会报web 服务描述语言有错误，直接finish就OK了

这样,myeclipse就会自动生成客户端所需要的程序，有了工具确实是很方便，这样确实提高了开发效率，但是也造成了许多程序员没有工具就不会写程序，工具一通搞定，具体里面的关系也不用管，我觉得程序员不光要会用工具，还要知道工具怎么来实现的，为什么要设置这一步，在没有工具情况下，我应该先从那做起，明白原理后，再利于工具，才能对你有所提高。才能提高对整个系统的整体把握。不光要知其然，还要知其所然，这才是搞技术应有的态度。(哎，又废话了)

既然，自动生成了客户端程序，我们就来测试一下我们的webservice。

package com.june.client;

 

import com.june.client.JuneServiceClient;

import com.june.client.JuneServicePortType;

public class JuneClientMain {

 

    public static void main(String[] args) {

        JuneServiceClient client = new JuneServiceClient();

        JuneServicePortType juneService = client.getJuneServiceHttpPort();

        // 调用服务

        String result = juneService.addDate(21);

        System.out.println(result);

    }

}

以上为通过webservice客户端调用web服务的一个例子，我调用webservice的addDate()方法，参数传入21，然后运行这个程序。也就是说通过webservice应该返回当前日期加上21天那天的日期是多少，结果是：2008年08月08日。正好是北京奥运会的日子，好日子呀，哈哈。。

好了，其实webservice在好多地方都可以布署，也可以在web应用下，也可以桌面应用，C++、C#、VB等等。只要你提供相应的WSDL，告诉调用者相应的接口方法，只需传入相应的参数，就能得到你想要的结果。

 

 

 

关键点：

l  XFire、myeclipse、

l  Weblogic8配置,qname.jar，startWebLogic.cmd

l  Web服务描述语言

l  Webservice客户端调用