58同城开源web框架 Argo （一）

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

很多网站在建设初期都会选择PHP  .net，随着业务规模不断扩大，开发需求增多，已经各种成本问题，逐渐得向JAVA过渡。过渡过程中，架构师们根据各自业务特点及需要，规划出技术平台的框架，然后面对着JAVA社区和各种形形色色的开源产品。

 

在这里不得不提的是58文化：简单、高效

同样适用于技术选型和平台搭建，每一个应用框架、RPC服务甚至是工具类，都要足够简单、高效、可依赖。

有两种代码是没有bug的：1. 逻辑复杂到没有人能明白其中的运行轨迹，而最终结果总是对的。2. 逻辑简单到每个人都能明白代码的每一个细节，要做的事一目了然。

其中的取舍很明显了吧，完成功能的基础上，足够简单是终极目标。

 

好了，废话不多说，下面首先跑一个demo试试

从github下载的代码中有个demo项目 company-sample，可以直接运行（建议使用mvn插件 jetty:run或tomcat:run，例子中已经依赖两种jetty插件），打开 http://localhost/hello 即可看到效果

 

细心的朋友会发现，demo中并没有web.xml

这是因为Argo基于servlet3.0，web.xml是可以省略的，关于servlet3.0，请参考 http://www.ibm.com/developerworks/cn/java/j-lo-servlet30/index.html?ca=drs-cn-0423

 

 

com.mycompany.sample.controllers.HomeController

这就是我们MVC中的C，其中有四个import

import com.bj58.argo.controller.AbstractController;

import com.bj58.argo.ActionResult;
import com.bj58.argo.BeatContext;
import com.bj58.argo.annotations.Path;

 

1. AbstractController：

我们的MVC中的C的父类。

（这里再提一个内部规范：约定优于配置。工程中大量的配置可提高灵活性，但是负面影响就是难于维护，学习配置文件也需要一定过程，所以干脆，我们约定某种规则，减少不必要的配置文件）

C有三个要素：(1) 继承自AbstractController  (2) 类名以Controller结尾   (3) 包名以controllers结尾

 

2. ActionResult：

所有的web返回结果都是ActionResult，页面、文字、图片各种类型……

 

3. BeatContext：

一次请求中的上下文环境，内置某些全局变量，还封装了一些更友好易于理解的方法。

beat().getClient()  可以理解成客户端对象，对cookie和上传文件有封装处理，forms()把表单封装成map……

 

4. Path：

这是Argo的内部注解，用于映射url，支持正则表达式和匹配注入对象。例如：

 

@Path("{phoneNumber:\\d+}")
public ActionResult helloView(int phoneNumber) 

Argo会把匹配到的 \\d+  自动赋值给形参 phoneNumber

 

 

 

说完import，最后再说说demo中出现的内置方法（继承自AbstractController）

三个返回ActionResult的方法：

view(String viewName)    返回一个页面，系统默认采用velocity实现，viewName + .html存放的目录resources/views下

redirect(String redirectUrl)   跳转到一个地址(302临时跳转)redirect301(String redirectUrl)   跳转到一个地址(301永久跳转) 

其他：

model() 返回变量列表，熟悉velocity的同学都知道，渲染vm模板的时候需要set变量

beat() 获得当前的上下文信息

request() 获得当前的request，也可以这样写 beat().getRequest()

response() 获得当前的response，也可以这样写 beat().getResponse()

logger() 获得当前类的logger

logger(String name) 根据名字获得Logger

logger(Class clazz) 根据类名获得Logger

argo() 这个对象慎用！里面包含了Argo的所有核心：DI、公共处理线程池、Servlet适配器（URL转发）