用Java实现RESTful Web Services框架的简要步骤

1、         REST和RESTful Web Services的简要说明

REST(RepresentationalState Transfer)，中文称为表述性状态转移，是一种针对于网络应用开发的软件架构风格，是满足一定的架构约束条件的。REST包括的准则主要有：1）网络上所有事物都抽象成资源；2）每个资源对应唯一的URI；3）通过通用接口对资源操作；5）操作都是无状态的；

RESTfulWeb Services，这是基于REST和HTTP实现的Web服务，在其实现的时候定义了URI，对资源的操作，以及支持的MIME类型等。

2、         JAX-RS和Jersey的简要说明：

JAX-RS，或称JSR311，是帮助实现RESTful WebServices的一组API，而Jersey则是其参考实现。

3、         开发环境配置：

Eclipse: 需要能进行Web Service开发的版本，例如《Eclipse IDE forJava EE Developers》，官网的下载地址附在博客末尾；

Tomcat：Tomcat是作为Web应用程序的服务器而使用的，为了在本次开发中能正确开发并调试程序，需要在Eclipse上预先配置Tomcat，具体步骤给出了相关链接，不在博文内直接表述。Tomcat的下载版本也至于文末；

4、         Jersey开发包下载以及其它包下载：

为了开发RESTful Web服务，需要下载对应的Jersey库文件，同时在本程序中，由于需要采用JSON样式，需要额外下载部分jar包；所有需要的jar包的截图如下：

其中，Jersey相关库文件可从其官网下载，链接文末给出；其余jar包也一起打包置于lib.rar中。

5、         具体步骤：

步骤一：新建Eclipse工程：“File->New->Other->DynamicWeb Project”，此处将工程命名为Jersey，之后的配置大约如下，具体需要注意Target runtime需要指定为对应的Tomcat版本，例如此处是7.0；

步骤二：将刚才下载的全部jar包复制到工程目录下，WEB-INF文件夹下的lib中，如图所示；

步骤三：新建包用于存放所有资源，此处命名为sample.hello.resources,并新建类HelloResource（此资源仅用于测试，之后可以删除），代码如下：

package sample.hello.resources;
import javax.ws.rs.GET;
import javax.ws.rs.Path;
import javax.ws.rs.Produces;
import javax.ws.rs.core.MediaType;

@Path("/hello")
public class HelloResource {
	@GET
	@Produces(MediaType.TEXT_PLAIN)
	public String sayHello() {
		return "Hello Jersey";
	}
}

其中，@Path即定义了资源的URI，@Get即HTTP的Get方法，@Produces声明了相应内容的MIME类型；

步骤四：修改WEB-INF下的web.xml文件，内容改为：

   
   

   
   
  
    
    
     
     Jersey
    
    
  
    
    
    
     
     
      
      index.html
     
     
    
     
     
      
      index.htm
     
     
    
     
     
      
      index.jsp
     
     
    
     
     
      
      default.html
     
     
    
     
     
      
      default.htm
     
     
    
     
     
      
      default.jsp
     
     
  
    
    
  
    
    
  
     
     
      
      Jersey REST Service
     
     

     
     
      
      
  com.sun.jersey.spi.container.servlet.ServletContainer

     
     
  
     
     
    
      
      
       
       com.sun.jersey.config.property.packages
      
      
    
      
      
       
       sample.hello.resources
      
      
  
     
     
  
     
     
      
      1
     
     

    
    

    
    
  
     
     
      
      Jersey REST Service