使用XFire+Spring构建Web Service（二）

在《使用XFire+Spring构建Web Service（一）——helloWorld篇》文中我们通过一个简单的XFire+Spring实例，该实例的sayHelloWorld()方法通过传入一个字符串参数来返回一个字符串，而实际的应用过程中，遇到的情况比这个要复杂得多，例如，传入参数是对象、返回自定义对象、返回数组、返回列表。下面让我们在此文中对XFire+Spring进行更深层的探讨吧。

一．             本例概述

在本例中，我们将在业务逻辑类是一个用户的业务逻辑类，包括创建用户、获取单个用户、获取用户数组、获取用户列表四个方法，因该文讲的是XFire+Spring构建webservice，所以在该例中我们并不涉及具体的数据库操作，而只是提供模拟实现。方法描述如下：

1） 创建用户方法：createUser(User user)

通过传入User对象作为参数来才创建用户；

2） 通过用户名获取用户信息方法：getUser(String loginName)

根据用户名获取某用户对象，该方法返回的是一个User对象；

3） 返回所有用户的数组方法：getUserArray()

返回为User数组；

4） 返回所有用户的列表的方法：getUserList()

返回为List对象，放入的对象为User类型。

二．             数据对象User.java

在上篇的例子中，src/webservice目录下新建example2目录，并在example2目录下建立User.java文件，下面看看数据对象User.java的内容，代码如下：

package webservice.example2;

import java.util.Date;

/** *//**
 *用户对象.  
 *@author<a href="mailto:xiexingxing1121@126.com">AmigoXie</a>
 *@version1.0
 *Creationdate:2007-9-28-上午10:42:44
 */
publicclass User implements java.io.Serializable {
    privatestaticfinallongserialVersionUID = 1L;

    /** *//**用户名*/
    private String loginName;

    /** *//**用户密码*/
    private String password;

    /** *//**手机号*/
    private String mobile;

    /** *//**创建时间*/
    private Date createTime;

    public Date getCreateTime() {
       return createTime;
    }

    public void setCreateTime(Date createTime) {
       this.createTime = createTime;
    }

    public String getLoginName() {
       return loginName;
    }

    public void setLoginName(String loginName) {
       this.loginName = loginName;
    }

    public String getMobile() {
       return mobile;
    }

    public void setMobile(String mobile) {
       this.mobile = mobile;

    }

    public String getPassword() {
       return password;
    }

    public void setPassword(String password) {
       this.password = password;
    }

    public String toString() {
       StringBuffer sb = new StringBuffer();
       sb.append("loginName=" + this.loginName);
       sb.append("|password=" + this.password);
       sb.append("|mobile=" + this.mobile);
       sb.append("|createDate=" + this.createTime);
       return sb.toString();
    }
}

 

三．             用户业务类UserService.java及其实现UserServiceImpl.java

 

下面让我们来看看本例的业务逻辑接口类UserService.java的内容：

package webservice.example2;

import java.util.List;

/** *//**
 *用户业务类.
 *@author<a href="mailto:xiexingxing1121@126.com">AmigoXie</a>
 *@version1.0
 *Creationdate:2007-9-28-上午10:37:09
 */
publicinterface UserService {
    /** *//**
     *获取用户对象.
     *@paramloginName用户名
     *@return返回用户对象
     */
    public User getUser(String loginName);

    /** *//**
     *创建用户.
     *@paramuser用户对象
     *@return返回创建的对象的toString()方法返回的内容
     */
    public String createUser(User user);

    /** *//**
     *获取用户信息数组.
     *@return返回用户信息数组
     */
    public User[] getUserArray();
    
    /** *//**
     *获得用户信息列表.
     *@return返回用户信息列表
     *@author<a href="mailto:xiexingxing1121@126.com">AmigoXie</a>
     *Creationdate:2007-9-28-下午12:55:37
     */
    public List<User> getUserList();
}

 

它的实现类UserServiceImpl.java的内容如下：

package webservice.example2;

import java.util.ArrayList;
import java.util.Date;
import java.util.List;

/** *//**
 *用户业务实现类.
 *@author<a href="mailto:xiexingxing1121@126.com">AmigoXie</a>
 *@version1.0
 *Creationdate:2007-9-28-上午10:54:11
 */
publicclass UserServiceImpl implements UserService {
    /** *//**
     *获取用户对象.
     *@paramloginName用户名
     *@return返回用户对象
     */
    public User getUser(String loginName) {
       User user = new User();
       user.setLoginName(loginName);
       user.setPassword("12345678");
       user.setMobile("13812345678");
       user.setCreateTime(new Date());
       return user;
    }

    /** *//**
     *创建用户.
     *@paramuser用户对象
     *@return返回创建的对象的toString()方法返回的内容
     */
    public String createUser(User user) {
       user.setCreateTime(new Date());
       return user.toString();
    }

    /** *//**
     *获取用户信息数组.
     *@return返回用户信息数组
     */
    public User[] getUserArray() {
       User[] userList = new User[4];
       userList[0] = getUser("阿蜜果");
       userList[1] = getUser("sterning");
       userList[2] = getUser("娟子");
       userList[3] = getUser("老肖");
       return userList;
    }

    /** *//**
     *获得用户信息列表.
     *@return返回用户信息列表
     *@author<a href="mailto:xiexingxing1121@126.com">AmigoXie</a>
     *Creationdate:2007-9-28-下午12:55:37
     */
    public List<User> getUserList() {
       List<User> userList = new ArrayList<User>();
       userList.add(getUser("阿蜜果"));
       userList.add(getUser("sterning"));
       userList.add(getUser("娟子"));
       userList.add(getUser("老肖"));
       return userList;
    }
}

 

注意：getUserList()方法返回的List中需要采用泛型，不然会部署失败。

到此为止，我们的业务已经完成，剩下的工作只是修改配置文件和编写测试类来进行测试。让我们继续往下走吧。

四．             配置文件applicationContext.xml和xfire-servlet.xml的修改

在本小节中，我们需要修改配置文件。首先在applicationContext.xml文件中添加用户逻辑bean的定义，添加的代码如下：

<bean id="UserBean" class="webservice.example2.UserServiceImpl"/>

接下来我们还需要修改xfire-servlet.xml文件来暴露我们的Web Service，修改后的该文件内容如下所示：

<entry key="/UserService.ws">                    

<ref bean="UserService" />                

</entry>

 

并添加如下bean的定义：

<bean id="UserService" parent="baseWebService">
       <!-- 业务服务bean -->
       <property name="serviceBean" ref="UserBean" />
       <!-- 业务服务bean的窄接口类 -->
       <property name="serviceClass" value="webservice.example2.UserService" />
    </bean>

  我们的Web Service已经开发完成，启动本项目后，可通过浏览器访问：http://localhost:8080/webservice_helloworld/UserService.ws?wsdl，我们可以在浏览器中看到该例的WSDL信息。

五．             Web Service测试

在本小节我们将对上述完成的Web Service进行测试，首先我们在src目录下的client.xml文件增加如下内容：

<!-- 获取用户信息的例子 -->
     <bean id="testUserWebService" class="org.codehaus.xfire.spring.remoting.XFireClientFactoryBean">
       <property name="serviceClass">              <value>webservice.example2.UserService</value> 
       </property>      
        <property name="wsdlDocumentUrl">         
<value>http://localhost:8080/webservice_helloworld/UserService.ws?wsdl</value>       
        </property>      
     </bean>

  接着我们在src/test目录下建立UserServiceClientTest.java类，编写测试代码如下：

 

package test;

import java.util.List;

import org.springframework.context.ApplicationContext;
import org.springframework.context.support.ClassPathXmlApplicationContext;

import webservice.example2.User;
import webservice.example2.UserService;

/** *//**
 * 用户业务测试类.    
 * @author <a href="mailto:xiexingxing1121@126.com">AmigoXie</a>
 * @version 1.0
 * Creation date: 2007-9-28 - 下午12:03:06
 */
public class UserServiceClientTest {
    public static void main(String[] args) throws Exception {
        UserServiceClientTest test = new UserServiceClientTest();
        test.testClient();
    } 
    
    public void testClient() throws Exception {
        ApplicationContext ctx = new ClassPathXmlApplicationContext(
                "client.xml");    
        UserService userService = (UserService) ctx.getBean("testUserWebService");
        
        //测试getUser()方法
        System.out.println("--------------getUser()------------");
        User user = userService.getUser("阿蜜果");
        System.out.println(user);
        
        //测试getArray()方法
        System.out.println("--------------getUserArray()------------");
        User[] userArray = userService.getUserArray();
        for (int i = 0; i < userArray.length; i++) {
            System.out.println("i=" + i + "|" + userArray[i]);
        }
        
        //测试createUser()方法
        System.out.println("--------------createUser()------------");
        User newUser = new User();
        newUser.setLoginName("离离");
        newUser.setPassword("123");
        newUser.setMobile("13666666666");
        String result = userService.createUser(newUser);
        System.out.println(result);
        
        //测试getUserList()方法
        List<User> userList = userService.getUserList();
        System.out.println("--------------getUserList()------------");
        for (int i = 0; i < userList.size(); i++) {
            System.out.println("i=" + i + "|" + userList.get(i));
        }
    }
}

 

over