设为首页收藏本站

LUPA开源社区

 找回密码
 注册
文章 帖子 博客

人人网和糯米网开发框架Paoding-rose入驻源码赏析频道

2011-3-15 09:35| 发布者: admin| 查看: 13418| 评论: 0

摘要: 在线阅读源码 http://www.lupaworld.com/code-list-path-paoding-rose_1.0.1-itemid-41.htmlRose是面向使用Java开发的同仁们的。Rose 提供的各种特性和约束惯例,目的就是为了使您在能够轻松地开发web程序。如果您觉 ...

在线阅读源码  http://www.lupaworld.com/code-list-path-paoding-rose_1.0.1-itemid-41.html

Rose是面向使用Java开发的同仁们的。Rose 提供的各种特性和约束惯例,目的就是为了使您在能够轻松地开发web程序。如果您觉得Grails的想法很好,您不必转向它,Rose可以给您这种感觉,同时基于您对Java的熟悉,您又能更好地控制Rose。

我们希望Rose对各种技术的整合和规范,能使您摆脱犹豫,摆脱选择的困难,规避没有经验带来的开发风险。Rose不仅整合技术,同时还强调最佳实践,甚至包括名称规范。我们不仅仅只是提供技术,我们还会引导您应该如何使用好技术。

Rose规范了对Spring的使用,虽然大部分时间之内,您可能只是使用 @Autowired 即可,大多数时候的确这样也就够了。但 Rose 也允许您放置applicationContext-xxx.xml文件来扩展Rose。

不熟悉Spring的人,不用去重温Spring的知识也能够开始,并书写漂亮的程序!对熟悉Spring的人,则你们可以看到更多。

线上互联网应用 [每天接受着亿数量级PV的挑战]

【伟大的日子】 2009年08月xx日
人人网公共主页: http://page.renren.com 
人人网光良主页: http://page.renren.com/600002233

【伟大的日子】 2009年11月26日
人人网Home页: http://www.renren.com 
人人网个人页: http://www.renren.com/profile.do?id=237391798

【伟大的日子】 2010年06月23日
糯米网: http://www.nuomi.com 
【100%】
你通过浏览器访问到的人人网、糯米网各业务以及子业务均使用rose作为web框架,全中国每天这么多用户不断地点击和挑战,rose值得您信任。

第一支程序,5分钟!

第一支程序

5分钟之后,一切就已经顺利。您可以开始围观一些别人写的代码以及第二支程序

控制器类代码
第二支程序

Rose原理概要

Rose 是一个基于Servlet规范、Spring“规范”的WEB开发框架。

Rose 框架通过在web.xml配置过滤器拦截并处理匹配的web请求,如果一个请求应该由在Rose框架下的类来处理, 该请求将在Rose调用中完成对客户端响应. 如果一个请求在Rose中没有找到合适的类来为他服务,Rose将把该请求移交给web容器的其他组件来处理。

Rose使用过滤器而非Servlet来接收web请求,这有它的合理性以及好处。

Servlet规范以“边走边看”的方式来处理请求, 当服务器接收到一个web请求时,并没有要求在web.xml必须有相应的Servlet组件时才能处理,web请求被一系列Filter过滤时, Filter可以拿到相应的Request和Response对象 ,当Filter认为自己已经能够完成整个处理,它将不再调用chain.doNext()来使链中下个组件(Filter、Servlet、JSP)进行处理。

使用过滤器的好处是,Rose可以很好地和其他web框架兼容。这在改造遗留系统、对各种uri的支持具有天然优越性。正是使用过滤器,Rose不再要求请求地址具有特殊的后缀。

为了更好地理解,可以把Rose看成这样一种特殊的Servlet:它能够优先处理认定的事情,如无法处理再交给其它Filter、Servlet或JSP来处理。这个刚好是普通Servlet无法做到的 : 如果一个请求以后缀名配置给他处理时候 ,一旦该Servlet处理不了,Servlet规范没有提供机制使得可以由配置在web.xml的其他正常组件处理 (除404,500等错误处理组件之外)。

一个web.xml中可能具有不只一个的Filter,Filter的先后顺序对系统具有重要影响,特别的,Rose自己的过滤器的配置顺序更是需要讲究 。如果一个请求在被Rose处理前,还应该被其它一些过滤器过滤,请把这些过滤器的mapping配置在Rose过滤器之前。

RoseFilter的配置,建议按以下配置即可:

        <filter>
               
<filter-name>roseFilter</filter-name>
               
<filter-class>net.paoding.rose.RoseFilter</filter-class>
       
</filter>
       
<filter-mapping>
               
<filter-name>roseFilter</filter-name>
               
<url-pattern>/*</url-pattern>
               
<dispatcher>REQUEST</dispatcher>
               
<dispatcher>FORWARD</dispatcher>
               
<dispatcher>INCLUDE</dispatcher>
       
</filter-mapping>

1) 大多数请况下,filter-mapping 应配置在所有Filter Mapping的最后。 2) 不能将 FORWARD、INCLUDE 的 dispatcher 去掉,否则forward、 include的请求Rose框架将拦截不到

Rose框架内部采用"匹配->执行"两阶段逻辑。Rose内部结构具有一个匹配树, 这个数据结构可以快速判断一个请求是否应该由Rose处理并进行, 没有找到匹配的请求交给过滤器的下一个组件处理。匹配成功的请求将进入”执行“阶段。 执行阶段需要经过6个步骤处理:“参数解析 -〉 验证器 -〉 拦截器 -〉 控制器 -〉 视图渲染 -〉渲染后"的处理链。

匹配树: 匹配树是一个多叉树,下面是一个例子:

ROOT

GET="HomeController#index" package="com.xiaonei.xxx.controllers"
/about
GET="HomeController#about" package="com.xiaonei.xxx.controllers"
/book
GET="BookController#list" package="com.xiaonei.xxx.controllers.sub"
POST="BookController#add" package="com.xiaonei.xxx.controllers.sub"
/book/
/book/{id}
GET="BookController#show" package="com.xiaonei.xxx.controllers.sub"

/help

GET="HomeController#help" package="com.xiaonei.xxx.controllers"

ROOT代表这是一个根地址,也就是 http://localhost/ 代表的地址;

ROOT的下级有个GET结点,代表对该地址支持GET访问,不支持POST等其它访问,如果进行POST访问将以405错误回应。

/book代表这是一个/book地址,也就是 http://localhost/book 代表的地址;

/book下级有GET、POST两个结点,说明它支持GET和POST方法,根据HTTP语义,GET代表浏览,POST代表追加(向一个集合中追加一个条目)。

/book下还有/book/地址,这个地址有点特别,它以'/'结尾,但实际它不会被任何地址访问到,rose对http://localhost/book/的处理会将它等价于 http://localhost/book 

这个特别的地址的存在完全是匹配树结构所需导致的,但不对实际匹配有任何坏的影响,所以也没有任何GET、POST等子结点。

/book/{id}代表是一个/book/123456、/book/654321这样的地址,当然这可以支持正则表达式的。

大部分情况下,匹配树的结构和实际的URI结构会一致,也因此匹配树的深度并不固定,每一个中间结点或叶子节点都有可能代表一个最终的URI地址,可以处理GET、POST等请求。对于那些匹配树存在的地址,但没有GET、POST、DELETE等子结点的,一旦用户请求了该地址,rose将直接把该请求转交给web容器处理,如果容器也不能处理它,最终用户将得到404响应。

匹配过程: Rose以请求的地址作为处理输入(不包含Query串,即问号后的字符串)。如果匹配树中存在对应的地址,且含有对应请求方法(GET、POST、PUT、DELETE)的,则表示匹配成功;如果含有其他方法的,但没有当前方法的(比如只支持GET,但当前是POST的),则也表示匹配成功,但最后会以405响应出去;如果所给的地址没有任何支持的方法或者没有找到匹配地址的,则表示匹配失败。1.0.1不支持回朔算法,1.0.2将支持部分回朔算法(待发布时再做详细介绍)。

参数解析: 在调用验证器、拦截器 控制器之前,Rose完成2个解析:解析匹配树上动态的参数出实际值,解析控制器方法中参数实际的值。参数可能会解析失败(例如转化异常等等 ),此时该参数以默认值进行代替,同时Rose解析失败和异常记录起来放到专门的类中,继续下一个过程而不打断执行。

拦截器: Rose使用自定义的拦截器接口而非一般的拦截器接口这是有理由的。使用Rose自定义的拦截器接口可以更容易地操作、控制Rose拦截。 所谓拦截即是对已经匹配的控制器调用进行拦截,在其调用之前、之后以及页面渲染之后执行某些逻辑。设计良好的拦截器可以被多个控制器使用。

控制器:

CHANGELOG

0.9.6

1、如果@Param没有设置默认值时,@Param会有一个内置字符串来表示开发者没有定义,现在更改这个字符串的值,并使用JAVA_DEFAULT来表示这个值

【对应用程序没有影响】

2、去除ParameterBindingResult对rejectValue方法的覆盖,使其回归原始意思;

如果出现绑定类型错误(TypeMismatch),改addError(filedError)登记这个错误,而非使用rejectValue 【对应用程序没有影响】

3、构造控制器的方法参数时,如因非type mismatch导致的异常(比如构造函数异常),这个错误不再作为error登记到bindingResult,而是rethrow异常出来

【可能影响到应用程序,使原先可以“因为构造函数错误但还能运行”的服务变得不可服务】

4、支持对Bean的Date、DateTime、TimeStamp属性进行绑定

【可能影响应用程序,会对原先不能解析的date属性进行试图解析,把请求参数中的值解析到该参数】

5、执行异常时在异常信息中加注Rose和Spring的版本号

【对应用程序没有影响】

6、如果有特定的请求方法rose本身不支持(比如PROPFIND),原来是抛IllegalArgumentException,现改为405 Method Not Allowed

【可能影响应用程序,原来抛出的请求方法不支持的异常,现在改为method allowed出去】

7、bugfix: 如果控制器目录下的rose.properties的module.path定义为一个未以'/'开始的串,且父package没有为空package或没有有效的rose类时,未能自动加上父亲路径的bug

【可能影响程序:如果原先的程序定义了rose.properties,定义了module.path非以/开始的,但中间含有/字符的要特别认真校对】
如果module.path以/开始,表示这是他的映射路径;如果不是以/开始的,表示需要加上它的父路径,举例如下:
packagerose.properties的module.path实际的module.path
controllers.applicationapp/app
controllers.application.abcabc/app/abc
controllers.application.edf/edf/edf
controllers.application2/app2/app2
controllers.application2.xyzxyz/app2/xyz

8、bugfix: 解决参数解析互串的问,本质上PropertyEditor线程不安全,不能使用同一个propertyEditor对所有线程同时服务。

【对应用程序没有影响;但因此造成的原来出现的一些“串页”问题将得到避免】
9、支持ignoredPaths设置,使rose不对配置的地址进行映射和处理
配置方式:
  1. 在web.xml中,roseFilter的param name为ignoredPaths,value是可逗号分隔的多项地址
  2. 地址可有4种配置方式(均大小写敏感):相等方式、前缀方式、后缀方式、正则表达式方式

10、支持:continue指示,在控制器、拦截器、验证器等返回此字符串指示rose把这个请求送给下一个过滤器以及Servlet

11、增加inv.getModel(String name)方法,等价于inv.getModel().get(String name)

12、增加ParamValidator接口,和拦截器、控制器有类同语义的风格的处理方式

13、修改model.getAttributes语义,不再返回rose框架自身设置的model数据(即keyt以$$paoding-rose开始的属性)


在线阅读源码  http://www.lupaworld.com/code-list-path-paoding-rose_1.0.1-itemid-41.html


酷毙
1

雷人

鲜花

鸡蛋

漂亮

刚表态过的朋友 (1 人)

相关阅读

  • 快毕业了,没工作经验,
    找份工作好难啊?
    赶紧去人才芯片公司磨练吧!!

最新评论

关于LUPA|人才芯片工程|人才招聘|LUPA认证|LUPA教育|LUPA开源社区 ( 浙B2-20090187 浙公网安备 33010602006705号   

返回顶部