是新朋友吗？记得先点蓝字关注我哦～
“ Github上最近出现了一个数据聚合的项目，有很多Start数，号主已经入坑，为什么入坑呢？因为Hasor号称能够不写Controller、Service、Dao、Mapper等项目通用结构，这很吸引人啊，所以号主就入坑看了看是否真的有那么神奇”
一、先来了解一下Hasor
介绍：面向生产环境而设计的 Java 应用开发框架。它的核心设计目标是提供一个简单的交互接口给开发者，开发者可以在此基础上灵活的构建自己的应用程序。无论是应用类程序还是框架类工具，Hasor 都会给予你最有力的支持。
区别于其它框架的是 Hasor 有着自己一套完整的扩展体系。无论您是一般的应用工程，还是开发工具框架类项目。Hasor都会是一个强有力的基石。
特点：
“微内核+插件” 简单、小巧、功能强大、使用简单。
COC原则的最佳实践，‘零’配置文件。
合理的整体架构规划，即是小框架也是大平台。
各部分全部独立，按需使用，绝不臃肿。
体积小，无依赖。
最低要求环境jdk8
技术体系：
二、创建一个SpringBoot项目，添加Hasor依赖
创建一个简单的SpringBoot项目，然后在Maven中添加hasor-spring连通Hasor和Spring，使得能够在SpringBoot中使用hasor，添加hasor-dataway让我们能够不用写Controller这些东西而通过页面配置接口的方式将数据和接口设计出来；一个Jdbc连接，用于连接Mysql数据库，注意使用Hasor-dataway必须使用数据库，配置也必须在数据库中配置两个表。
项目的Maven依赖如下：(以下依赖最好使用Hasor的最新版本，现在迭代速度还是很快的，旧版本可能会存在一些问题)
1.8 org.springframework.boot spring-boot-starter-web net.hasor hasor-spring 4.1.7 net.hasor hasor-dataway 4.1.7 mysql mysql-connector-java runtime org.springframework.boot spring-boot-starter-jdbc 打开数据库，创建两个新的表，用于维护dataway的API,建表建议参考官方网站的，因为不同版本的Hasor依赖的表的字段可能是不同的。
建表语句如下(如果出现表问题，可以参照官方网站修改)
CREATE TABLE `interface_info` ( `api_id` int(11) NOT NULL AUTO_INCREMENT COMMENT 'ID', `api_method` varchar(12) NOT NULL COMMENT 'HttpMethod：GET、PUT、POST', `api_path` varchar(512) NOT NULL COMMENT '拦截路径', `api_status` int(2) NOT NULL COMMENT '状态：0草稿，1发布，2有变更，3禁用', `api_comment` varchar(255) DEFAULT NULL COMMENT '注释', `api_type` varchar(24) NOT NULL COMMENT '脚本类型：SQL、DataQL', `api_script` mediumtext NOT NULL COMMENT '查询脚本：xxxxxxx', `api_schema` mediumtext COMMENT '接口的请求/响应数据结构', `api_sample` mediumtext COMMENT '请求/响应/请求头样本数据', `api_option` mediumtext COMMENT '扩展配置信息', `api_create_time` datetime DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间', `api_gmt_time` datetime DEFAULT CURRENT_TIMESTAMP COMMENT '修改时间', PRIMARY KEY (`api_id`)) ENGINE=InnoDB AUTO_INCREMENT=7 DEFAULT CHARSET=utf8mb4 COMMENT='Dataway 中的API';CREATE TABLE `interface_release` ( `pub_id` int(11) NOT NULL AUTO_INCREMENT COMMENT 'Publish ID', `pub_api_id` int(11) NOT NULL COMMENT '所属API ID', `pub_method` varchar(12) NOT NULL COMMENT 'HttpMethod：GET、PUT、POST', `pub_path` varchar(512) NOT NULL COMMENT '拦截路径', `pub_status` int(2) NOT NULL COMMENT '状态：0有效，1无效(可能被下线)', `pub_type` varchar(24) NOT NULL COMMENT '脚本类型：SQL、DataQL', `pub_script` mediumtext NOT NULL COMMENT '查询脚本：xxxxxxx', `pub_script_ori` mediumtext NOT NULL COMMENT '原始查询脚本，仅当类型为SQL时不同', `pub_schema` mediumtext COMMENT '接口的请求/响应数据结构', `pub_sample` mediumtext COMMENT '请求/响应/请求头样本数据', `pub_option` mediumtext COMMENT '扩展配置信息', `pub_release_time` datetime DEFAULT CURRENT_TIMESTAMP COMMENT '发布时间(下线不更新)', PRIMARY KEY (`pub_id`), KEY `idx_interface_release` (`pub_api_id`)) ENGINE=InnoDB AUTO_INCREMENT=9 DEFAULT CHARSET=utf8mb4 COMMENT='Dataway API 发布历史。';三、整合SpringBoot和Hasor
SpringBoot整合Hasor中的dataway主要是将数据也配置到Hasor中，同时在启动入口开启Hasor和Hasor-web。整合起来也是十分的简单。
import net.hasor.core.ApiBinder;import net.hasor.core.DimModule;import net.hasor.db.JdbcModule;import net.hasor.db.Level;import net.hasor.spring.SpringModule;import org.springframework.stereotype.Component;import javax.sql.DataSource;@DimModule // Hasor 中的标签，表明是一个Hasor的model@Component // Spring 中的标签，表明是一个组件public class HasorComponent implements SpringModule { private final DataSource dataSource; public HasorComponent(DataSource dataSource){ this.dataSource = dataSource; } /** * Hasor 启动的时候会调用 loadModule 方法， * 在这里再把 DataSource 设置到 Hasor 中。 * @param apiBinder * @throws Throwable */ @Override public void loadModule(ApiBinder apiBinder) throws Throwable { apiBinder.installModule(new JdbcModule(Level.Full, this.dataSource)); }}启动类代码如下：
import net.hasor.spring.boot.EnableHasor;import net.hasor.spring.boot.EnableHasorWeb;import org.springframework.boot.SpringApplication;import org.springframework.boot.autoconfigure.SpringBootApplication;/** * 启用Hasor */@EnableHasor@EnableHasorWeb // 将 hasor-web 配置到 Spring 环境中，Dataway 的 UI 是通过 hasor-web 提供服务。@SpringBootApplicationpublic class QueryApplication { public static void main(String[] args) { SpringApplication.run(QueryApplication.class, args); }}server: port: 9800spring: profiles: active: dev# 是否启用 Dataway 功能(必选：默认false)HASOR_DATAQL_DATAWAY: true# 是否开启 Dataway 后台管理界面(必选：默认false)HASOR_DATAQL_DATAWAY_ADMIN: true# dataway API工作路径(可选，默认：/api/)HASOR_DATAQL_DATAWAY_API_URL: /interface/# dataway-ui 的工作路径(可选，默认：/interface-ui/)HASOR_DATAQL_DATAWAY_UI_URL: /config/# SQL执行器方言设置(可选，建议设置)HASOR_DATAQL_FX_PAGE_DIALECT: mysqlspring: datasource: url: jdbc:mysql://127.0.0.1:3306/test?characterEncoding=UTF-8&serverTimezone=UTC&useSSL=false&allowPublicKeyRetrieval=true username: root password: 123456 driver-class-name: com.mysql.cj.jdbc.Driver四、配置数据接口
在程序正常启动以后，在浏览器中打开DatawayAPI的配置页面，因为我在application.yml文件修改了默认UI页面地址，自己和自己的对应上就好了，地址：http://127.0.0.1:9800/config/
这里注意一下地址后面的/也要有,第一次打开会慢一点。打开后DatawayAPI配置页面如下图：
CREATE TABLE `animal` ( `id` bigint(20) NOT NULL AUTO_INCREMENT COMMENT '自增主键', `name` varchar(20) NOT NULL COMMENT '动物名称', `alias` varchar(40) NOT NULL COMMENT '动物别名', `description` varchar(300) DEFAULT '' COMMENT '动物描述', `inputtime` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '动物信息入机时间', `updatetime` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '动物信息更新时间', PRIMARY KEY (`id`)) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;INSERT INTO animal (name,alias,description) VALUES ('西伯利亚猩猩','黑猩猩','西伯利亚');INSERT INTO animal (name,alias,description) VALUES ('东北虎','大脑虎','东北地区');INSERT INTO animal (name,alias,description) VALUES ('孔雀','白孔雀','北京动物园');INSERT INTO animal (name,alias,description) VALUES ('狮子','辛巴','影视');INSERT INTO animal (name,alias,description) VALUES ('边境牧羊犬','边牧','家中');INSERT INTO animal (name,alias,description) VALUES ('西伯利亚雪橇犬','二哈','富足家庭中');INSERT INTO animal (name,alias,description) VALUES ('蓝猫','猫','家养');INSERT INTO animal (name,alias,description) VALUES ('大熊猫','国宝','北京动物园');
五、新建一个Dataway接口
首先介绍一些Dataway的基本知识，Dataway可以通过UI页面定义数据接口，然后通过自测和冒烟以后才能发布这个接口，当接口发布成功以后，就可以通过我们定义的接口路径来访问获取数据了，这些接口数据都是保存在我们上面创建的interface_info表中的，当然接口发布以后也可以修改，也即接口可以有历史版本，这些信息保存在interface_release 表中，这也就是为什么我们什么要在上面定义这两个表；(Ps:当然Dataway也可以通过编写代码来实现)在Dataway的数据访问中使用的是一种名字叫做DataQL的脚本语言，类似JavaScript 先来一段官网的说明定义:
DataQL(Data Query Language)DataQL 是一种查询语言。旨在通过提供直观、灵活的语法来描述客户端应用程序的数据需求和交互。
数据的存储根据其业务形式通常是较为简单的，并不适合直接在页面上进行展示。因此开发页面的前端工程师需要为此做大量的工作，这就是 DataQL 极力解决的问题。另外还支持使用SQL来，但是SQL在Dataway中最终也都是转换成DataQL。
Dataway页面说明：
1、功能按钮：可以查看所有已经发布的接口
2、功能按钮：可以创建新的接口
3、链接：打开DataQL接口说明
4、请求方式：Http请求方式定义，默认是POST方法
5、接口路径：定义接口的请求路径，/interface/为配置文件中HASOR_DATAQL_DATAWAY_API_URL属性事先定义的值，后面补充路径，当接口路径发布后，后面定义的接口请求路径不能重名
6、接口说明：可以为接口添加中文说明
7、使用DataQL编写接口，默认选择为DataQL
8、使用SQl编写接口
9、接口编写代码部分
10、功能按钮：保存9部分编写的代码，注意只有先保存才能进行冒烟测试
11、功能按钮：测试按钮，当编写接口代码时，使用此按钮进行接口测试
12、功能按钮：冒烟测试按钮，通过了冒烟测试以后才能发布
13、功能按钮：发布接口，发布接口以后以后就可以通过发布的接口获取数据
14、功能按钮：接口编辑历史记录，可以通过历史记录回滚9区域的代码
15、功能按钮：删除按钮，点击删除后删除已经发布的接口(数据库中也会清除这条记录)
16、18功能区域：这个区域可以设置接口的请求参数例如通过POST方法传输一个请求报文，在此区域定义
17、功能按钮：设置接口的请求头参数
19、功能区域：测试接口区域，点击11测试按钮或者12冒烟以后在此区域显示测试结果
1)在介绍完了页面的基本功能以后，新建一个请求接口。在页面中点击【new】新建一个数据接口，请求方式设置为【GET】方法，路径为【querytest】，接口说明为【请求接口GET方法测试】，选择使用【DataQL】开发(功能会更强大一点)，编写代码部分的主要功能为查询数据中动物表(animal)中的(name)字段中包含犬的数据，接口参数设置为【name】传输要查询包含某个字的动物数据代码如下：// 查询动物表中名字中包含犬的数据// 定义一个函数，将函数的查询结果存贮在querydog中// @@sql()为插入外部SQL代码，为SQl代码区域// name为函数的参数，如果想要在SQL使用这个参数，需要使用#{name}来使用// #,$,@都为特殊符号，一般情况下用法一致，更多用法可参考官方说明var querydog = @@sql(name) select * from animal where name like #{name}%>// 返回上述SQL查询到的数据// 通过$获取Parameters中的传过来的name 参数值return querydog(${name});
// 查询动物表中名字中包含犬的数据// 定义一个函数，将函数的查询结果存贮在querydog中// @@sql()为插入外部SQL代码，为SQl代码区域// name为函数的参数，如果想要在SQL使用这个参数，需要使用#{name}来使用// #,$,@都为特殊符号，一般情况下用法一致，更多用法可参考官方说明var querydog = @@sql(name) select * from animal where name like %#{name}%%>// 返回上述SQL查询到的数据// 通过$获取Parameters中的传过来的name 参数值// 修改返回报文中的将id换成编号，name 换成动物名称 诸如此类......// 查询到的数据包含多个对象，注意格式 [{}]，不然只显示一个return querydog(${name})=>[{ "编号":id, "动物名称":name, "动物别名":alias, "动物描述":description, "动物信息入机时间":inputtime, "动物信息更新时间":updatetime}]
添加DataQL中的FunctionX函数将时间戳改为我们指定格式时间格式，首先需要引入日期这个函数，as的作用相当于起一个别名来使用这个函数：
import 'net.hasor.dataql.fx.basic.DateTimeUdfSource' as time;在返回数据调用format方式格式化时间如下：
// 定义一个处理updatetime日期格式的函数var formatupdatetime = (updatetime)->{ return time.format(updatetime, "yyyy-MM-dd HH:mm:ss")}// 返回上述SQL查询到的数据// 通过$获取Parameters中的传过来的name 参数值// 修改返回报文中的将id换成编号，name 换成动物名称 诸如此类......// 查询到的数据包含多个对象，注意格式 [{}]，不然只显示一个// 调用日期函数，将Long类型的时间戳输出为格式化的时间// dang然也可以定义一个函数来进行处理，如上的formatupdatetime函数return querydog(${name})=>[{ "编号":id, "动物名称":name, "动物别名":alias, "动物描述":description, "动物信息入机时间":time.format(inputtime, "yyyy-MM-dd HH:mm:ss"), "动物信息更新时间": formatupdatetime(updatetime)}]最后的整体代码如下：
import 'net.hasor.dataql.fx.basic.DateTimeUdfSource' as time;// 查询动物表中名字中包含犬的数据// 定义一个函数，将函数的查询结果存贮在querydog中// @@sql()为插入外部SQL代码，为SQl代码区域// name为函数的参数，如果想要在SQL使用这个参数，需要使用#{name}来使用// #,$,@都为特殊符号，一般情况下用法一致，更多用法可参考官方说明var querydog = @@sql(name) select * from animal where name like #{name}%>// 定义一个处理updatetime日期格式的函数var formatupdatetime = (updatetime)->{ return time.format(updatetime, "yyyy-MM-dd HH:mm:ss")}// 返回上述SQL查询到的数据// 通过$获取Parameters中的传过来的name 参数值// 修改返回报文中的将id换成编号，name 换成动物名称 诸如此类......// 查询到的数据包含多个对象，注意格式 [{}]，不然只显示一个// 调用日期函数，将Long类型的时间戳输出为格式化的时间// dang然也可以定义一个函数来进行处理，如上的formatupdatetime函数return querydog(${name})=>[{ "编号":id, "动物名称":name, "动物别名":alias, "动物描述":description, "动物信息入机时间":time.format(inputtime, "yyyy-MM-dd HH:mm:ss"), "动物信息更新时间": formatupdatetime(updatetime)}]
然后我们在浏览器中直接输入已经发布的API ，测试能否获取我们预想的数据；
注意这里我们设置成GET请求方式，需要入参为name的值，请求路径应如：http://127.0.0.1:9800/interface/querytest?name=%犬%
这与POST请求方式不同；(这里的接口设计是有一定问题的，我们为了模糊查询在参数中传入了%，中文转码以后会有冲突，可以换成数据库name为边境牧羊犬进行查询或者使用Postman传参)
使用Postman的测试结果如下：
六、新建一个POST 接口与GET接口进行比较
之所以要进行POST接口与GET接口的请求比较主要是因为POST的入参方式和GET方式的不同，究其根本其实也就是POST与GET方法的区别；我们还是复用上面的那个已经写好了的接口，但是定义成POST请求方式；
这里就没有办法通过浏览器来测试接口的返回数据了，因为浏览器默认使用的是GET方法，这里我们使用Postman进行测试；
这就是GET方法的API和POST方法API的区别，当然更多玩法可以参看官方文档：Hasor官方文档
七、总结总结一下，个人觉得Hasor还是有很多优点的，例如可以和方便的与SpringBoot结合，可以不用写Controller、service、dao、mapper这一套东西，可以动态修改配置API等等；但是缺点也是有的，个人觉得这东西还很年轻，有一定的学习成本(例如要学习DataQL)等等这些。
客官，都看到这里了记得给我点个赞哦
点亮你的【看一看吧】
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
