Paoding Rest 0.4

阅读更多

Paoding Rest今天可以发布0.4版本了。

从0.3开始，Paoding替换掉原来的购物车示例为一个简易论坛示例。
可以通过 http://paoding.net/forum 试访问该示例的一个运行实例。

Paoding Rest下载地址： http://code.google.com/p/paoding-rest/downloads/list

Paoding Rest是一个Web框架，当然现在的web框架很多，Paoding Rest是否有必要？
暂且这样说，有人觉得它比较独特，很好用，功能也算丰富。
仅此而已。

发布Paoding Rest不必是为了让您去下载并使用它，或许您能给我的最大的价值是：
看看使用Paoding Rest如何开发，并进行批评。


现在让我说说默认情况下，使用Paoding Rest 0.4开发Web app action层的步骤：

1、写一个POJO的Action以及可能使用到的实体类，如:
UserAction.java

public class UserAction {
    public String read(String id) {
        // User user = get user form database;
        User user = new User();
        user.setId(id);
        user.setName("Java");
        RestContext.setRequestAttrubute("user", user);
        return "user";
    }

    public String hello(User user) {
        return "@hello " + user.getName();
    }

    public int test(int value) {
        return value;
    }
}

User.java

public class User {
    private String id;
    private String name;

    // getters & setters
}

2、写一个Velocity文件放在/page下(相对于war路径):
user.vm

user id : $user.id

user name: $user.name

3、将Action配置到/WEB-INF/root-action.xml中:

4、配置web.xml
不管在root-action.xml写了多少的Action，都只要在web.xml简单增加配置如下:

	
	
	
		RestFilter
		net.paoding.rest.RestFilter
	
	
	
		RestFilter
		/*
		REQUEST
		FORWARD
	

5、OK，以上这些代码和配置就可以了。
确定Paoding-Rest依赖的lib都到/WEB-INF/lib下了
把webapp部署到tomcat, 就可以启动tomcat了

6、访问
1) http://127.0.0.1/webpath/user/12345
2) http://127.0.0.1/webpath/user/hello?name=world
3) http://127.0.0.1/webpath/user?name=world&_method=hello
4) http://127.0.0.1/webpath/user/12345?_method=test
(webapp是这个示例的ctx path)

2) 3)是等价的，按照rest的做法3)优于2)，虽然它看起来比较麻烦。



现在这个东西主要还是在小范围内使用。

以上只是一个很简单的示例。使用velocity作为页面模板语言。
但Paoding Rest不限于此，他可以很简单使用freemarker,jsp等其他视图技术。

Paoding Rest也可以很简单地支持上传。我大概需要几个月来完成一份完整的参考文档的编制。