Dataway介绍

Dataway 是基于 DataQL 服务聚合能力，为应用提供的一个接口配置工具。使得使用者无需开发任何代码就配置一个满足需求的接口。整个接口配置、测试、冒烟、发布。一站式都通过 Dataway 提供的 UI 界面完成。UI 会以 Jar 包方式提供并集成到应用中并和应用共享同一个 http 端口，应用无需单独为 Dataway 开辟新的管理端口。

这种内嵌集成方式模式的优点是，可以使得大部分老项目都可以在无侵入的情况下直接应用 Dataway。进而改进老项目的迭代效率，大大减少企业项目研发成本。

Dataway 工具化的提供 DataQL 配置能力。这种研发模式的变革使得，相当多的需求开发场景只需要配置即可完成交付。从而避免了从数据存取到前端接口之间的一系列开发任务，例如：Mapper、BO、VO、DO、DAO、Service、Controller 统统不在需要。

在《在 Spring Boot 中使用 Dataway 配置数据查询接口》文章中，我们介绍了如何使用。Dataway 来配置接口避免开发工作。这篇文章来介绍一下如何和前端对接参数。

通常前后端连调时，都要对接一下接口。在这个过程中前后端会确定请求参数的个数和格式，以及数据响应的个数和格式。

比如根据用户名称模糊查询相关用户列表。在这个场景中设定一个请求参数，姑且叫它 userName把。然后返回一个列表，列表中是符合条件的用户信息。

为了这个场景我们首先需要定义前后端交互数据接口：

请求：

userName : String

响应：

rootData：Array[UserInfo]
UserInfo：{
user_id : Integer,
user_name : String,
user_sex : String
}

在 Dataway 中首先我们新建一个接口，并且给接口取好名字和备注。

Dataway 配置数据接口时和前端进行参数对接

紧接着我们在 Dataway 的页面中定义前端请求参数。

Dataway 配置数据接口时和前端进行参数对接

在编写SQL 之前我们先在 DataQL 上编写一段 JSON 通过这个 JSON 来模拟数据输出的结果。

Dataway 配置数据接口时和前端进行参数对接

接下来我们编写数据库查询然后返回我们在数据库中的数据，为了演示这个功能我在数据库中先创建了一张表并且初始化了一些数据。它们看上去是这个样子的：

CREATE TABLE `user_info` (
  `id` int(11) NOT NULL AUTO_INCREMENT,
  `name` varchar(128) DEFAULT NULL,
  `sex` int(11) DEFAULT NULL,
  PRIMARY KEY (`id`)
) ENGINE=InnoDB AUTO_INCREMENT=5 DEFAULT CHARSET=utf8mb4

Dataway 配置数据接口时和前端进行参数对接

接下来我编写一段 SQL 查询这个表，并且在返回 mock 的数据的前面先尝试执行SQL返回数据。

Dataway 配置数据接口时和前端进行参数对接

可以看到数据已经如我们预期的输出了出来，在这里 DataQL 的执行是按照顺序进行的。当遇到 return 指令的时，后续的查询将不会被执行。

接着把数据库返回的结果做一下格式转换，让其按照我们要求的格式返回数据。官方手册这一部分的内容在这里：https://www.hasor.net/web/dataql/grammar/convert.html#

我们这里需要做的是把一个 List 结果格式进行一次变换。最起码我们需要的列名都要变化一下。在执行一下就得到我们要的预期结果了。

Dataway 配置数据接口时和前端进行参数对接

最后一部分，在 SQL 查询中使用我们预先定义好的 userName 来进行模糊匹配。首先 SQL 语句需要有所改写：

select * from user_info
   =>
select * from user_info where like `name` like #{userName} <- 类似 Mybatis 的写法，带参数的SQL 用 #{...}

SQL 中参数名已经确定好了，接下来改写一下定义 SQL 查询这一部分声明一个参数。这就好比定义方法的参数一样。

var queryUser = @@sql(userName)<%   <-- 增加参数定义
    select * from user_info where `name` like #{userName}
%>

最后将前端传入的请求参数，在执行用户查询的时候将其传进去即可。在 DataQL 查询中要想获得 Paramerers 面板中定义的参数需要通过 ${ ... } 形式获取。这部分内容在官方手册上也有介绍在这里：https://www.hasor.net/web/dataql/grammar/params.html

Dataway 配置数据接口时和前端进行参数对接