## 前言 这几天连续发了几篇关于 `Dart` 开发后端应用的文章,主要是介绍了 `Dart` 的一些优点,比如异步任务,并发处理,编译部署等等。 俗话说,光说不练假把式,今天我们来真正开始一个 `Dart` 后端应用。 ## 我们要开发什么应用 假设我们现在要开发一个社区应用,类似于`掘金`,`CSDN`等等,基本的功能是用户发文章,发观点。 发文章,类似于传统的CMS系统 发观点,类似于现在的微博系统 围绕核心,还有标签,分类,评论等等。 ## 我们用什么框架 既然打算使用 `Dart` 开发,有个开发框架还是有很大帮助的。 然而 `Dart` 的后端框架并不多,`aqueduct`, `jaguar`, `DartMars` 等等, 在这里,我们使用 `DartMars`。 源码在此 https://github.com/tangpanqing/dart_mars 文档在此 https://tangpanqing.github.io/dart_mars_docs/zh/ 打开文档首页,如此  嗯嗯,浓浓的 `vuepress` 味道。 ## 开始一个项目如此简单 根据`DartMars`的指引,在安装`Dart` 后,我们可以执行以下命令来创建项目 ```shell # 安装DartMars dart pub global activate --source git https://github.com/tangpanqing/dart_mars.git # 创建项目 dart pub global run dart_mars --create project_name # 进入目录 cd project_name # 获取依赖 dart pub global run dart_mars --get # 启动项目 dart pub global run dart_mars --serve dev ``` 手摸手,我们一步一步来 ### 第一步,安装DartMars 打开命令行工具,执行 ```shell dart pub global activate --source git https://github.com/tangpanqing/dart_mars.git ``` 感谢墙的存在,我等了将近1分钟,提示我如下: ```shell Activated dart_mars 1.0.4 from Git repository "https://github.com/tangpanqing/dart_mars.git" ``` 这就表示安装好了。 ### 第二步,创建项目 项目暂定名称 `community` 社区,执行如下命令 ```shell dart pub global run dart_mars --create community ``` 经过以上命令,`DartMars` 有了提示 ```shell project community has been created you can change dir with command: cd community and then get dependent with command: dart pub global run dart_mars --get and then start it with command: dart pub global run dart_mars --serve dev ``` 意思说,项目已经创建,接下来你需要进入目录,并且获取依赖,最后执行。 并且显示了相关命令,是不是很贴心? 谈恋爱的时候,一定是个暖男。 ### 第三步,进入目录 执行命令 ```shell cd community ``` ### 第四步,获取依赖 执行命令 ```shell dart pub global run dart_mars --get ``` 经过以上命令,`DartMars` 有了提示 ```shell Got dependencies! ``` 表示加载依赖完成 ### 第五步,启动项目 ```shell dart pub global run dart_mars --serve dev ``` 经过以上命令,`DartMars` 有了提示 ```shell route config file has been updated, see ./lib/config/route.dart $ dart run bin\community.dart --serve dev INFO::2021-07-03 10:14:13.601023::0::Server::Http Server has start, port=80 INFO::2021-07-03 10:14:13.608004::1::Server::Env type is dev INFO::2021-07-03 10:14:13.624571::2::Server::Open browser and vist http://127.0.0.1:80 , you can see some info ``` 启动成功,通过以上信息,我们可知: 1. 路由配置文件已经更新, 2. HTTP 服务已经开始,在80端口,目前使用的是开发环境 打开浏览器,访问 http://127.0.0.1:80 我们就看到了经典的 ```html hello world ``` ## 按部就班地继续编码 先看一眼项目结构  `bin` 目录是执行文件的入口 `lib` 目录是整个项目的开发目录 其他目录都是一些辅助性的,如名字所示。接下来,我们要按部就班的完成基本功能。 先完成第一个,用户的增查改删,并且做成标准,以后使用。 ### 创建用户表 我已经提前准备好了相关的`sql` 语句 ```sql CREATE TABLE IF NOT EXISTS `user` ( `id` int(11) NOT NULL AUTO_INCREMENT, `user_id` varchar(40) COLLATE utf8mb4_general_ci NOT NULL DEFAULT '' COMMENT '用户ID', `user_mobile` varchar(11) COLLATE utf8mb4_general_ci NOT NULL DEFAULT '' COMMENT '用户手机号', `user_password` varchar(60) COLLATE utf8mb4_general_ci NOT NULL DEFAULT '' COMMENT '用户密码', `user_nickname` varchar(60) COLLATE utf8mb4_general_ci NOT NULL DEFAULT '' COMMENT '用户昵称', `user_avatar` varchar(60) COLLATE utf8mb4_general_ci NOT NULL DEFAULT '' COMMENT '用户头像', `user_description` varchar(120) COLLATE utf8mb4_general_ci NOT NULL DEFAULT '' COMMENT '用户介绍', `create_time` bigint(20) NOT NULL DEFAULT '0' COMMENT '创建时间', `update_time` bigint(20) NOT NULL DEFAULT '0' COMMENT '更新时间', `delete_time` bigint(20) NOT NULL DEFAULT '0' COMMENT '删除时间', PRIMARY KEY (`id`), UNIQUE KEY `user_id` (`user_id`), KEY `user_mobile` (`user_mobile`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='用户表'; ``` 放到`mysql` 去执行 ### 创建用户模型 用户模型用来与数据表进行对应的,方便面向对象开发。 在目录 `lib/extend/model/` 下,新建模型文件 `User.dart`,键入如下内容 ```dart class User { int id; String userId; String userMobile; String userPassword; String userNickname; String userAvatar; String userDescription; int createTime; int updateTime; int deleteTime; } ``` 这里只是定义了类名,以及相关属性,还需要补充一些方法。补充模型类的方法,是一个枯燥的事情,建议使用工具。 如果你使用的是 `VSCode`,并且安装了 `Dart Data Class Generator` 插件,此时点击类名,将会出现帮助,点击下图红色框框内,将补充完成代码。  我们将得到以下结果 ```dart import 'dart:convert'; class User { int id; String userId; String userMobile; String userPassword; String userNickname; String userAvatar; String userDescription; int createTime; int updateTime; int deleteTime; User({ this.id, this.userId, this.userMobile, this.userPassword, this.userNickname, this.userAvatar, this.userDescription, this.createTime, this.updateTime, this.deleteTime, }); Map
toMap() { return { 'id': id, 'userId': userId, 'userMobile': userMobile, 'userPassword': userPassword, 'userNickname': userNickname, 'userAvatar': userAvatar, 'userDescription': userDescription, 'createTime': createTime, 'updateTime': updateTime, 'deleteTime': deleteTime, }; } factory User.fromMap(Map
map) { return User( id: map['id'], userId: map['userId'], userMobile: map['userMobile'], userPassword: map['userPassword'], userNickname: map['userNickname'], userAvatar: map['userAvatar'], userDescription: map['userDescription'], createTime: map['createTime'], updateTime: map['updateTime'], deleteTime: map['deleteTime'], ); } String toJson() => json.encode(toMap()); factory User.fromJson(String source) => User.fromMap(json.decode(source)); @override String toString() { return 'User(id: $id, userId: $userId, userMobile: $userMobile, userPassword: $userPassword, userNickname: $userNickname, userAvatar: $userAvatar, userDescription: $userDescription, createTime: $createTime, updateTime: $updateTime, deleteTime: $deleteTime)'; } } ``` 经过刚才的操作,可以看到 多了三个实例化函数 `User`, `User.fromMap`, `User.fromJson` 多了三个方法 `toMap`, `toJson`, `toString` 为什么要做这些,归根到底是因为 `Dart` 禁用反射,当我们从其他地方拿到数据,无法直接转成模型对象。只能先转成`map`,或者`json`字符串,然后再手工转成模型对象。 是稍稍复杂了点,为了更好的性能,不算大问题。 ### 创建服务 服务用来处理实际业务,被控制器所调用。 在目录 `lib/extend/service/` 下,新建服务文件 `UserService.dart`,键入如下内容 ```dart import 'package:community/bootstrap/db/Db.dart'; import 'package:community/bootstrap/db/DbColumn.dart'; import 'package:community/bootstrap/helper/ConvertHelper.dart'; import 'package:community/extend/helper/PasswordHelper.dart'; import 'package:community/extend/helper/TimeHelper.dart'; import 'package:community/extend/helper/UniqueHelper.dart'; import 'package:community/extend/model/Page.dart'; import 'package:community/extend/model/User.dart'; class UserService { static String _table = "user"; /// 分页查询 static Future
> query( List
condition, int pageNum, int pageSize) async { int totalCount = await Db(_table).where(condition).count('*'); List