Web Service漫游记（下）——RESTful

最新推荐文章于 2019-09-28 09:28:11 发布

CloneableX

最新推荐文章于 2019-09-28 09:28:11 发布

阅读量122

点赞数

分类专栏：杂记文章标签： webservice REST

本文链接：https://blog.csdn.net/u011476390/article/details/89323174

版权

杂记专栏收录该内容

20 篇文章 0 订阅

订阅专栏

在上一章节提到过，Web Service（以下简称ws）除了SOAP之外还分为RESTful，RESTful全称REpresentation State Transfer（以下简称REST），与SOAP不同的是它不属于协议，RESTful只是一种风格。

REST因为定义较少的标准协议所以更加快速，也更加节省带宽和资源，同样REST也是支持跨平台和跨语言的，同时也可以支持基于SOAP的实现，与SOAP不同，REST不仅支持xml格式的数据，同时也支持JSON，HTML等格式的数据传输。

关于REST在java中的实现，其实javax.ws.rs包自带了支持REST的注解，先来了解一下几个主要的注解。

注解	描述
Path	服务地址的uri
GET	被注解的方法响应GET请求
Produces	定义响应的媒体类型，比如xml，html等

java中对于REST的实现需要依赖于jersey或者RESTeasy，主要讲一下jersey，接下来创建一个使用jersey实现REST的实例。

首先需要创建一个java web工程，创建一个ws REST服务类

@Path("/hello")
public class Hello {
    @GET
    @Produces(MediaType.TEXT_PLAIN)
    public String getHelloTxt() {
        return "Hello REST Txt";
    }

    @GET
    @Produces(MediaType.TEXT_HTML)
    public String getHelloHtml() {
        return "<html><title>Hello REST</title><body><h1>Welcome use REST</h1></body></html>";
    }

    @GET
    @Produces(MediaType.TEXT_XML)
    public String getHelloXml() {
        return "<?xml version=\"1.0\"?><hello>Hello REST</hello>";
    }
}

要使url地址能够访问到此服务类，需要在web.xml文件中进行jersey servlet的配置

<web-app>
  <servlet>
    <servlet-name>JerseyServlet</servlet-name>
    <servlet-class>org.glassfish.jersey.servlet.ServletContainer</servlet-class>
    <init-param>
      <param-name>jersey.config.server.provider.packages</param-name>
      <param-value>com.clo.ws.rest.server</param-value>
    </init-param>
    <load-on-startup>1</load-on-startup>
  </servlet>
  <servlet-mapping>
    <servlet-name>JerseyServlet</servlet-name>
    <url-pattern>/rest/*</url-pattern>
  </servlet-mapping>
</web-app>

其中init-param中jersey.config.server.provider.packages的参数值为自己创建的REST服务所在的包。

最后在页面中写入此服务的超链接用作点击请求服务

<html>
<body>
<a href="rest/hello">Click here</a>
</body>
</html>

使用tomcat启动，访问页面并点击超链接，会由服务的getHelloHtml方法响应，并返回一段html代码，浏览器会解析为html页面，甚至你可以自己创建一个客户端对相应的服务进行访问。

public class HelloClient {
    public static void main(String[] args) {
        ClientConfig config = new ClientConfig();
        Client client = ClientBuilder.newClient(config);
        WebTarget target = client.target(UriBuilder.fromUri("http://localhost:8080/webservice_rest").build());
        System.out.println(target.path("rest").path("hello").request().accept(MediaType.TEXT_PLAIN).get(String.class));
        System.out.println(target.path("rest").path("hello").request().accept(MediaType.TEXT_HTML).get(String.class));
        System.out.println(target.path("rest").path("hello").request().accept(MediaType.TEXT_XML).get(String.class));
    }
}