基于 Hunt Framework 3.2.0 快速构建服务端项目教程
Hunt Framework
是使用 D语言开发的全栈 Web 框架,类似于 Laravel / SpringBoot / Django 等,可以让 D 语言开发者快速的创建项目,内置超多业务规范一是方便开发者开箱即可用,二是方便管理者对项目代码更容易 review。
本示例代码基于目前最新的 Hunt Framework
最新版本 3.2.0
进行编写,接下来让我们感受一下使用 DLang 开发的快感:)
1. 创建一个普通的模板页面渲染项目
1.1 基于骨架项目创建空项目
首先使用 git
命令把骨架项目克隆到本地。
git clone https://github.com/huntlabs/hunt-skeleton.git myproject cd myproject
1.2 修改项目 http 监听地址和 监听端口
http 相关配置项在 config/application.conf
中可以找到如下内容,我们监听的 ip 是 127.0.0.1
端口是 8080
:
http.address = 127.0.0.1 http.port = 8080
1.3 控制器
我们可以看到 source/app/controller/IndexController.d
的源码,这个就是一个普通的控制器,代码如下:
module app.controller.IndexController; import hunt.framework; class IndexController : Controller { mixin MakeController; @Action string index() { return view.render("index"); } }
我们可以看到 index
控制器还有一个 index
的方法,这个方法被使用 @Action 标记为了可访问的页面,而这个页面又使用 view 视图渲染了 index.html
模板(这里模板的扩展名因安全问题被省略)。
这里的视图会渲染 resources/views/default/index.html
模板文件。
1.4 路由配置
在配置文件目录可以找到 config/routes
这个默认的路由配置表,骨架项目有一条记录如下:
GET / index.index
这条语义是使用 GET
方法访问 /
这个 path 会映射到 index
控制器的 index
方法。
1.5 编译运行项目
整个项目使用 dub
包管理器管理,一个命令即可编译运行:
dub run -v
这时候根据你自己配置的 ip 和 端口访问即可:
http://127.0.0.1:8080
至此你的 D 语言项目就跑起来了,是不是很酷?😎那下面章节来点数据库操作。
2 创建一个增删改查的 API 项目
在创建增删改查 API 之前我们需要做一些准备工作,一是创建好数据库的表结构,二是开启框架的路由组支持,让用户可以通过 example.com/api/
或 api.example.com
的形式可以访问到。
2.1 首先我们开启路由组
在 config/application.conf
找到配置项 route.groups
修改为:
route.groups = api:path:api
那我这里解释一下 api:path:api 的含义,{路由组的KEY}:{访问路由组的方式}:{路由组的自定义值},那通过上面这个设置后我们的 api 访问地址前缀就应该是:
http://127.0.0.1:8080/api/
如果我们设置为 route.groups = api:domain:api.example.com
那我们访问 api 地址的前缀就是:
http://api.example.com/
2.2 我们的表结构设计
可以自己执行这个 SQL 创建表,我们数据库使用的是 MySQL 5.7.x 做的 example。
SET NAMES utf8mb4; SET FOREIGN_KEY_CHECKS = 0; -- ---------------------------- -- Table structure for my_user -- ---------------------------- DROP TABLE IF EXISTS `my_users`; CREATE TABLE `my_users` ( `id` bigint(20) NOT NULL AUTO_INCREMENT, `username` varchar(255) DEFAULT NULL, `password` varchar(255) DEFAULT NULL, `email` varchar(255) DEFAULT NULL, `created` bigint(11) DEFAULT NULL, `updated` bigint(11) DEFAULT NULL, PRIMARY KEY (`id`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4; SET FOREIGN_KEY_CHECKS = 1;
2.3 修改数据库相关配置文件
数据库配置项文件在 config/application.conf
进行修改,找到如下配置按照你自己本地数据库环境进行设置:
# Database database.driver = mysql database.host = 127.0.0.1 database.port = 3306 database.database = myproject database.username = root database.password = 123456 database.charset = utf8 database.prefix = my_ database.enabled = true
2.4 创建数据库模型
Hunt Framework
也是内置 Model
模型,我们创建模型类 app/model/User.d
:
module app.model.User; import hunt.entity; @Table("users") class User : Model { mixin MakeModel; @AutoIncrement @PrimaryKey ulong id; string username; string password; string email; uint created; uint updated; }
要注意的是使用 @PrimaryKey
标记 id
为主键,并且使用 @AutoIncrement
标记为自增,@Table("users")
是让你自己填写自己表的真实名字,我们表的真实名是 my_users
,因为所有表前缀已经在 config/application.conf
中的配置项 database.prefix = my_
配置过,所以这里的值我们只需要写 users
即可。
2.5 创建 Repository 对象
这个对象只要继承 EntityRepository
即可,里边已经包含了很多丰富的操作方法,app/repository/UserRepository.d
:
module app.repository.UserRepository; import hunt.framework; import app.model.User; class UserRepostiroy : EntityRepository!(User, ulong) { }
这里我们自定义 UserRepository
继承的 EntityRepository
是 hunt-entity
这个 ORM 库自带的类,我们使用模板传值的方式将我们自定义的 Model 类 User
和主键类型 ulong
传递过去了,这个编译时会帮我们处理很多事情,我们只要记住如何写就好了。
2.6 创建表单验证的类
作为 API 就很难缺少 POST 表单的接收和验证,Hunt Framework
内置表单验证机制,我们需要自己实现一个表单验证的对象 app/form/UserForm.d
:
module app.form.UserForm; import hunt.framework; class UserForm : Form { mixin MakeForm; @Length(4, 30, "用户名长度必须在 {{min}} 到 {{max}} 位之间。") string username; @Length(8, 32, "密码长度必须在 {{min}} 到 {{max}} 位之间。") string password; @NotEmpty("Email地址不允许为空。") string email; }
2.7 创建 API 对应的控制器
因为我们 API 使用的是独立的路由组,所以我们创建控制器的时候需要在 app/controller/
目录下再创建一个子目录 api
来保存对应的控制器类文件,所以我们这个类文件命名为 app/controller/api/UserController.d
:
module app.controller.api.UserController; import hunt.framework; import app.repository.UserRepostiroy; import app.model.User; import app.message.ResultMessage; import app.form.UserForm; class UserController : Controller { mixin MakeController; @Action Response add(UserForm form) { // ResultMessage 是要返回的 json 消息体 auto resultMessage = new ResultMessage; // 使用 valid() 方法获取一个校验结果对象 auto valid = form.valid(); if (!valid.isValid()) { // 给个错误码 resultMessage.code = 10001; // valid.messages() 方法可以获取所有错误信息,我们这里只简单的获取一个错误进行返回 foreach (message; valid.messages()) { resultMessage.message = message; break; } } else { auto repository = new UserRepository; auto user = new User; user.username = form.username; user.password = form.password; user.email = form.email; // 把模型数据保存到数据库 repository.save(user); // 因没有错误就不需要设置错误码,提示添加成功即可 import std.format : format; resultMessage.message = format!"用户( %d )添加成功!"(user.id); } // 返回结果对象会自动由 JsonResponse 序列化为 json 返回给客户端 return new JsonResponse(resultMessage); } }
这里是 ReusltMessage 的代码: app/message/ReusultMessage.d
module app.message.ResultMessage; class ResultMessage { uint code = 0; string message; }
2.8 API 路由配置文件
每个路由组有自己的路由配置表,api
的路由配置表是 config/api.routes
,这个规则是不是很简单?我们看看添加用户接口的路由配置项:
POST /user/add user.add
是不是很简单?这里因为是 api.routes
所以控制器会在 app/controller/api/
目录下找对应的 user
控制器和 add
方法。
2.9 测试添加用户接口
这里我们使用 Firefox 插件进行接口请求,我们按照表单的要求添加 3 个字段,分别为 username
、password
、email
,我们也按照 UserForm
中的验证规则去填写,当我们提交表单的时候可以看到如下界面:
这里提示 用户( 9 )添加成功!
,这里的数字 9
其实是我们在将用户数据写入库中以后返回的主键 ID。
那我们为了测试表单校验的作用,我们把密码从 8 位改为 6 位,因为我们在 UserForm
中规则设定的是 8~32 位之间,再次提交表单如下结果:
这里说明我们的表单校验已经起了作用:)
3 总结
最总完成的项目目录结构如下:
MYRPOJECT/ ├── config │ ├── api.routes │ ├── application.conf │ └── routes ├── data │ └── mysql.sql ├── dub.sdl ├── resources │ ├── translations │ │ ├── en-us │ │ │ └── message.ini │ │ └── zh-cn │ │ └── message.ini │ └── views │ └── default │ ├── footer.html │ ├── header.html │ └── index.html ├── source │ ├── app │ │ ├── controller │ │ │ ├── IndexController.d │ │ │ └── api │ │ │ └── UserController.d │ │ ├── form │ │ │ └── UserForm.d │ │ ├── message │ │ │ └── ResultMessage.d │ │ ├── model │ │ │ └── User.d │ │ └── repository │ │ └── UserRepository.d │ └── main.d └── wwwroot └── favicon.ico
整个项目看下来也算是清晰明了,在框架的使用方式上有着熟悉的味道,Hunt Framework
有着像 Laravel
那么快的开发效率,也有像 SpringBoot
那样规范的数据库操作方式,也具有像 golang
一样有原生语言编译后方便的部署方式。
相关资源地址
- HuntLabs 官方网站: https://www.huntlabs.net
- Hunt Framework 代码库: https://github.com/huntlabs/hunt-framework
- 完整示例代码: https://gitee.com/zoujiaqing/example-myuser
低调大师中文资讯倾力打造互联网数据资讯、行业资源、电子商务、移动互联网、网络营销平台。
持续更新报道IT业界、互联网、市场资讯、驱动更新,是最及时权威的产业资讯及硬件资讯报道平台。
转载内容版权归作者及来源网站所有,本站原创内容转载请注明来源。
- 上一篇
BigDecimal使用不当,老板的损失照样从你工资里扣
云栖号资讯:【点击查看更多行业资讯】在这里您可以找到不同行业的第一手的上云资讯,还在等什么,快来! 我们基本已经形成了常识,需要用到金钱的地方要用 BigDecimal 而不是其他,而我们也都知道浮点型变量在进行计算的时候会出现丢失精度的问题。 那么,你知道其实 BigDecimal 也会丢失精度吗?而使用 BigDecimal 的背后又有什么值得去探究的地方吗?今天,告诉你,知其然,也知其所以然。 如下一段代码: System.out.println(0.05 + 0.01); System.out.println(1.0 - 0.42); System.out.println(4.015 * 100); System.out.println(123.3 / 100); 输出:0.0600000000000000050.5800000000000001401.499999999999941.2329999999999999 可以看到在 Java 中进行浮点数运算的时候,会出现丢失精度的问题。那么我们如果在进行商品价格计算的时候,就会出现问题。很有可能造成我们手中有 0.06 元,却无...
- 下一篇
聚焦5G+AIoT新蓝海 | Linux Foundation开源软件大学-开源技术日直播首秀
近年来,随着开源技术的热度持续攀升,越来越多的国内开发者开始了解开源、学习开源、使用开源、回馈开源。中国拥有众多开源技术爱好者和参与者,学习和利用开源技术已经成为互联网技术人才的必备技能。而对于企业来说,利用开源技术提升企业技术实力也已成为国内科技企业的共识。 Linux Foundation开源软件大学(官网地址:training.linuxfoundation.cn)是Linux基金会中国区官方培训网站,拥有非常丰富的培训课程体系和培训认证品牌,致力于为爱好开源的中国开发者提供帮助,为广大企业培养优秀的软件人才。 Linux Foundation开源软件大学除了让开源技术培训更好地服务中国开发者外,更充分利用自身资源,联合国内外顶尖开源基金会、开源组织、开源项目开发者、开源社区,举办丰富开源技术线上活动,帮助更多开发者接触开源技术、深入了解开源技术。 在这样的初衷下,开源技术日系列活动应运而生。开源技术日是由Linux Foundation开源软件大学联合开源中国和GDG共同主办的开源技术大讲堂,每次都会选出不同的主题,邀请资深技术嘉宾与众多开源技术爱好者一起分享和探讨。 首次开源...
相关文章
文章评论
共有0条评论来说两句吧...
文章二维码
点击排行
推荐阅读
最新文章
- CentOS7设置SWAP分区,小内存服务器的救世主
- Docker安装Oracle12C,快速搭建Oracle学习环境
- Docker快速安装Oracle11G,搭建oracle11g学习环境
- CentOS7编译安装Gcc9.2.0,解决mysql等软件编译问题
- SpringBoot2整合MyBatis,连接MySql数据库做增删改查操作
- CentOS8安装MyCat,轻松搞定数据库的读写分离、垂直分库、水平分库
- SpringBoot2整合Thymeleaf,官方推荐html解决方案
- Mario游戏-低调大师作品
- 2048小游戏-低调大师作品
- SpringBoot2初体验,简单认识spring boot2并且搭建基础工程