RESTful WebService入门

RESTful WebService入门

 

RESTful WebService是比基于SOAP消息的WebService简单的多的一种轻量级Web服务，RESTful WebService是没有状态的，发布和调用都非常的轻松容易。

 

下面写一个最简单的Hello World例子，以便对RESTful WebService有个感性认识。因为非常专业理论化的描述RESTful WebService是一件理解起来很痛苦的事情。看看例子就知道个大概了，再看理论就容易理解多了。

 

/** 
* RESTful WebService入门 
* @author leizhimin 2009-11-18 16:42:43 
*/ 
package example; 

import com.sun.jersey.api.container.httpserver.HttpServerFactory; 
import com.sun.net.httpserver.HttpServer; 

import javax.ws.rs.GET; 
import javax.ws.rs.Path; 
import javax.ws.rs.Produces; 
import java.io.IOException; 

//指定URI 
@Path( "/helloworld") 
public  class HelloWorld { 
         //处理HTTP的GET请求 
        @GET 
         // 处理请求反馈的内容格式为"text/plain" 
        @Produces( "text/plain") 
         public String getClichedMessage() { 
                 return  "Hello World!"; 
        } 

         public  static  void main(String[] args)  throws IOException { 
                 //创建RESTful WebService服务 
                HttpServer server = HttpServerFactory.create( "http://192.168.14.117:9999/"); 
                //启动服务，这会导致新开一个线程 
                server.start(); 
                //输出服务的一些提示信息到控制台 
                System.out.println("RESTful WebService服务已经启动"); 
                System.out.println("服务访问地址: http://192.168.14.117:9999/helloworld"); 
        } 
}

 

运行这个类，控制台输入出：

2009-11-18 17:25:37 com.sun.jersey.api.core.ClasspathResourceConfig init 
信息: Scanning  for root resource and provider classes in the paths: 
    D:\jdk16\jre\lib\alt-rt.jar 
    D:\jdk16\jre\lib\charsets.jar 
    D:\jdk16\jre\lib\deploy.jar 
    D:\jdk16\jre\lib\javaws.jar 
    D:\jdk16\jre\lib\jce.jar 
    D:\jdk16\jre\lib\jsse.jar 
    D:\jdk16\jre\lib\management-agent.jar 
    D:\jdk16\jre\lib\plugin.jar 
    D:\jdk16\jre\lib\resources.jar 
    D:\jdk16\jre\lib\rt.jar 
    D:\jdk16\jre\lib\ext\dnsns.jar 
    D:\jdk16\jre\lib\ext\localedata.jar 
    D:\jdk16\jre\lib\ext\sunjce_provider.jar 
    D:\jdk16\jre\lib\ext\sunmscapi.jar 
    D:\jdk16\jre\lib\ext\sunpkcs11.jar 
    D:\netwideo\restws\out\production\restws 
    D:\IDEA8\lib\javaee.jar 
    D:\netwideo\restws\lib\mail-1.4.jar 
    D:\netwideo\restws\lib\asm-3.1.jar 
    D:\netwideo\restws\lib\wadl2java.jar 
    D:\netwideo\restws\lib\jettison-1.0.1.jar 
    D:\netwideo\restws\lib\grizzly-servlet-webserver-1.8.6.4.jar 
    D:\netwideo\restws\lib\wadl-core.jar 
    D:\netwideo\restws\lib\localizer.jar 
    D:\netwideo\restws\lib\jdom-1.0.jar 
    D:\netwideo\restws\lib\jsr311-api-1.0.jar 
    D:\netwideo\restws\lib\stax-api-1.0-2.jar 
    D:\netwideo\restws\lib\persistence-api-1.0.2.jar 
    D:\netwideo\restws\lib\jaxb-api-2.1.jar 
    D:\netwideo\restws\lib\wadl-cmdline.jar 
    D:\netwideo\restws\lib\http-20070405.jar 
    D:\netwideo\restws\lib\rome-0.9.jar 
    D:\netwideo\restws\lib\activation-1.1.jar 
    D:\netwideo\restws\lib\jaxb-impl-2.1.10.jar 
    D:\netwideo\restws\lib\jersey-bundle-1.0.3.jar 
    D:\netwideo\restws\lib\jackson-lgpl-0.9.4.jar 
    D:\netwideo\restws\lib\FastInfoset-1.2.2.jar 
    D:\netwideo\restws\lib\jaxb-xjc.jar 
    D:\IDEA8\lib\idea_rt.jar 
2009-11-18 17:25:46 com.sun.jersey.api.core.ClasspathResourceConfig init 
信息: Root resource classes found: 
     class example.HelloWorld 
2009-11-18 17:25:46 com.sun.jersey.api.core.ClasspathResourceConfig init 
信息: Provider classes found: 
RESTful WebService服务已经启动 
服务访问地址:  http://192.168.14.117:9999/helloworld

 

可见，服务启动成功了，下来就是从浏览器中访问服务了，输入 http://192.168.14.117:9999/helloworld，将发送一个HTTP GET请求，看看结果：

 

 

测试成功了！

 

--------------------

这个项目以来很多的包，有些事sun的，有些不是，这里我全放出来，整个项目放到附件中，在jdk5、6下运行都可以。

 

很遗憾，附件最大能上传6M的东西，这个超过6M了，只能等待51cto能放宽上传文件的大小。每个限制在10M以内最好了。----希望：），这里我列出所用的包吧：

activation-1.1.jar 
asm-3.1.jar 
FastInfoset-1.2.2.jar 
grizzly-servlet-webserver-1.8.6.4.jar 
http-20070405.jar 
jackson-lgpl-0.9.4.jar 
jaxb-api-2.1.jar 
jaxb-impl-2.1.10.jar 
jaxb-xjc.jar 
jdom-1.0.jar 
jersey-bundle-1.0.3.jar 
jettison-1.0.1.jar 
jsr311-api-1.0.jar 
mail-1.4.jar 
localizer.jar 
persistence-api-1.0.2.jar 
rome-0.9.jar 
stax-api-1.0-2.jar 
wadl-core.jar 
wadl-cmdline.jar 
wadl2java.jar