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

阳光穿透心脏的1/2处 2023-10-08 13:02 9阅读 0赞

#### 文章目录 ####

*  写在前面
 *   *  1、快速开始一个act项目
     *  2、AppEntry 启动类
     *   *  2.1、@GetAction GET请求
         *  2.2、@DefaultValue 入参默认值
         *  2.3、@Output 渲染到模板
     *  3、一些简单易用的点
     *   *  3.1、复写 HTTP Accept
         *  3.2、定时任务@Cron
         *  3.3、允许开发轻松定制 API 示例数据来源
         *  3.4、支持 MD 文件为 HTML 页面
         *  3.5、双字节字符破坏了命令行列表的布局

## 写在前面 ##

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

之后输入分组、版本等信息  
![在这里插入图片描述][77f68340bc2347b183b690f37d7cdbaa.png]  
接着用idea打开这个项目  
![在这里插入图片描述][0405c6b4bf7843c681a2f9f9ab9c7fea.png]  
运行 AppEntry主方法可启动这个项目  
![在这里插入图片描述][97f45b37cc61474dbb0f82c275ae2fd6.png]  
日志中会打印访问地址：http://127.0.0.1:5460  
![在这里插入图片描述][8cd618848c1d4ae99c7a089074a114e3.png]

### 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/，页面显示：  
![在这里插入图片描述][0cd2319ea4d448d68411c26741439024.png]  
现在我在请求时加入who这个参数，http://127.0.0.1:5460/?who=小伙伴们，页面显示:  
![在这里插入图片描述][cb7e27889d624dfab61b98458c4bb65f.png]

#### 2.3、@Output 渲染到模板 ####

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

模板在哪里？  
在resources目录下的 “rythm+类全名” 目录下，如下图：  
![在这里插入图片描述][de26b2d708c54b0c92d125c3ace08e5f.png]  
这个home.html是生成项目时自动生成的  
![在这里插入图片描述][ee070507a927450d99b05b67f0498cf1.png]  
如上图是home.html的具体内容，@args String who表示传入参数，@act.Act.VERSION.getVersion()表示获取act版本。

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

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

![在这里插入图片描述][033ee0baca0d4951815f6fa5e1c9f5ea.png]  
其实除了@import这样的ava代码可用，在这个模板里面，所有@后面的代码都会被转为java代码执行，如下：  
![在这里插入图片描述][8f49b145aca24f4ab49ac7c956d7a335.png]  
不过需要注意的是，大括号内的内容会被直接输出，不能转成 Java 代码。 所以要在大括号块内写java代码，仍需要 @ 符号。

具体[rythm语法规则][rythm]参考：http://rythmengine.org/doc/template\_guide.md\#introduction

### 3、一些简单易用的点 ###

版本需 >= 1.8.29

#### 3.1、复写 HTTP Accept ####

1、访问时允许使用 “\_accept” 请求参数来复写 HTTP Accept 请求头  
![在这里插入图片描述][f4fd2a9222394798b308b83780017af9.gif_pic_center]  
2、访问时允许使用 \_accept=qrcode 来生成二维码  
![在这里插入图片描述][c663ecb0984845c48267e1dc4e47182b.gif_pic_center]

#### 3.2、定时任务@Cron ####

一些常用的 Cron 常量， 方便小伙伴们定义 Cron 作业调度时间  
![在这里插入图片描述][168ef99ac6314de8baa438b1ec779ee9.gif_pic_center]

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

![在这里插入图片描述][9f2a33665be8484fabf6906df3a61f6e.png]

API for POST /users  
![在这里插入图片描述][5a8cad24eb49474882eabc3df29a3e35.png]  
API for GET /users/\{id\}

![在这里插入图片描述][355a9727fdad44a0ab83ff031f6b4946.png]

#### 3.4、支持 MD 文件为 HTML 页面 ####

![在这里插入图片描述][8fba172c0b0e4124927bb4d14957f3e3.png]  
[参考示例][Link 1]

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

代码  
![在这里插入图片描述][15715f9fb64a4020b00cfccb5ca9fa8c.png]  
以前  
![在这里插入图片描述][12a41f67578941488976ea2d075faa50.png]  
现在  
![在这里插入图片描述][1463608dbd9045cba66249b7f84afe2e.png]

[77f68340bc2347b183b690f37d7cdbaa.png]: https://img-blog.csdnimg.cn/77f68340bc2347b183b690f37d7cdbaa.png
[0405c6b4bf7843c681a2f9f9ab9c7fea.png]: https://img-blog.csdnimg.cn/0405c6b4bf7843c681a2f9f9ab9c7fea.png
[97f45b37cc61474dbb0f82c275ae2fd6.png]: https://img-blog.csdnimg.cn/97f45b37cc61474dbb0f82c275ae2fd6.png
[8cd618848c1d4ae99c7a089074a114e3.png]: https://img-blog.csdnimg.cn/8cd618848c1d4ae99c7a089074a114e3.png
[0cd2319ea4d448d68411c26741439024.png]: https://img-blog.csdnimg.cn/0cd2319ea4d448d68411c26741439024.png
[cb7e27889d624dfab61b98458c4bb65f.png]: https://img-blog.csdnimg.cn/cb7e27889d624dfab61b98458c4bb65f.png
[de26b2d708c54b0c92d125c3ace08e5f.png]: https://img-blog.csdnimg.cn/de26b2d708c54b0c92d125c3ace08e5f.png
[ee070507a927450d99b05b67f0498cf1.png]: https://img-blog.csdnimg.cn/ee070507a927450d99b05b67f0498cf1.png
[033ee0baca0d4951815f6fa5e1c9f5ea.png]: https://img-blog.csdnimg.cn/033ee0baca0d4951815f6fa5e1c9f5ea.png
[8f49b145aca24f4ab49ac7c956d7a335.png]: https://img-blog.csdnimg.cn/8f49b145aca24f4ab49ac7c956d7a335.png
[rythm]: http://rythmengine.org/doc/template_guide.md#introduction
[f4fd2a9222394798b308b83780017af9.gif_pic_center]: https://img-blog.csdnimg.cn/f4fd2a9222394798b308b83780017af9.gif#pic_center
[c663ecb0984845c48267e1dc4e47182b.gif_pic_center]: https://img-blog.csdnimg.cn/c663ecb0984845c48267e1dc4e47182b.gif#pic_center
[168ef99ac6314de8baa438b1ec779ee9.gif_pic_center]: https://img-blog.csdnimg.cn/168ef99ac6314de8baa438b1ec779ee9.gif#pic_center
[9f2a33665be8484fabf6906df3a61f6e.png]: https://img-blog.csdnimg.cn/9f2a33665be8484fabf6906df3a61f6e.png
[5a8cad24eb49474882eabc3df29a3e35.png]: https://img-blog.csdnimg.cn/5a8cad24eb49474882eabc3df29a3e35.png
[355a9727fdad44a0ab83ff031f6b4946.png]: https://img-blog.csdnimg.cn/355a9727fdad44a0ab83ff031f6b4946.png
[8fba172c0b0e4124927bb4d14957f3e3.png]: https://img-blog.csdnimg.cn/8fba172c0b0e4124927bb4d14957f3e3.png
[Link 1]: https://github.com/act-gallery/simple-crud-service
[15715f9fb64a4020b00cfccb5ca9fa8c.png]: https://img-blog.csdnimg.cn/15715f9fb64a4020b00cfccb5ca9fa8c.png
[12a41f67578941488976ea2d075faa50.png]: https://img-blog.csdnimg.cn/12a41f67578941488976ea2d075faa50.png
[1463608dbd9045cba66249b7f84afe2e.png]: https://img-blog.csdnimg.cn/1463608dbd9045cba66249b7f84afe2e.png