Dataway接口配置服务,去掉后台,从此告别Controller、Service、Mapping
博客(coder的自我修养)原文链接:http://www.imcoder.fun/archives/1591174066705
1、Dataway介绍
Dataway 是基于 DataQL 服务聚合能力,为应用提供的一个接口配置工具。使得使用者无需开发任何代码就配置一个满足需求的接口。 整个接口配置、测试、冒烟、发布。一站式都通过 Dataway 提供的 UI 界面完成。UI 会以 Jar 包方式提供并集成到应用中并和应用共享同一个 http 端口,应用无需单独为 Dataway 开辟新的管理端口。
这种内嵌集成方式模式的优点是,可以使得大部分老项目都可以在无侵入的情况下直接应用 Dataway。进而改进老项目的迭代效率,大大减少企业项目研发成本。
Dataway 工具化的提供 DataQL 配置能力。这种研发模式的变革使得,相当多的需求开发场景只需要配置即可完成交付。 从而避免了从数据存取到前端接口之间的一系列开发任务,例如:Mapper、BO、VO、DO、DAO、Service、Controller 统统不在需要。
2、SpringBoot整合
Dataway 是 Hasor 生态中的一员,使用 Dataway 第一步需要通过 hasor-spring 打通两个生态。
目前最新版本是4.1.8
maven依赖
<!-- hasor依赖 -->
<dependency><groupId>net.hasor</groupId><artifactId>hasor-spring</artifactId><version>4.1.8</version><!-- 查看最新版本:https://mvnrepository.com/artifact/net.hasor/hasor-spring -->
</dependency>
<dependency><groupId>net.hasor</groupId><artifactId>hasor-dataway</artifactId><version>4.1.8</version><!-- 查看最新版本:https://mvnrepository.com/artifact/net.hasor/hasor-dataway -->
</dependency>
<!-- 数据库依赖 -->
<dependency><groupId>mysql</groupId><artifactId>mysql-connector-java</artifactId><scope>runtime</scope>
</dependency>
<dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-jdbc</artifactId>
</dependency>
配置Dataway
在application.properties或者application.yml中添加Dataway的配置,示例配置如下
# 端口
server.port=8088# 数据源
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver
spring.datasource.url=jdbc:mysql://127.0.0.1:3306/dataway?serverTimezone=Asia/Shanghai&useUnicode=true&characterEncoding=utf8&useSSL=false
spring.datasource.username=root
spring.datasource.password=root# 是否启用 Dataway 功能(必选:默认false)
HASOR_DATAQL_DATAWAY=true# 是否开启 Dataway 后台管理界面(必选:默认false)
HASOR_DATAQL_DATAWAY_ADMIN=true# dataway API工作路径(可选,默认:/api/)
HASOR_DATAQL_DATAWAY_API_URL=/api/# dataway-ui 的工作路径(可选,默认:/interface-ui/)
HASOR_DATAQL_DATAWAY_UI_URL=/interface-ui/# SQL执行器方言设置(可选,建议设置)
HASOR_DATAQL_FX_PAGE_DIALECT=mysql
创建Dataway所需表
Dataway需要两张表 interface_info、interface_release 来存储相关接口信息,建表语句如下
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) NULL COMMENT '注释',`api_type` varchar(24) NOT NULL COMMENT '脚本类型:SQL、DataQL',`api_script` mediumtext NOT NULL COMMENT '查询脚本:xxxxxxx',`api_schema` mediumtext NULL COMMENT '接口的请求/响应数据结构',`api_sample` mediumtext NULL COMMENT '请求/响应/请求头样本数据',`api_option` mediumtext NULL 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=0 DEFAULT CHARSET=utf8mb4 COMMENT='Dataway 中的API';create unique index idx_interface_info on interface_info (api_method, api_path);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 NULL COMMENT '接口的请求/响应数据结构',`pub_sample` mediumtext NULL COMMENT '请求/响应/请求头样本数据',`pub_option` mediumtext NULL COMMENT '扩展配置信息',`pub_release_time`datetime DEFAULT CURRENT_TIMESTAMP COMMENT '发布时间(下线不更新)',PRIMARY KEY (`pub_id`)
) ENGINE=InnoDB AUTO_INCREMENT=0 DEFAULT CHARSET=utf8mb4 COMMENT='Dataway API 发布记录';create index idx_interface_release on interface_release (pub_api_id);
这些建表语句在hasor-dataway-xxx.jar中可以直接找到,如下图
初始化数据源
将 Spring 使用的数据源导入到 Hasor 环境供 Dataway 使用。
package fun.imcoder.cloud.dataway.hasor;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.annotation.Resource;
import javax.sql.DataSource;@DimModule
@Component
public class HasorModule implements SpringModule {@Resourceprivate DataSource dataSource;@Overridepublic void loadModule(ApiBinder apiBinder) throws Throwable {apiBinder.installModule(new JdbcModule(Level.Full, this.dataSource));}
}
启动工程
在SpringBoot工程的启动类上加上@EnableHasor和@EnableHasorWeb两个注解即可
package fun.imcoder.cloud.dataway;import net.hasor.spring.boot.EnableHasor;
import net.hasor.spring.boot.EnableHasorWeb;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;@SpringBootApplication
@EnableHasor
@EnableHasorWeb
public class DatawayApplication {public static void main(String[] args) {SpringApplication.run(DatawayApplication.class, args);}}
启动后出现如下日志信息说明整合成功
3、配置接口
项目启动完成后,我们就可以访问接口配置页面了,接口地址:http://127.0.0.1:8088/interface-ui/#/
页面如下
上如中我已经新建好了一个接口,下面我们再来新建一个接口,点解 +New 如下图所示
我们新建接口 /api/user/list做为用户列表查询接口,sql模式我们选择SQL,在接口编写去填写最简单的sql查询语句 select * from user 然后点击执行,如下图所示
可以看到我们已经得到了想要的接口,然后我们点击保存、冒烟测试最后发布就成功配置了一个接口,发布之后,我们用postman来测试一下接口
可以看到,接口可以正常访问,用DataQL的方式也很简单如下
// 声明一个 SQL
var dataSet = @@sql() <%select * from user;
%>
// 执行这个 SQL,并返回结果
return dataSet();
4、SQL参数化
// 类似mybatis写法
var dataSet = @@sql(userId) <%select * from user where user_id = #{userId};
%>
// 执行这个 SQL,并返回结果
return dataSet(${userId});
可以看到数据返回正常
5、结果转换
// 类似mybatis写法
var dataSet = @@sql(userId) <%select * from user where user_id = #{userId};
%>
// 执行这个 SQL,返回结果并进行结果转换
return dataSet(${userId}) => [{"userId":user_id,"userName":user_name}
];
是不是很简单,只需要进行简单的配置就可以完成一个接口的编写,省去了大量的Controller、Service、Mapping代码,这里只是分享一个简单的接口通过配置发布,后续回更新更多关于Dataway的文章。
欢迎关注我的公众号:coder的自我修养
Dataway接口配置服务,去掉后台,从此告别Controller、Service、Mapping相关推荐
- 电竞高性能主机可以改云服务器吗,破万电竞主机直播配置高级篇,从此告别卡顿...
昨天写了一篇入门篇的直播主机配置,在评论中有志同道合的朋友提出了许多有建设性的建议,自己也觉得不是特别的完善,所以今天自己在网上查询配件资料,同时归纳总结自己认识上的不足,所有有了今天这一篇文章,希望 ...
- 业务中台管理系统、业务中台架构、接口类服务、模型类服务、界面类服务、组件类服务、服务架构、中后台、服务审核、AI服务、位置服务、行业场景服务、企业中台、接口配置、模型配置、数据处理、结构化数据、数据源
业务中台管理系统.业务中台架构.接口类服务.模型类服务.界面类服务.组件类服务.服务架构.中后台.服务审核.AI服务.位置服务.行业场景服务.企业中台.接口配置.模型配置.数据处理.结构化数据.数据源 ...
- springboot整合knife4j,从此告别手写接口文档
关于knife4j Knife4j的前身是swagger-bootstrap-ui,前身swagger-bootstrap-ui是一个纯swagger-ui的ui皮肤项目 一开始项目初衷是为了写一个增 ...
- 【SAP PO】SAP PO 接口配置完整教程之二REST服务对接
SAP PO 接口配置完整教程之二REST服务对接 1.了解服务协议 1.1.服务通讯协议 1.2.具体接口协议 1.3.接口服务测试 2.PO端接口配置 2.1.PO端ESR配置 2.2.PO端IB ...
- 【SAP PO】X-DOC:SAP PO 接口配置 REST 服务对接填坑记
X-DOC:SAP PO 接口配置 REST 服务对接填坑记 1.背景 2.PO SLD配置 3.PO https证书导入 1.背景 (1)需求背景: SAP中BOM频繁变更,技术人员在对BOM进行变 ...
- 实习手册一(Python基于Tornado框架的接口响应服务)软件下载与环境配置
目录 一.软件下载及环境配置: 1.Homebrew 2.python3.9 3.PyCharm专业版 4.MySQL 5.Navicat for MySQL 6.Redis 7.Postman 此次 ...
- Oracle服务端配置IP,修改主机和服务器的 IPv6 接口配置
修改主机和服务器的 IPv6 接口配置 本节介绍如何修改作为主机或服务器的节点上启用了 IPv6 的接口的配置.大多数情况下,应当针对启用了 IPv6 的接口使用地址自动配置,如<系统管理指南: ...
- 微信公众号 接口配置信息 URL 配置失败(能进入后台方法,无返回信息)
微信公众号 接口配置信息 URL 配置失败(能进入后台方法,无返回信息) 操作步骤:1.微信公众号输入url.token点提交,提示配置失败. 后台代码: @ResponseBody@RequestM ...
- 云服务器有token_配置node服务器并且链接微信公众号接口配置
配置node服务器并且链接微信公众号接口配置 配置node服务器 在购买好服务器后,用Xshell链接到服务器. 1.安装nvm curl -o- https://raw.githubusercont ...
- 配置node服务器并且链接微信公众号接口配置(超详细)
配置node服务器 在购买好服务器后,用Xshell链接到服务器. 1.安装nvm curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.3 ...
最新文章
- poj1655Multiplication Puzzle
- VS2015配置opencv教程(图文详解)
- 第1课 编程是一门技术_动动脑 第1题
- Keras入门——(1)全连接神经网络FCN
- HR常用的人力资源系统软件有哪些?
- 阿里云 SLB CDN SCDN DCDN区别在哪?如何选择?
- 简单Web服务器程序设计与实现
- 百度杀毒,360安全卫士的那些私下的功夫 。
- AlexNet-深度卷积神经网络(CNN卷积神经网络)
- java导出带图片excel
- Windows 2008 Server搭建Radius服务器
- CAJ(caj)阅读器下载
- 有赞实时数仓建设实践与经验
- 计算机毕业设计python基于django的学生考试成绩数据分析与可视化系统
- 抖音最疯狂的辞职代码,你下载了吗?
- 国网电费充值api,油卡充值api(中石化中石油)
- 8个程序员专用软件/网站,个个是神器,第一个最惊喜......
- 如何通过组策略控制远程主机空闲时间自动断开并注销
- spring中读不到配置文件问题
- 网易邮箱中非常实用的工具,手机、IP等归属地