dataway 是基于dataQL 服务聚合能力，为应用提供的一个接口配置工具，使得
应用者无需开发任何代码就配置一个满足需求的接口。整个接口配置，测试，冒烟，发布。一站式都通过Dataway提供的ui界面完成，ui会以jar包方式提供并集成到应用中并和应用共享同一个http端口，应用无需单独为Dataway开辟新的管理端口。
这种内嵌集成方式模式的优点是，可以使得大部分老项目都可以在无侵入的情况下直接应用dataway。进而改进老项目的迭代效率，大大减少企业项目研发成本。
dataway 工具化的提供dataQL 配置能力，这种研发模式的变革使得，相当多的需求开发场景只需要配置即可完成交付。从而避免了从数据存取到前端接口的一系列开发任务。例如： Mapper,BO,VO,DO,DAO,Service.COntroller 统统不需要
Dataway是Hasor 生态中的一员，因此在Spring 中使用Dataway 首先要做的就是打通2个生态，根据官方文档中推荐的方式我们将hasor 和springboot联合起来
第一步： 引入相关依赖
<dependency>
<groupId>net.hasor</groupId>
<artifactId>hasor-spring</artifactId>
<version>4.1.6</version>
</dependency>
<dependency>
<groupId>net.hasor</groupId>
<artifactId>hasor-dataway</artifactId>
<version>4.1.6</version>
</dependency>
hasor-spring 负责 Spring 和Hasor 框架之间的整合。hasor-dataway 是工作在Hasor 之上，利用hasor-spring 我们可以使用dataway了
第二步，配置Dataway,并初始化数据表
dataway 会提供一个界面让我们配置接口，这一点类似Swagger 只要jar包集成就可以实现接口配置，找到我们的springboot 项目的配置文件application.yml
# 是否启用 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 一共涉及到5个可以配置的配置项，但是不是所有的配置都是必须的。
其中 HASOR_DATAQL_DATAWAY、HASOR_DATAQL_DATAWAY_ADMIN 两个配置是必须要打开的，默认情况下 Datawaty 是不启用的。
Dataway 需要2个数据表才能工作，下面试这2个数据表的简表语句。下面这个SQL 可以在dataway的依赖jar 包中"META-INF/hasor-framework/mysql"目录下面找到，建表语句是用 mysql 语法写的。
其它数据库的建表语句请参看官方说明手册：https://www.hasor.net/web/dataway/for_boot.html#mysql
第三步：配置数据源
作为Spring Boot 项目有着自己完善的数据库方面工具支持。我们这次采用 druid+mysql+spring-boot-starter-jdbc 的方式
首先引入依赖
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>5.1.30</version>
</dependency>
<dependency>
<groupId>com.alibaba</groupId>
<artifactId>druid</artifactId>
<version>1.1.21</version>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-jdbc</artifactId>
</dependency>
<dependency>
<groupId>com.alibaba</groupId>
<artifactId>druid-spring-boot-starter</artifactId>
<version>1.1.10</version>
</dependency>
然后增加数据源的配置
spring:
datasource:
driver-class-name: com.mysql.jdbc.Driver
druid:
filter:
stat:
log-slow-sql: true
slow-sql-millis: 1
initial-size: 3
max-active: 10
max-wait: 60000
min-idle: 3
stat-view-servlet:
login-password: admin
login-username: admin
password: xxxxx
type: com.alibaba.druid.pool.DruidDataSource
url: jdbc:mysql://xxxxxxx:3306/example
username: xxxxx
如果项目已经集成了自己的数据源，那么可以忽略第三步
第四步：把数据源设置到 hasor 容器中。
Spring Boot 和Hasor 本是2个独立的容器框架，我们做整合之后为了使用Dataway的能力需要把Spring 中的数据源设置到Hasor 中。
首先新建一个Hasor 的模块，并且将其交给Spring 管理，然后把数据源通过Spring 注入进来。
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.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Component;
import javax.sql.DataSource;
@DimModule
@Component
public class ExampleModule implements SpringModule {
@Autowired
private DataSource dataSource = null;
@Override
public void loadModule(ApiBinder apiBinder) throws Throwable {
// .DataSource form Spring boot into Hasor
apiBinder.installModule(new JdbcModule(Level.Full, this.dataSource));
}
}
hasor 启动的时候会调用到loadModule 方法，在这里在把 DataSource 设置到Hasor 中。
第五步： 在SpringBoot 中启用Hasor
@EnableHasor()
@EnableHasorWeb()
@SpringBootApplication(scanBasePackages = { net.example.hasor })
public class ExampleApplication {
public static void main(String[] args) {
SpringApplication.run(ExampleApplication.class, args);
}
}
这一步很简单，只需要在Spring 启动类中增加2个注解即可。
网友评论