Jersey RESTful WebService框架学习(一)

[size=large]介绍：RESTful (Representation State Transfer) 描述了一个架构样式的网络系统，比如 web 应用程序。它首次出现在 2000 年 Roy Fielding 的博士论文中，他是 HTTP 规范的主要编写者之一。RESTful 指的是一组架构约束条件和原则，满足这些约束条件和原则的应用程序或设计就是 RESTful。[/size]
[size=large]
正文：Jersey RESTful 框架是开源的RESTful框架, 实现了JAX-RS (JSR 311 & JSR 339) 规范。它扩展了JAX-RS 参考实现， 提供了更多的特性和工具， 可以进一步地简化 RESTful service 和 client 开发[/size]
[size=large]
[color=red]废话不多说，正式搭建一个helloworld[/size][/color]

[b][color=red][size=large]第一步：搭建框架所需jar包[/size][/color][/b]
[size=large]自己也看来网上一些博客给出的jar包都是Jersey 核心的一些，但是是缺少一些依赖包，新手照着demo很难搭建出来，除此之外还有一些依赖包，就不一一介绍了，附件中会给出项目压缩包。[/size]

[color=red][size=large]第二步：配置Jersey 的application[/size][/color]

public APIApplication() {
		// 加载资源文件，这里直接扫描com.lx.api下的所有api
		packages("com.lx.api");
		// 配置日志
		register(LoggingFilter.class);
		//.....
	}

[b][color=red][size=large]第三步：写一个api接口[/size][/color][/b]

package com.lx.api;

import javax.ws.rs.GET;
import javax.ws.rs.Path;
import javax.ws.rs.Produces;
import javax.ws.rs.core.MediaType;

@Path("/my")
public class TestAPI {
	@GET
	@Path("/first")
	@Produces({ MediaType.APPLICATION_JSON + ";charset=UTF-8" })
	public String my() {
		System.out.println("我的第一个jersey程序");
		return "{\"name\":\"1212\"}";
	}
}

[b][color=red][size=large]第四步：配置xml[/size][/color][/b]
[size=x-large]配置程序入口加载到jersey的org.glassfish.jersey.servlet.ServletContainer类即可
[/size]

<servlet>
		<servlet-name>api</servlet-name>
		<servlet-class>org.glassfish.jersey.servlet.ServletContainer</servlet-class>
		<init-param>
			<param-name>javax.ws.rs.Application</param-name>
			<param-value>com.lx.APIApplication</param-value>
		</init-param>
		<load-on-startup>1</load-on-startup>
	</servlet>
	<!--访问前缀  -->
	<servlet-mapping>
		<servlet-name>api</servlet-name>
		<url-pattern>/api/1.0/*</url-pattern>
	</servlet-mapping>

第五步：发布访问

[img]http://dl2.iteye.com/upload/attachment/0127/8611/8e347fb6-380f-3e11-af00-89b6a5b9ac77.png[/img]


[size=xx-large]本文还会继续更新：希望把自己用了一年多的jersey框架心得和总结分享出来。。。。。[/size]