Spring调整CXF，发布RSETful 风格WebService-准备工作

Spring整合CXF，发布RSETful 风格WebService-准备工作

这篇文章是承接之前CXF整合Spring的这个项目示例的延伸，所以有很大一部分都是一样的。关于发布CXF WebServer和Spring整合CXF这里就不再多加赘述了。如果你对Spring整合CXF WebService不了解，具体你可以参看这两篇文章：

http://www.cnblogs.com/hoojo/archive/2011/03/30/1999563.html

http://www.cnblogs.com/hoojo/archive/2012/07/13/2590593.html

如果你不了解restful风格的WebService，你可以参考：

http://www.oracle.com/technetwork/articles/javase/index-137171.html

SpringMVC对RESTful的支持：

http://www.cnblogs.com/hoojo/archive/2011/06/10/2077422.html

使用 Jersey框架，搭建RESTful WebService（这个也比较简单）

http://www.ibm.com/developerworks/cn/web/wa-aj-tomcat/

官方文档：http://jersey.java.net/nonav/documentation/latest/user-guide.html#d4e8

其中，比较常用的RESTful框架就有Jersey、Spring REST、CXF RESTful，这些都可以很好的整合Spring框架，发布也相当的简单。且简单、易用、易上手，文档也比较丰富。

开发环境：

System：Windows

JavaEE Server：tomcat6

JavaSDK： jdk6+

IDE：eclipse、MyEclipse 6.6

 

开发依赖库：

JDK6、 JavaEE5、CXF-2.3.3、Spring 3.0.4

Email：hoojo_@126.com

Blog：http://blog.csdn.net/IBM_hoojo

http://hoojo.cnblogs.com/

http://hoojo.blogjava.net

下面我们就接着http://www.cnblogs.com/hoojo/archive/2011/03/30/1999563.html这篇文章，开始我们CXF RESTful WebService的旅程，enjoy~！^_*

准备工作

首先，你需要添加相关的jar包

其中，jsr331-api-1.1.1.jar是必须的，利用CXF发布REST服务得用到它，在cxf的lib库中可以找到这个jar。

下载地址：http://www.apache.org/dyn/closer.cgi?path=/cxf/2.3.11/apache-cxf-2.3.11.zip

其它的jar包都是非必须的！

JavaEntity

package com.hoo.entity;

import java.util.Map;

import javax.xml.bind.annotation.XmlRootElement;

/**

 * <b>function:</b> MapBean 封装Map集合元素

 * @author hoojo

 * @createDate 2012-7-20 下午01:22:31

 * @file MapBean.java

 * @package com.hoo.entity

 * @project CXFWebService

 * @blog http://blog.csdn.net/IBM_hoojo

 * @email hoojo_@126.com

 * @version 1.0

 */

@XmlRootElement

public class MapBean {

    private Map<String, User> map;

    //@XmlElement(type = User.class)

    public Map<String, User> getMap() {

        return map;

    }

    public void setMap(Map<String, User> map) {

        this.map = map;

    }

}

 

package com.hoo.entity;

import java.util.HashMap;

import java.util.List;

import javax.xml.bind.annotation.XmlRootElement;

/**

 * <b>function:</b> Users Entity

 * @author hoojo

 * @createDate 2011-3-18 上午09:27:31

 * @file Users.java

 * @package com.hoo.entity

 * @project CXFWebService

 * @blog http://blog.csdn.net/IBM_hoojo

 * @email hoojo_@126.com

 * @version 1.0

 */

@XmlRootElement(name = "UserInfos")

public class Users {

    private List<User> users;

    private User[] userArr;

    private HashMap<String, User> maps;

   // getter/setter

}

package com.hoo.entity;

import java.io.Serializable;

import javax.xml.bind.annotation.XmlRootElement;

/**

 * <b>function:</b>User Entity

 * @author hoojo

 * @createDate Dec 16, 2010 10:20:02 PM

 * @file User.java

 * @package com.hoo.entity

 * @project AxisWebService

 * @blog http://blog.csdn.net/IBM_hoojo

 * @email hoojo_@126.com

 * @version 1.0

 */

@XmlRootElement(name = "UserInfo")

public class User implements Serializable {

    private static final long serialVersionUID = 677484458789332877L;

    private int id;

    private String name;

    private String email;

    private String address;

    //getter/setter

    @Override

    public String toString() {

        return this.id + "#" + this.name + "#" + this.email + "#" + this.address;

    }

}

一、定义你的WebService的接口RESTSample.java，代码如下

package com.hoo.service;

import java.io.IOException;

import javax.servlet.http.HttpServletRequest;

import javax.servlet.http.HttpServletResponse;

import javax.ws.rs.Consumes;

import javax.ws.rs.DELETE;

import javax.ws.rs.GET;

import javax.ws.rs.POST;

import javax.ws.rs.PUT;

import javax.ws.rs.Path;

import javax.ws.rs.PathParam;

import javax.ws.rs.Produces;

import javax.ws.rs.core.Context;

import javax.ws.rs.core.MediaType;

import com.hoo.entity.MapBean;

import com.hoo.entity.User;

import com.hoo.entity.Users;

/*

     注释（Annotation）：在 javax.ws.rs.* 中定义，是 JAX-RS (JSR 311) 规范的一部分。 

    @Path：定义资源基 URI。由上下文根和主机名组成，资源标识符类似于 http://localhost:8080/RESTful/rest/hello。 

    @GET：这意味着以下方法可以响应 HTTP GET 方法。 

    @Produces：以纯文本方式定义响应内容 MIME 类型。

    @Context： 使用该注释注入上下文对象，比如 Request、Response、UriInfo、ServletContext 等。 

    @Path("{contact}")：这是 @Path 注释，与根路径 “/contacts” 结合形成子资源的 URI。 

    @PathParam("contact")：该注释将参数注入方法参数的路径，在本例中就是联系人 id。其他可用的注释有 @FormParam、@QueryParam 等。 

    @Produces：响应支持多个 MIME 类型。在本例和上一个示例中，APPLICATION/XML 将是默认的 MIME 类型。

 */

/**

 * <b>function:</b> CXF RESTful风格WebService

 * @author hoojo

 * @createDate 2012-7-20 下午01:23:04

 * @file RESTSampleSource.java

 * @package com.hoo.service

 * @project CXFWebService

 * @blog http://blog.csdn.net/IBM_hoojo

 * @email hoojo_@126.com

 * @version 1.0

 */

@Path(value = "/sample")

public interface RESTSample {

    @GET

    @Produces(MediaType.TEXT_PLAIN)

    public String doGet();

    @GET

    @Produces(MediaType.TEXT_PLAIN)

    @Path("/request/{param}")

    public String doRequest(@PathParam("param") String param, 

            @Context HttpServletRequest servletRequest, @Context HttpServletResponse servletResponse);

    @GET

    @Path("/bean/{id}")

    @Produces({ MediaType.APPLICATION_XML, MediaType.APPLICATION_JSON })

    public User getBean(@PathParam("id") int id);

    @GET

    @Path("/list")

    @Produces({ MediaType.APPLICATION_JSON, MediaType.APPLICATION_XML })

    public Users getList();

    @GET

    @Path("/map")

    @Produces({ MediaType.APPLICATION_XML, MediaType.APPLICATION_JSON })

    public MapBean getMap();

    /*

        @Consumes：声明该方法使用 HTML FORM。 

        @FormParam：注入该方法的 HTML 属性确定的表单输入。 

        @Response.created(uri).build()： 构建新的 URI 用于新创建的联系人（/contacts/{id}）并设置响应代码（201/created）。

        您可以使用 http://localhost:8080/Jersey/rest/contacts/<id> 访问新联系人

     */

    @POST

    @Path("/postData")

    public User postData(User user) throws IOException;

    @PUT

    @Path("/putData/{id}")

    @Consumes(MediaType.APPLICATION_XML)

    public User putData(@PathParam("id") int id, User user);

    @DELETE

    @Path("/removeData/{id}")

    public void deleteData(@PathParam("id") int id);

}

更多关系Spring的信息

 Spring 论坛  http://www.itchm.com/forum-59-1.html