ActFramework 轻量级java web框架 (1、快速入门)

写在前面

spring 用得太舒服了，来试试ActFramework

1、Act 官方github：https://github.com/actframework/actframework
2、官方中文文档：https://gitee.com/actframework/act-doc/blob/master/cn/index.md

2、Act的开发过程基本上是：
路由 -> 控制器 -> 网络层 -> 字节码增强 -> View/Templating -> 事件分发及任务调度 -> Model/DB -> 依赖注入 -> 参数绑定 -> WebSocket 支持

3、开发模式下, 一旦 ActFramework 项目开始运行就无需重启 (除非引入新的依赖库)。

1、快速开始一个act项目

第一步：新建一个文件夹
在该目录下打开cmd，输入指令：

前提是已安装maven

mvn archetype:generate -DarchetypeGroupId=org.actframework -DarchetypeArtifactId=archetype-quickstart -DarchetypeVersion=1.9.1.0

之后输入分组、版本等信息

接着用idea打开这个项目

运行 AppEntry主方法可启动这个项目

日志中会打印访问地址：http://127.0.0.1:5460

2、AppEntry 启动类

AppEntry 这个启动类本身就是一个 Controller。

让我们来关注一下 AppEntry 的 home 方法。

    @GetAction
    public void home(@DefaultValue("World") @Output String who) {
    }

下面是@GetAction、@DefaultValue、@Output这几个注解的解释。

2.1、@GetAction GET请求

@GetAction表示这是一个 Get 请求方法，
同理还有 @PostAction 、 @PutAction 、 @DeleteAction、@Action …
@Action 用来定义全部或指定 HTTP 请求方法的路由。

2.2、@DefaultValue 入参默认值

@DefaultValue(“朋友们”) 代表了 当 who 为 null 时，who的值为“朋友们”。
例：我们直接请求 http://127.0.0.1:5460/，页面显示：

现在我在请求时加入who这个参数，http://127.0.0.1:5460/?who=小伙伴们，页面显示:

2.3、@Output 渲染到模板

@Output 则代表了这个参数会被带到模板。

模板在哪里？
在resources目录下的 “rythm+类全名” 目录下，如下图：

这个home.html是生成项目时自动生成的

如上图是home.html的具体内容，@args String who表示传入参数，@act.Act.VERSION.getVersion()表示获取act版本。

这里@args String who，声明的是String类型的参数，如果我们想声明自己的实体类型，得导入，如下：

@import com.demo.entity.User
@args User user

其实除了@import这样的ava代码可用，在这个模板里面，所有@后面的代码都会被转为java代码执行，如下：

不过需要注意的是，大括号内的内容会被直接输出，不能转成 Java 代码。 所以要在大括号块内写java代码，仍需要 @ 符号。

具体rythm语法规则参考：http://rythmengine.org/doc/template_guide.md#introduction

3、一些简单易用的点

版本需 >= 1.8.29

3.1、复写 HTTP Accept

1、访问时允许使用 “_accept” 请求参数来复写 HTTP Accept 请求头

2、访问时允许使用 _accept=qrcode 来生成二维码

3.2、定时任务@Cron

一些常用的 Cron 常量， 方便小伙伴们定义 Cron 作业调度时间

3.3、允许开发轻松定制 API 示例数据来源

API for POST /users

API for GET /users/{id}

3.4、支持 MD 文件为 HTML 页面

参考示例

3.5、双字节字符破坏了命令行列表的布局

代码

以前

现在