使用XFire Spring构建Web Service(转)
http://www.dreamjava.com.cn/html/Spring/20070929/561.html
注：很多XFIRE的例子只是简单地讲HelloWorld，本文则是提供了一个操作具体类的例子，解决了初学者只能处理字符串的问题。
一．本例概述
在本例中，我们将在业务逻辑类是一个用户的业务逻辑类，包括创建用户、获取单个用户、获取用户数组、获取用户列表四个方法，因该文讲的是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));
}
}
}
大家可以运行该类，来查看运行效果。
注：很多XFIRE的例子只是简单地讲HelloWorld，本文则是提供了一个操作具体类的例子，解决了初学者只能处理字符串的问题。
一．本例概述
在本例中，我们将在业务逻辑类是一个用户的业务逻辑类，包括创建用户、获取单个用户、获取用户数组、获取用户列表四个方法，因该文讲的是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));
}
}
}
大家可以运行该类，来查看运行效果。
