Jersey构建Restful风格的webservices

最近一直在搞老项目的开发工作，很少写博文了。听了两位阿里巴巴大牛的讨论，决定试试用restful风格的webservices看看。

这里用的是Jersey这个框架，刚开始弄，有点麻烦，只能到处查资料。网上的资料也比较零碎，这里整理一下。

一.helloworld

需要三个包，这里从maven获取。

   <dependencies>

        <dependency>

            <groupId>com.sun.jersey</groupId>

            <artifactId>jersey-core</artifactId>

            <version>1.18</version>

        </dependency>

        <dependency>

            <groupId>com.sun.jersey</groupId>

            <artifactId>jersey-json</artifactId>

            <version>1.18</version>

        </dependency>

        <dependency>

        <groupId>com.sun.jersey</groupId>

        <artifactId>jersey-servlet</artifactId>

        <version>1.18</version>

    </dependency>

    </dependencies>

然后再web.xml中代码：

    <servlet>

        <servlet-name>Jersey REST Service</servlet-name>

        <servlet-class>

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

        </servlet-class>

        <init-param>

            <param-name>com.sun.jersey.config.property.packages</param-name>

            <param-value>hello.resource</param-value>

        </init-param>

        <load-on-startup>1</load-on-startup>

    </servlet>

    <servlet-mapping>

        <servlet-name>Jersey REST Service</servlet-name>

        <url-pattern>/rest/*</url-pattern>

    </servlet-mapping>

写一个资源类：

@Path("hello")

public class HelloResource {
    @GET
    @Produces(MediaType.TEXT_PLAIN)
    public String greed(){
        return "hello world";
    }

}

这样，访问:http://localhost:8080/rest/hello ,可以看到页面会输出：hello world

二.传递参数

在HelloResource这个类中，新加一个方法：

    @GET

    @Produces(MediaType.TEXT_PLAIN)

    @Path("{id}")

    public String sayHello(@PathParam("id")int id){

        return "hello jersey "+id;

    }

此时，访问：http://localhost:8080/rest/hello/123 ，页面会输出：

hello jersey 123

后面的123即是参数id的值。试了一下，如果再写一个一样的方法，把参数类型改成String类型，当输入参数类型不同的时候，会自动识别不同的方法。不过中文不可以直接跟在后面，会有乱码的情况。

我们一般传递参数的话，是采用?符来进行传参的。上面的方式看上去有点奇怪，不符合我们经常用的方式。

这里还有一种方式，适合我们的方式，不采用PathParam这个属性，采用QueryParam这个。

再写一个方法：

    @GET

       @Path("/param")

       @Produces("text/plain")

       public String sayHis(@QueryParam("param")String param){

        return "nice "+param;

    }

此时，访问：http://localhost:8080/rest/hello/param?param=work ，页面会输出：

nice work

这些算是一个基本入门，关于客户端使用等相关知识，在之后的博文中再写。

这里有一篇博文写的也不错：

http://my.oschina.net/mlongbo/blog/152548#OSC_h5_14

另附glassfish配置方式：

上面是用com.sun的包，还有一种是org.glassfish的包。

配置都差不多。

web.xml:

<?xml version="1.0" encoding="UTF-8"?>

<web-app xmlns="http://java.sun.com/xml/ns/javaee"

           xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

           xsi:schemaLocation="http://java.sun.com/xml/ns/javaee

          http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd"

           version="3.0">

    <servlet>

        <servlet-name>Jersey REST Service</servlet-name>

        <servlet-class>

            org.glassfish.jersey.servlet.ServletContainer

        </servlet-class>

        <init-param>

            <param-name>jersey.config.server.provider.packages</param-name>

            <param-value>hello.resource</param-value>

        </init-param>

        <load-on-startup>1</load-on-startup>

    </servlet>

    <servlet-mapping>

        <servlet-name>Jersey REST Service</servlet-name>

        <url-pattern>/rest/*</url-pattern>

    </servlet-mapping>

</web-app>

目前接触到的区别在于，用glassfish方式，配置后的json，不需要下载，浏览器即可显示出json内容。用sun的话，直接用json格式输出，需要下载打开才可以看到。不知道是不是也需要一些类似的配置。

需要的包：

    <dependencies>

        <dependency>

            <groupId>org.glassfish.jersey.containers</groupId>

            <!-- if your container implements Servlet API older than 3.0, use "jersey-container-servlet-core"  -->

            <artifactId>jersey-container-servlet</artifactId>

            <version>2.13</version>

        </dependency>

        <!-- Required only when you are using JAX-RS Client -->

        <dependency>

            <groupId>org.glassfish.jersey.core</groupId>

            <artifactId>jersey-client</artifactId>

            <version>2.13</version>

        </dependency>

    </dependencies>

巴特西

Jersey构建Restful风格的webservices

最新文章

热门文章