本文主要是介绍Web Service漫游记(下)——RESTful,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!
在上一章节提到过,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));}
}
关于ws中REST的使用就介绍到这里。
如需要查看完整代码可以点击此处查看。
文章参考java point网站的web service及java实现REST部分,可点击此处
查看。
这篇关于Web Service漫游记(下)——RESTful的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!