REST WebService简单应用

longgangbai

浏览: 7338919 次
性别:
来自: 上海

最近访客更多访客>>

liuqibo861129

sdcharles

paladin1988

ljq867

博主相关

博客

微博

相册

留言

关于我

文章分类

社区版块

存档分类

博客分类：

WebService的开发应用

最近项目中WebService采用REST风格的WebService实现。

官方文档地址：

http://jersey.java.net/nonav/documentation/latest/index.html

Jersey的四种行为

对应我们日常说的CRUD.

方法/资源	资源集合; URI 如： http://host/api/resources	成员资源; URI 如： http://host/api /resources/123	对应的操作
POST	列出资源集合的所有成员。	检索标识为 1234 的资源的表示形式。	C（创建）
GET	使用一个集合更新（替换）另一个集合。	更新标记为 1234 的数字资源。	R（读取）
PUT	在集合中创建数字资源，其ID 是自动分配的。	在下面创建一个子资源。	U（更新）
DELETE	删除整个资源集合。	删除标记为 1234 的数字资源。	D（删除）

元注解信息说明

生存周期说明

1. 默认不使用注解，表示生存周期等于request，请求过后自动销毁，默认是线程安全的。

2. application，使用@Singleton注解。生存周期等于整个应用程序的生存周期。

3. session,使用@PerSession注解。生存周期等于一个session请求，session销毁，该rest资源实例也同时销毁。

Bean注解说明

1.@Path，路径信息，表示映射出去的访问路径。
范例如下：@Path("/myResource")

2. @Produces，用于限制post和get方法返回的参数类型，支持json、string、xml、html
范例如下：@Produces({"application/xml", "application/json"})

3. @Consumes，用于限制输入的参数的类型，支持json、string、xml、html
范例如下：@Consumes("text/plain")

4. @QueryParam，@DefaultValue，通过request传入的参数，@DefaultValue表示默认参数。
范例如下：@DefaultValue("2") @QueryParam("step") int step,

5. @PathParam ，@ MatrixParam，@ HeaderParam，@ CookieParam和@@ QueryParam FormParam听从以相同的规则。@ MatrixParam提取URL路径段的信息。 @ HeaderParam提取的HTTP头信息。 @ CookieParam提取信息的Cookie饼干宣布相关的HTTP标头。@ FormParam略有特殊，因为它提取请求表示，该类型匹配前面的@Consumes所声明的类型。
范例如下：

@POST

@Consumes("application/x-www-form-urlencoded")

public void post(@FormParam("name") String name) {

6.pojo层面等相关注解，@XmlRootElement,支持JPA注解。

7.Spring相关注解，比如@Autowired(required=true) 、@Qualifier("persionDao")、@Component

@Scope("request")

简单demo的结构如下：

简单的开发代码如下：

package com.easyway.jaxrs.rest;

import javax.ws.rs.GET;
import javax.ws.rs.Path;
import javax.ws.rs.Produces;
import javax.ws.rs.core.MediaType;
/**
 * 采用JAX-RS方式
 * @author longgangbai
 *  http://localhost:8080/JAXRSWS/services/hello
 *  
 *  
 *  @Path  注解访问的路径
 *  @GET   Http请求的方式
 *  @Produces  响应结果的形式
 *  
 */
@Path("/hello")  
public class HelloWS {

	/**
	 * 通过HTTP访问到WebService到方式
	 * 
	 * http://localhost:8080/JAXRSWS/services/hello
	 * 
	 * 文本格式返回给客户端
	 * @return
	 */
	@GET   
	@Produces(MediaType.TEXT_PLAIN)
	public String sayPlainTextHello() {
		return "Hello Jersey";
	}
	
	/**
	 * xml格式返回给客户端
	 * @return
	 */
	@GET
	@Produces(MediaType.TEXT_XML)
	public String sayXMLHello() {
		return "<?xml version=\"1.0\"?>" + "<hello> Hello Jersey" + "</hello>";
	}

	/**
	 * html格式的接受
	 * @return
	 */
	@GET
	@Produces(MediaType.TEXT_HTML)
	public String sayHtmlHello() {
		return "<html> " + "<title>" + "Hello Jersey" + "</title>"
				+ "<body><h1>" + "Hello Jersey" + "</body></h1>" + "</html> ";
	}

}

Web.xml配置如下：

<?xml version="1.0" encoding="UTF-8"?>
<web-app version="2.5" 
	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_2_5.xsd">
  <servlet>
  	<display-name>JAX-RS REST Servlet</display-name>
  	<servlet-name>JAX-RS REST Servlet</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>com.easyway.jaxrs.rest</param-value>
  	</init-param>
  	<load-on-startup>1</load-on-startup>
  </servlet>
  <servlet-mapping>
  	<servlet-name>JAX-RS REST Servlet</servlet-name>
  	<url-pattern>/services/*</url-pattern>
  </servlet-mapping>
  <welcome-file-list>
    <welcome-file>index.jsp</welcome-file>
  </welcome-file-list>
</web-app>

index.jsp页面如下：

<%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%>
<%
String path = request.getContextPath();
String basePath = request.getScheme()+"://"+request.getServerName()+":"+request.getServerPort()+path+"/";
%>

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
  <head>
    <base href="<%=basePath%>">
    
    <title>My JSP 'index.jsp' starting page</title>
	<meta http-equiv="pragma" content="no-cache">
	<meta http-equiv="cache-control" content="no-cache">
	<meta http-equiv="expires" content="0">    
	<meta http-equiv="keywords" content="keyword1,keyword2,keyword3">
	<meta http-equiv="description" content="This is my page">
	<script type="text/javascript" src="jquery/jquery-1.4.2.js"></script>
	<!--
	<link rel="stylesheet" type="text/css" href="styles.css">
	-->
	<script type="text/javascript">
	<!--js 调用JAXRS WS 服务返回文本-->
	function txtverity() {
	    $.ajax({
	        type : "POST",
	        url : "<%=request.getContextPath()%>/services/hello?tmp="+(new Date()),
	        dataType : "text",
	        success : textcallback
	    });
    }
	function textcallback(data) {
	   alert("text="+data);
	}
	
	
   function xmlverity() {
       alert("aa");
	    $.ajax({
	        type : "POST",
	        url : "<%=request.getContextPath()%>/services/sayXMLHello?tmp="+(new Date()),
	        dataType : "html",
	        success : xmlcallback
	    });
    }
   function xmlcallback(data) {
	   alert("text="+data);
	}
	</script>
  </head>
  
  <body>
  <input type="button" id="txtbtn"  onclick="txtverity()" value="文本" />
  <input type="button"  id="jsonbtn"   onclick="txtverity()" value="JSON文本"/>
  <input type="button" id="xmlbtn"   onclick="xmlverity()" value="XML文本"/>
  </body>
</html>

JAXRSWS.rar (8.8 MB)
下载次数: 126

分享到：

REST WebService简单应用（测试） | highcharts制作强大的页面图表

2011-11-27 15:07
浏览 3635
评论(0)
分类:编程语言
查看更多

发表评论

您还没有登录,请您登录后再发表评论

最近访客更多访客>>

博主相关

文章分类

社区版块

存档分类

最新评论