当前位置:首页 > 开发 > Web前端 > 前端 > 正文

58同城开源web框架 Argo (六)

发表于: 2013-10-08   作者:biocy   来源:转载   浏览次数:
摘要: 58同城开源的轻量级web框架 https://github.com/58code/Argo   随着公司规模的不断扩大,项目越来越多了,单个项目投入的人也多了起来,每个程序员都有自己的一套编码风格。身为一个处女座程序员,深深感觉到无法忍受一团乱麻似的工程。于是就需要一套强有力的规范,而且规范最好能够分级,最低层的规范最为严格,导致大家写出的代码都能差不多,也就减少人员交叉

58同城开源的轻量级web框架 https://github.com/58code/Argo

 

随着公司规模的不断扩大,项目越来越多了,单个项目投入的人也多了起来,每个程序员都有自己的一套编码风格。身为一个处女座程序员,深深感觉到无法忍受一团乱麻似的工程。于是就需要一套强有力的规范,而且规范最好能够分级,最低层的规范最为严格,导致大家写出的代码都能差不多,也就减少人员交叉过渡的成本,越靠近业务顶层的规范就越松散、又根据业务相互隔离、可插拔,这样一来,即使无法维护,重写的成本也会降低。

一个自己定义的web框架所要完成的任务恰好包括了从低到高的全部过程,如果您的公司已经完成了服务化架构,那么web也就剩下从中高层到顶层的过程。Argo就是只关注解耦后的业务层web框架,服务化框架(分布式通讯中间件)是另一个开源项目,叫Gaea。

 

58开源的官方微博http://weibo.com/58code

 

 controller一个必不可少的功能:拦截器。

上一篇中我有一个地方一带而过,就是Router 的默认实现DefaultRouter

this.actions = buildActions(argo, controllerClasses, staticAction); 

 DefaultRouter的构造方法有注解@Inject,实例化是通过Guice

@Inject
    public DefaultRouter(Argo argo, @ArgoSystem Set<Class<? extends ArgoController>> controllerClasses, @StaticActionAnnotation Action staticAction) {

        this.argo = argo;

        argo.getLogger().info("initializing a %s(implements Router)", this.getClass());

        this.actions = buildActions(argo, controllerClasses, staticAction);

        argo.getLogger().info("%s(implements Router) constructed.", this.getClass());
    }

 那么这些参数是从哪来的,就是之前提到的com.bj58.argo.inject.ArgoModule,Argo的绑定关系都能在这里找到。

第一个参数Argo的提供实例为

@Provides
    @Singleton
    private Argo provideArgo() {
        return argo;
    }

 第二个参数带注解的 @ArgoSystem Set<Class<? extends ArgoController>> controllerClasses  提供实例为

 

@Provides
    @ArgoSystem
    @Singleton
    private Set<Class<? extends ArgoController>> provideControllerClasses() {
        return argo.getControllerClasses();
    }
 第三个参数带注解的 @StaticActionAnnotation Action staticAction  ,绑定在configure()方法中。顺便提一下,这个StaticFilesAction是处理静态文件的,跟tomcat中的DefaultServlet一样,只是有个指定的读取路径

 

 

bind(Action.class).annotatedWith(StaticActionAnnotation.class)
                .to(StaticFilesAction.class);
 

 

 

好了,DefaultRouter的实参来源也知道了,构造方法中buildActions方法的调用,还有一层buildActions方法调用,我们来看看这个

 

List<Action> buildActions(Set<ArgoController> controllers, Action staticAction) {
        
    	List<Action> actions = Lists.newArrayList();
        actions.add(staticAction);

        for (ArgoController controller : controllers) {
            ControllerInfo controllerInfo = new ControllerInfo(controller);
            List<ActionInfo> subActions = controllerInfo.analyze();

            for(ActionInfo newAction : subActions)
                merge(actions, MethodAction.create(newAction));

        }

        return ImmutableList.copyOf(actions);
    }
 这个段代码看出,全局变量  private final List<Action> actions;  就是具体的Action集合

 

代码详细描述了首先把静态资源action加入全局actions中,再把从controller类中解析出的ActionInfo集合合并到actions中。其中 merge(actions, MethodAction.create(newAction));  这段的MethodAction,就是方法action。

 

 

 

com.bj58.argo.internal. DefaultRouter.route( BeatContext beat)

 

@Override
    public ActionResult route(BeatContext beat) {

        RouteBag bag = RouteBag.create(beat);

        for(Action action : actions) {
            RouteResult routeResult = action.matchAndInvoke(bag);
            if (routeResult.isSuccess())
                return routeResult.getResult();
        }

        return ActionResult.NULL;
    }
 上面这段代码是处理请求过程,执行action的matchAndInvoke方法,静态文件action就是读取指定目录的文件返回,方法action需要看看

 

 

com.bj58.argo.internal. MethodAction.matchAndInvoke( RouteBag bag)

 

@Override
    public RouteResult matchAndInvoke(RouteBag bag) {

        if (!actionInfo.matchHttpMethod(bag))
            return RouteResult.unMatch();

        Map<String, String> uriTemplateVariables = Maps.newHashMap();

        boolean match = actionInfo.match(bag, uriTemplateVariables);
        if (!match)
            return RouteResult.unMatch();

        // PreIntercept
        for(PreInterceptor preInterceptor : actionInfo.getPreInterceptors()) {
            ActionResult actionResult = preInterceptor.preExecute(bag.getBeat());
            if (ActionResult.NULL != actionResult)
                return RouteResult.invoked(actionResult);
        }

        ActionResult actionResult = actionInfo.invoke(uriTemplateVariables);

        // PostIntercept
        for(PostInterceptor postInterceptor : actionInfo.getPostInterceptors()) {
            actionResult = postInterceptor.postExecute(bag.getBeat(), actionResult);
        }

        return RouteResult.invoked(actionResult);
    }
 PreInterceptor是前置拦截器,PostInterceptor是后置拦截器,ActionInfo封装时就根据注解把拦截器都加进去了,执行请求的时候再拿出来按顺序走一遍。拦截器的用法也很简单。

 

比如我们要写一个前置拦截器,首先写一个类,实现 PreInterceptor 接口
package com.mycompany.sample.interceptors;

import com.bj58.argo.ActionResult;
import com.bj58.argo.BeatContext;
import com.bj58.argo.interceptor.PreInterceptor;

public class MyInterceptor implements PreInterceptor{
	@Override
	public ActionResult preExecute(BeatContext beat) {
		System.out.println("in pre interceptor");
		return null;
	}
}
 然后写一个注解类,把前置注解指向这个拦截器
package com.mycompany.sample.anns;

import java.lang.annotation.Documented;
import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;

import com.bj58.argo.interceptor.PreInterceptorAnnotation;
import com.mycompany.sample.interceptors.MyInterceptor;

@Target({ElementType.TYPE, ElementType.METHOD})
@Retention(RetentionPolicy.RUNTIME)
@Documented
@PreInterceptorAnnotation(value=MyInterceptor.class)
public @interface MyInterceptorAnnotation {

}
 这样前置拦截器就写好了。使用的时候只要在controller的类名前或者方法上标记这个@MyInterceptorAnnotation就可以了,比如针对demo中的 http://localhost/hello/argo有效,就把方法改成这样
@MyInterceptorAnnotation
@Path("argo")
public ActionResult helloArgo() {
     return writer().write("Hello, argo");
}
 
这时候打开  http://localhost/hello/argo  ,就会看到控制台上输出  “in pre interceptor”
-----------------------------------------------   分割线   ---------------------------------------
至此Argo大概的流程也就差不多了,还有一些更细节的功能,如果有必要的话可留言给我,交流讨论  :)
 
 

58同城开源web框架 Argo (六)

  • 0

    开心

    开心

  • 0

    板砖

    板砖

  • 0

    感动

    感动

  • 0

    有用

    有用

  • 0

    疑问

    疑问

  • 0

    难过

    难过

  • 0

    无聊

    无聊

  • 0

    震惊

    震惊

编辑推荐
58同城开源的轻量级web框架 https://github.com/58code/Argo 有的时候总是在想,什么样的工具才算是
WebWork WebWork是由OpenSymphony组织开发的,致力于组件化和代码重用的拉出式MVC模式J2EE Web框架
58同城数据库架构设计思路 58同城,一个被贴上“神奇”标签的网站,海量信息背后到底支撑的数据库是
Python是一门动态、面向对象语言。其最初就是作为一门面向对象语言设计的,并且在后期又加入了一些
简介:轻量封装Spring MVC 因为本人在国内最大的电子商务公司工作期间,深感一个好的Web框架可以大
简介:轻量封装Spring MVC 因为本人在国内最大的电子商务公司工作期间,深感一个好的Web框架可以大
Android例子源码类似58同城的通过滑屏控制引导页 运行效果图如下,向右滑动屏幕,小人的小腿在跑呀
原文网址链接:http://www.csdn.net/article/2015-10-24/2826028 摘要:对很多创业公司而言,很难在
  特地等了好久才等到今天发布,想着好歹也算个特殊点的日子。   HoorayOS从最早只是一个想法,
Aranea Aranea是一个开源,面向组件,事件驱动的Java MVC Web框架。它提供一种通用简单的方式来构建
版权所有 IT知识库 CopyRight © 2009-2015 IT知识库 IT610.com , All Rights Reserved. 京ICP备09083238号