用注解和pojo支撑起来的轻量级REST框架--T2
openkk
12年前
用注解和pojo支撑起来的轻量级REST框架--T2
Written by Tony@tokyo
1. 前言
T2是以java5注解为支撑的轻量级Web框架。
T2不是简单的form提交,而对Ajax请求,RIA客户端等多种多样的前台技术的支持。
T2的目标:
2 无论什么类型的客户端都可以访问的Web服务器端框架
2 提供尽量简约,轻量级,易于维护和可扩展的架构
2 支持无状态,Rest风格的技术架构
2 提供plugin接口,可轻易扩展业务层架构
T2架构草图
T2的homepage: http://code.google.com/p/t-2/
1. T2的sample code
T2的运行需要的JRE和Web容器
JRE:1.6以上
Web容器:实现了Servlet2.5和JSP2.0的JavaEE标准
T2运行时必要的jar文件
T2.jar
Commons.jar Apache的共通类库
slf4j-api.jar logging用类库
T2必要的设定
Web.xml中的设定
<?xml version="1.0" encoding="ISO-8859-1"?> <web-app 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" version="2.5"> <filter> <filter-name>t2</filter-name> <filter-class>org.t2framework.t2.filter.T2Filter</filter-class> <init-param> <param-name>t2.rootpackage</param-name> <param-value>sample.page</param-value> </init-param> </filter> <filter-mapping> <filter-name>t2</filter-name> <url-pattern>/*</url-pattern> </filter-mapping> </web-app>
http请求由T2Filter接受,这里是T2框架的入口
[t2.rootpackage]指定了所有后台页面程序的根目录,Web容器启动以后,到这个目录下面,将所有@Page注解的Java程序实例化。
T2框架本身有自带的IOC管理器—SimpleContainerAdapter。
当然也可以通过以下配置,将instances的管理交由专业框架。
<init-param> <param-name>t2.container.adapter</param-name> <param-value>org.t2framework.t2.adapter.S2Adapter</param-value> </init-param> <!-- 設定ファイルの読み込み --> <init-param> <param-name>t2.config</param-name> <param-value>app.dicon</param-value> </init-param>
接受http请求的后台类
@Page("/helloworld") public class HelloPage { @Default public Navigation index() { String message ="HelloWorld"; return SimpleText.out(message); } }
以上,@Page用来声明这个后台类对外公开的URL。@Default声明默认的http请求的处理函数。
假设,Web工程的contentroot是/sample的话,上面的后台类能够用以下url访问
http://localhost:8080/sample/helloworld
T2框架可执行的SampleCode可以由以下取得
http://code.google.com/p/t-2/wiki/Samples
3. T2的运行原理
T2的MVC
T2的核心在于,一个url对应一个Page类。
Page类和View分离,达到可以自由更换View层技术。
Page类中,http request的接受,http response的组装,Token的获得,Session的获得,业务层service的对象的组装都可以由注解来完成。
比如,拿官方的sample举例
@RequestScope @Page("login") public class LoginPage { private static Logger logger = Logger.getLogger(LoginPage.class); protected LoginService loginService; /** * * {@.en } * * <br /> * * @param request * @return */ @Default public Navigation index(final HttpServletRequest request) { TokenUtil.saveToken(request, Constants.TOKEN_KEY); String token = TokenUtil.getToken(request, Constants.TOKEN_KEY); request.setAttribute(Constants.TOKEN_KEY, token); return Forward.to("WEB-INF/pages/login.jsp"); } /** * * {@.en } * * @param context * @return * @since 0.5.1 */ @Ajax @POST @ActionParam public Navigation login(WebContext context) { final String contextPath = context.getRequest().getContextPath(); final Map<String, String> map = CollectionsUtil.newHashMap(); String next; if (TokenUtil.isTokenValid(context.getRequest().getNativeResource(), Constants.TOKEN_KEY) == false) { map.put("errorMessage", Functions.nls("login_token_invalid")); next = "/login"; } else { final String user = context.getRequest().getParameter("user"); final String pass = context.getRequest().getParameter("pass"); if (StringUtil.isEmpty(user)) { map.put("errorMessage", Functions.nls("login_userid_empty")); next = "/login"; } else if (StringUtil.isEmpty(pass)) { map.put("errorMessage", Functions.nls("login_password_empty")); next = "/login"; } else { final boolean logined = loginService.login(user, pass, 0); if (logined == false) { logger.debug("Login error"); map.put("errorMessage", Functions.nls("login_auth_failed")); next = "/login"; } else { context.getSession().setAttribute(Constants.AUTH_KEY, System.currentTimeMillis()); next = "/employee/list"; } } } map.put("url", contextPath + next); return Json.convert(map); }
整个类最高层有两个注解,@RequestScope和@Page
@RequestScope声明本页面所有的变量只能存续在一次请求中
Index方法上的@Default声明了它是初期化函数
HttpServletRequest的变量是由框架组装实例化。
Login方法上的@Ajax,@POST,@ActionParam。分别声明了该方法支持Ajax请求,接受post方法请求,用来检查本方法和form的名字是否统一
前台JSP中提交的form如下
<form action="${t:url('/login')}" method="post"> <div class="x"> <span id="error" class="err">${message}</span> <c:if test="${message != null}"><br /></c:if> <span id="errorMessage" class="m">${t:nls('login_init_message')}</span> <br/> <fieldset id="loginFieldset" class="loginfieldset" title="${t:nls('login_init_message')}"> <legend>Login</legend> <table> <tr> <td class="z">${t:nls('login_userid')}</td> <td class="v"> <input type="text" id="user" name="user" maxlength="32" style="width: 100px;"/> </td> </tr> <tr> <td class="z">${t:nls('login_password')}</td> <td class="v"> <input type="password" id="pass" name="pass" style="width: 100px;"/> </td> <td> </tr> <tr> <td colspan="2" align="right"> <input type="submit" id="login" name="login" value="${t:nls('login_loginbutton')}" class="submit"/> </td> <td></td> </tr> </table> </fieldset> </div> </form>
Form中定义的
t:url('/login')是用到了T2自定义的标签,简单说来就是将请求发给了Login.java的login函数。
T2的扩展
作为一个高扩展的框架,T2提供了注解自定义,函数拦截,入口参数封装等等扩展接口。
Navigation
Navigation是用来forward,redirect画面的接口。可以自定义扩展,比如在画面跳转之前,将数据封装成json等等。
ContainerAdapter
用来连接DI容器的适配器,可以自定义到任意到现有的DI框架。
Plugin
XXXPlugin这种class可以用来拦截http请求,封装参数对象等等。具体说起来就是在T2Filter将请求转发给XXXPage之前就加以处理
AnnotationResolverCreator
可以用来生成和解释自定义的标签
FormResolver
用来自定义form参数解释器。
#以上#
转自:http://blog.csdn.net/nanjingjiangbiao/article/details/7680702