Rose手册第三章八节:controller层:门户必备pipe支持

rose

3.8.1 什么是pipe? ------------------
* pipe起源于facebook的工程师对他们网页提速的方案:将网页分解为Pagelets的小块(在rose叫做window的小块),然后通过后端多重管道运行,以达到性能的最佳。
* pipe巧妙使用了http 1.1连接有timeout的机制,充分使用一次http连接来传递数据。
* pipe可使用户在大多数浏览器中感受到延迟减少了一半。

3.8.2 与facebook的bigpipe相比rose pipe如何? --------------------------------------------
* fb并未在开源项目中公布过使用方法
* bigpipe神似是php+js搞定的
* rose pipe可以自由选择线程池大小,完全出自上一节的portal的基础
* 完全实现bigpipe功能,天然的对业务开发者透明

3.8.3 看实例 ------------

HelloController.java

  1. @Get("/3.8")  
  2. public String pipe(Pipe pipe) {  
  3.     pipe.addWindow("p1""/wp1");  
  4.     pipe.addWindow("p2""/wp2");  
  5.     return "pipe";  
  6. }  

* 长得是不是很像上一节里提供的action?
* 不同在于jsp文件中:

  1. <%@ page contentType="text/html;charset=UTF-8"%>  
  2. <%@ taglib uri="http://paoding.net/rose/pipe" prefix="rosepipe"%>  
  3.   
  4. <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">  
  5. <html>  
  6. <head>  
  7. <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">  
  8. <title>portal/pipe演示信息</title>  
  9. <script type='text/javascript' src='/js/rosepipe.js'></script>  
  10. </head>  
  11. <body>  
  12.   
  13. portal/pipe演示信息:  
  14. <br>  
  15. <div id="p1"></div>  
  16. <br>  
  17. <div id="p2"></div>  
  18.   
  19. </body>  
  20. </html>  
  21. <rosepipe:write>${p1}</rosepipe:write>  
  22. <rosepipe:write>${p2}</rosepipe:write>  

* 当使用jsp文件时,需要在尾部使用rosepipe:write标签
* 如果是使用vm文件,可以不写这个标签

3.8.4 总结 ----------

* 上述代码中p1 p2两个window会同时在多个线程中执行,如果是portal,那会多个线程执行完成一起返回,而pipe则会用js反写的方式,一个线程一个线程地返回给用户。
* pipe是个好物件
* 使用时jsp一定不要忘记尾部的标签
* 使用时web.xml一定不要忘记声明使用的线程池大小
* 久经考验

文中所提及代码均在 https://github.com/XiaoMi/rose/tree/master/rose-example 提供。
常期更新版本在:https://github.com/XiaoMi/rose/tree/master/chapter_3_8

54chen Twitter Memo 2012-06-10

    移动互联网必备:各平台自助渠道打包手段公开
http://t.co/L5wXmdMX # rose手册第三章七节:controller层:门户必备portal支持 http://t.co/104PdX8K # linux下使用java打包wp7的包时,按照zip解压后重新压缩成xap,wp就不认了,有哪位大侠支个招?初步估计与file Separator有关系。 # gmail同时收到人人网和facebook的邮件,都是说你的好友有过生日的,因为gmail默认不显示图片,facebook的邮件组织完整,表格正常,只是图片不显示,人人网的乱七八糟不知所云,所谓用户体验不过是比正常情况多考虑一步。 # 54chen Twitter memo 2012-06-03 http://t.co/fU12PNOy #

移动互联网必备:各平台自助渠道打包手段公开

mi 移动互联网做app是个酷毙的事情,同等产品条件下比拼的是渠道。怎么样让渠道人员(非技术)快捷地拿到想到的标识有相关渠道信息的包,是个关键的问题。
因为平台不一样,打包手法也不尽相同,下面总结下54chen在工作过程中遇到的问题和解决的办法:

1.android android下无法将一个apk包修改字节流之后apk还重新生效,因为android加key的过程会使这一过程变得无效。
采取的办法:用ant或者maven在对java代码进行build时传入渠道信息。
简单地说:当你有一个xxx渠道的包需要打的时候,后台要做的事情就是 ant -Dchannel=xxx 或者 mvn -U clean package -Dchannel=xxx

2.iphone iphone的正式渠道很少,先说越狱过的:
一个ipa包就是一个标准的zip包,只要在包里放一个channel.txt,保存渠道信息。
简单地说:当你有一个xxx渠道包需要打的时候,后台要做的事情就是打开这个ipa,修改channel.txt的内容为xxx,重新按zip压缩为ipa。

没有越狱过的iphone(占多数):
安装渠道只有一个,那就是appstore。但是推广渠道可能是多个,用户点击后到达appstore,再从appstore下载。这个过程中,ipa包没有办法携带渠道信息,希望apple公司改进。有人用一次跳转记录用户ip,但是不能准确反馈这个渠道的安装量。

3.塞班 sis/sisx的签名比较弱,签好的包,可以在包末尾写入一些字节达到携带渠道信息。
简单地说:当你有一个xxx渠道包需要打的时候,后台要做的事情就是打开这个文件,在最末尾写入xxx,关闭文件。

4.winphone xap包与ipa包极像,不一样的地方在于,xap包在windows下打出来的zip,文件分隔符是反斜线风格,在linux下解压压缩一定要用ant来做不容易写错。
简单地说:当你有一个xxx渠道包需要打的时候,后台要做的事情和iphone一样。不同在于要引入ant.jar。

周末愉快!

Rose手册第三章七节:controller层:门户必备portal支持

rose

3.7.1 什么是portal? --------------------

*字面意思,做门户用的。
*简单来说,把一个网页分成了N个区域,每个区域由不同的action去执行,多线程并行提高cpu使用率。

3.7.2 使用例子 -----------

*要使用portal,必须先在web.xml里声明所使用的线程池大小:

  1. <context-param>  
  2.         <param-name>portalExecutorCorePoolSize</param-name>  
  3.         <param-value>1024</param-value>  
  4. </context-param>  

*然后看示例代码:

  1. @Get("/3.7")  
  2. public String portal(Portal portal) {  
  3.     portal.addWindow("p1""/wp1");  
  4.     portal.addWindow("p2""/wp2");  
  5.     return "portal";  
  6. }  
  7.   
  8. @Get("/wp1")  
  9. public String portal1() {  
  10.     return "@this is p1";  
  11. }  
  12.   
  13. @Get("/wp2")  
  14. public String portal2() {  
  15.     return "@this is p2";  
  16. }  

*然后在第一个action中的portal.jsp中写到:

  1. <%@ page contentType="text/html;charset=UTF-8"%>  
  2. portal演示信息:  
  3. <br>  
  4. ${p1}  
  5. <br>  
  6. ${p2}  

*当我们部属好了之后,访问http://127.0.0.1/3.7
*将从浏览器中得到:
*portal演示信息:
*this is p1
*this is p2

3.7.3 这样子做的好处 --------------------

*更加充分地使用多核cpu。
*更加方便多人协作时对项目进行模块划分,搞的时候,按照url一分,一个url一个模块,>所有的页面都可以切成小的豆腐块,所以,你懂的。

3.7.4 过去的经典事迹 --------------------

* 2010年的6月9日晚上7点"圣战"
* http://www.54chen.com/architecture/rose-open-source-portal-framework.html

[文中所提及代码均在 https://github.com/XiaoMi/rose/tree/master/rose-example 提供。]

常期更新版本在:https://github.com/XiaoMi/rose/tree/master/chapter_3_7

54chen Twitter Memo 2012-06-03

    老人只写代码不写文档的公司注定是要混乱的。
# rose手册从3.6开始提供 mobi kindle电子书下载 持续更新 小米 bmw 团队荣誉出品(BasicMiliaoWare)https://t.co/lJDIVNDd # riak手册卖174.34港元,电子版的,要是在国内,肯定被百度百科啥的收录了。。。。 # rose手册第三章六节:controller层:一闪而过的信息,flash支持 http://t.co/Y7XwGWQh # https://t.co/jJ2jUDoU 有没有md文档to kindle电子书的工具? # 北京周边有什么适合周末自驾游的地方?收集一下。 # 54chen Twitter memo 2012-05-27 http://t.co/WFh8hvkA #

Rose手册第三章六节:controller层:一闪而过的信息,flash支持

rose

3.6.1 需求描述

历史上,做web的需求时,经常遇到一个情况:在A页面修改/添加/删除了信息,提交,提示“修改/添加/删除成功!”。
rose的flash(并非你所想象的adobe的flash)建设性地使这一需求在开发过程中简单快捷化。 3.6.2 使用过程

使用过程会很愉快,在两个action之间,通过return "r:/xxx"来跳转(实际是301),只需要在第一个action里使用flash.put,在第二个action里使用flash.get即可。

  1. @Get("/flash1")  
  2.   public String flashStep1(Flash flash) {  
  3.       flash.add("msg""修改成功!");  
  4.       return "r:/flash2";  
  5.   }  
  6.   
  7.   @Get("/flash2")  
  8.   public String flashStep2(Invocation inv, Flash flash) {  
  9.       inv.addModel("info", flash.get("msg"));  
  10.       return "flash";  
  11.   }  

上述两个action中,当访问flash1时,一句flash信息被写入,快速跳转到flash2的地址。
flash2地址中接收到这个flash信息后写到model中。
还需要在flash2的模板里去显示这个变量。

<%@ page contentType="text/html;charset=UTF-8"%> 提示信息:${info}

3.6.3 注意事项

flash功能利用了浏览器的cookies功能,如果用户的环境不能使用cookies将不会有任何效果。

文中所提及代码均在 https://github.com/XiaoMi/rose/tree/master/rose-example 提供。
文档持续修改版本在 https://github.com/XiaoMi/rose/tree/master/chapter_3_6

Rose手册第三章五节:controller层:统一的参数验证办法

rose 3.5.1 用来做什么 ----------------
* 我们把的参数验证办法叫ParamValidator
* 一般来说,像比如说验证http传来的参数是不是为空呀啥的(发挥你的想象力)。
* 好处在于不用再重复地写if else

3.5.2 怎么用 ------------
* 来看一个例子,验证用户的参数不可为空(灰常灰常的实用):

  1. public class NotBlankParamValidator implements ParamValidator {  
  2.   
  3.     @Override  
  4.     public boolean supports(ParamMetaData metaData) {  
  5.         return metaData.getAnnotation(NotBlank.class) != null;  
  6.     }  
  7.   
  8.     @Override  
  9.     public Object validate(ParamMetaData metaData, Invocation inv, Object target, Errors errors) {  
  10.         String paramName = metaData.getParamName();  
  11.         String value = inv.getParameter(paramName);  
  12.         if (StringUtils.isBlank(value)) {  
  13.             return "@参数不能为空";  
  14.         }  
  15.         return null;  
  16.     }  
  17. }  

解读:

* 放到controllers下
* 实现ParamValidator
* 实现supports方法,这个方法用来做判断是否要验证当前得到的http参数,一般都用个注解来判断比较文艺
* 实现validate方法,这里是主要逻辑
* metaData里放的是参数的原型
* inv是rose的基础调用
* target是这个参数的最后解析结果,参看上一节里提到的东西
* errors是这个参数解析时出来的错误
* NotBlank是一个自己定义的annotation

3.5.3 使用时action长什么样? ----------------------
* 下面的代码是action中使用时长的样子:

  1. @Get("/notBlank")  
  2. public String notBlank(@NotBlank @Param("messages") String messages) throws Exception {  
  3.     return "@hello world";  
  4. }  

解读: * 当遇到NotBlank注解的参数时,会自动执行参数判断
* 如果messages为空,则会得到“参数不能为空”的返回

文中所提及代码均在 https://github.com/XiaoMi/rose/tree/master/rose-example 提供。
文档持续修改版本在 https://github.com/XiaoMi/rose/tree/master/chapter_3_5

Rose手册第三章四节:controller层:自定义http参数支持

rose 3.4.1 http参数支持的一些前言 -----------------------------------------
* 我们把一个controller的类里的一个方法叫做action,它实际对应用户看到的一个url。
* 在action里可以接收各种各样的参数,也可以自己定义需要的参数。
* rose自己定义了一些常见的类型,基本上很有机会会用到自己定义,但是在某些情况下,也是个不错的选择:
* 用来对指定的参数类型的值进行固定的修改和赋值。

3.4.2 看一个例子 --------------------------

ChenBeanResolver.java放在controllers目录下:

  1. public class ChenBeanResolver implements ParamResolver {  
  2.   
  3.     @Override  
  4.     public Object resolve(Invocation inv, ParamMetaData metaData) throws Exception {  
  5.         for (String paramName : metaData.getParamNames()) {  
  6.             if (paramName != null) {  
  7.                 Chen chen = new Chen();  
  8.                 String value1 = inv.getParameter("chen1");  
  9.                 String value2 = inv.getParameter("chen2");  
  10.                 chen.setChen1(value1);  
  11.                 chen.setChen2(value2);  
  12.                 return chen;  
  13.             }  
  14.         }  
  15.         return null;  
  16.   
  17.     }  
  18.   
  19.     @Override  
  20.     public boolean supports(ParamMetaData metaData) {  
  21.         return Chen.class == metaData.getParamType();  
  22.     }  
  23.   
  24. }  

* 上述代码的意思:
* 如果在action里一个参数的类型是Chen(com.chen.model.Chen),就会走这个resolver,这里对两个参数进行了组装。
* 用户如果访问的参数里传入了chen1和chen2的值,则会直接组装出来一个Chen对象。

* 配合上述resolver的action代码为:

  1. @Get("/param")  
  2.    public String param(Chen chen) throws Exception {  
  3.        return "@hello world:" + chen.getChen1() + ":" + chen.getChen2();  
  4.    }  

* 用户访问:http://127.0.0.1/param?chen1=1&chen2=2 将会返回:
** hello world:1:2

3.4.2 rose内置的参数支持 ------------------------------
除了上述的自定义resolver外,rose还内置了丰富的resolver,都是大家的经验总结,使用起来会非常方便,它们是:
* 所有的基础java类型,都可以直接使用,rose进行自动转换,比如在action中的类型为long id,则id可以转为数字,不再需要从string转为long。
* array/map/bean同样可用,它们的接收参数规则为:
* ?id=1,2,3,4 或者 ?id=1&id=2&id=3 对应 @Param("id") int[] idArray
* ?map:1=paoding&map:2=rose 对应 @Param("map") Map map
* POST http://127.0.0.1/user?id=1&name=rose&level.id=3 对应接收代码:

  1. @Post  
  2.  public String post(User user) {  
  3.       return "@" + user.getId() + "; level.id=" + user.getLevel().getId();  
  4.  }  

* 代码中User是一个自定义的bean,有属性id,name,level等。

文中所提及代码均在 https://github.com/XiaoMi/rose/tree/master/rose-example 提供。
文档持续修改版本在 https://github.com/XiaoMi/rose/tree/master/chapter_3_4