用注解和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的MVCT2的核心在于，一个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