moonranger

这是小弟第一次在论坛中发贴，之前一直在论坛潜水，一心看大牛们的文章，希望这文章不会招来牛牛们的鄙视，谢谢

我这个小框架的灵感来源于http://www.ibm.com/developerworks/cn/xml/x-restfulsoa/index.html，目前唯一的功能就是实现REST风格的URL映射以及不同的HTTP方法（GET，POST，PUT和DELETE）对资源类的方法的映射，框架的使用很简单。

一.实现REST接口，接口定义为

public interface RESTResource
{
	public void init();

	public void create(Map<String, String> params, HttpServletRequest request,
			HttpServletResponse response);

	public void get(Map<String, String> params, HttpServletRequest request,
			HttpServletResponse response);

	public void update(Map<String, String> params, HttpServletRequest request,
			HttpServletResponse response);

	public void delete(Map<String, String> params, HttpServletRequest request,
			HttpServletResponse response);
}

为了简单起见，目前仅仅采用了最简单的形式，和一个Servlet差不多，其中第一个参数params中存放了从URL中提取的参数名和值。
实际使用时可以继承AbstractRESTResource抽象类，这样就可以只覆盖自己需要的方法了。

二.添加URL映射规则的Annotation

@URLMapping("/blog/{blog_id}/comment/{comment_id}")
public class BlogComment extends AbstractRESTResource
{
	@Override
	public void get(Map<String, String> params, HttpServletRequest request,
			HttpServletResponse response)
	{
		try
		{
			PrintWriter out = response.getWriter();
			out.println("<h2>Comment(id:" + params.get("comment_id") + ") of blog(id:"
					+ params.get("blog_id") + ")</h2>");
		}
		catch (IOException e)
		{
			e.printStackTrace();
		}
	}

}

其中用“{}”来定义参数，比如上面代码中的注解“/blog/{blog_id}/comment/{comment_id}”里的blog_id和comment_id就是一个参数，匹配实际URL中的这一部分，比如“/blog/345/comment/12”这个URL就会被映射到这个资源上，并且参数blog_id的值为345，comment_id的值为12。一个URL映射里可以添加多个参数。


三.注册Listener

   <filter>
   		<filter-name>RESTfulFilter</filter-name>
   		<filter-class>com.jstudio.rest.RESTResourceFilter</filter-class>
   		<init-param>
   			<param-name>resourceListFile</param-name>
         	<param-value>/WEB-INF/restResources.list</param-value>
   		</init-param>
   </filter>

	<filter-mapping>
		<filter-name>RESTfulFilter</filter-name>
		<url-pattern>/*</url-pattern>
	</filter-mapping>

其中resourceListFile这个参数指定了资源列表文件。此文件时一个简单的文本文件，每一行是一个资源类的类名全称。

com.jstudio.rest.test.Blog
com.jstudio.rest.test.BlogList
com.jstudio.rest.test.BlogCommentList
com.jstudio.rest.test.BlogComment

这样当应用部署了以后就可以按照自己指定的URL规则来访问REST资源了。对应的方法会得到调用。

框架很简单，甚至很“愚蠢”，但是达到了我最开始需要的效果。它仅仅适合用来实现RESTful Web服务，如果是做普通的Web项目就不行，缺少了MVC的支持，没有页面模板等等。

接下来想实现的是：

1. 对Guice或Spring等框架的支持，这样就可以为这些RESTResource实现依赖注入了
2. 实现Java对象想xml和json的直接转换，这样就不需要开发者手动转换Java对象了

这个东西我只花了几个小时来做，还很不完整，只是个玩具。希望大牛们“批评批评”。
附件里是一个示例webapp和所有代码的eclipse工程。

@URLMapping("/blog/{blog_id}/comment/{comment_id}") 
public class BlogComment {
  private final HttpServletResponse response;

  public BlogComment(HttpServletResponse response) {
    this.response = response;
  }

  @RestMethod(CREATE)
  public void create(@RestParam("blog_id") blogId, @RestParam("comment_id") String commentId) {
    // ...
  }
}

@URLMapping("/blog/{blog_id}/comment/{comment_id}") 
public class BlogComment {
  private final HttpServletResponse response;

  public BlogComment(HttpServletResponse response) {
    this.response = response;
  }

  @RestMethod(CREATE)
  public void create(@RestParam("blog_id") blogId, @RestParam("comment_id") String commentId) {
    // ...
  }
}