工程师工具箱系列(2)hasor-编程知识

文章目录

- 工程师工具箱系列(2)hasor
- - 简介
  - 特点
  - 环境准备
  - - 引入依赖
    - 数据库脚本
    - 文件配置
    - Hasor配置
  - 运行测试
  - 小结

工程师工具箱系列(2)hasor

简介

Hasor有着自己的独立的生命周期与Spring的不同，是一套完整的体系，提供了注入DataQL、Dataway、hasor-web等等，让你的代码无需在写Controller、Service、Dao、BO、VO、mapper等等东西，这是一个数据聚合项目。

Hasor 本身是由多个不同系列框架组合而成的一个框架体系。这些子框架的能力涵盖了 IoC、Aop、WebMVC、数据库以及其它方方面面。这一切的基础要归功于 Hasor 的插件化能力。

Hasor 帮助您设计更好的 API，它独有的框架扩展能力可以使新的能力完全无缝的集成到统一的 API 体系中。我们构建了通用功能，使您能够扩展 Hasor，而不是向核心框架添加每个特性。

Hasor 的扩展能力更像是一个乐高玩具的接口，任何人都可以通过非常简单的方式提供乐高积木，然后轻松的将它们融合到一起。在使用的过程中完全感受不到背后是多个不同的框架在协作。

特点

Hasor 的设计思想是 “微内核+插件”。微内核是指提供少量必要的功能支持，其余功能全部通过插件化方式实现。这样一来扩展 Hasor 就只需要无限制的添加插件而不是修改核心框架。

Hasor 独有的 API 融合机制会，让框架新的能力完全无缝的集成到统一的 API 体系中。下面这张图是 Hasor 的现有框架体系

环境准备

引入依赖

以主流Maven和Springboot工程为例

<!-- dataway -->
<dependency><groupId>net.hasor</groupId><artifactId>hasor-spring</artifactId><version>${hasor.version}</version>
</dependency>
<dependency><groupId>net.hasor</groupId><artifactId>hasor-dataway</artifactId><version>${hasor.version}</version>
</dependency>
<!-- druid 连接池 -->
<dependency><groupId>com.alibaba</groupId><artifactId>druid-spring-boot-starter</artifactId><version>1.1.21</version>
</dependency>
<!--mysql 驱动-->
<dependency><groupId>mysql</groupId><artifactId>mysql-connector-java</artifactId><version>8.0.19</version>

数据库脚本

考虑到不同版本字段不同，数据脚本最好从依赖包中获取，目前支持好几种数据库，大家根据数据库类型自选

以下是4.2.5版本脚本

CREATE TABLE interface_info (api_id          varchar(64)  NOT NULL COMMENT 'ID',api_method      varchar(12)  NOT NULL COMMENT 'HttpMethod：GET、PUT、POST',api_path        varchar(512) NOT NULL COMMENT '拦截路径',api_status      varchar(4)   NOT NULL COMMENT '状态：-1-删除, 0-草稿，1-发布，2-有变更，3-禁用',api_comment     varchar(255) NOT NULL COMMENT '注释',api_type        varchar(24)  NOT NULL COMMENT '脚本类型：SQL、DataQL',api_script      mediumtext   NOT NULL COMMENT '查询脚本：xxxxxxx',api_schema      mediumtext   NOT NULL COMMENT '接口的请求/响应数据结构',api_sample      mediumtext   NOT NULL COMMENT '请求/响应/请求头样本数据',api_option      mediumtext   NOT NULL COMMENT '扩展配置信息',api_create_time varchar(32)  NOT NULL COMMENT '创建时间',api_gmt_time    varchar(32)  NOT NULL COMMENT '修改时间',PRIMARY KEY (api_id),UNIQUE KEY uk_interface_info (api_path)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='Dataway 中的API';

CREATE TABLE interface_release (pub_id           varchar(64)  NOT NULL COMMENT 'Publish ID',pub_api_id       varchar(64)  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       varchar(4)   NOT NULL COMMENT '状态：-1-删除, 0-草稿，1-发布，2-有变更，3-禁用',pub_comment      varchar(255) NOT NULL COMMENT '注释',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   NOT NULL COMMENT '接口的请求/响应数据结构',pub_sample       mediumtext   NOT NULL COMMENT '请求/响应/请求头样本数据',pub_option       mediumtext   NOT NULL COMMENT '扩展配置信息',pub_release_time varchar(32)  NOT NULL COMMENT '发布时间（下线不更新）',PRIMARY KEY (pub_id),KEY idx_interface_release_api  (pub_api_id),KEY idx_interface_release_path (pub_path)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='Dataway API 发布历史。'

文件配置

配置项目工程中properties.yml文件

  # 数据源datasource:type: com.alibaba.druid.pool.DruidDataSourcedriver-class-name: com.mysql.jdbc.Driverdruid:driver-class-name: com.mysql.cj.jdbc.Driverusername: rootpassword: 123321qqurl: jdbc:mysql://localhost:3306/mp?useUnicode=true&characterEncoding=utf8&zeroDateTimeBehavior=convertToNull&useSSL=false&useJDBCCompliantTimezoneShift=true&useLegacyDatetimeCode=false&serverTimezone=GMT%2B8&allowMultiQueries=true# 是否启用 Dataway 功能（必选：默认false）
HASOR_DATAQL_DATAWAY: true
# 是否开启 Dataway 后台管理界面（必选：默认false, 生产环境不要打开！）
HASOR_DATAQL_DATAWAY_ADMIN: true
# SQL执行器方言设置（可选，建议设置）
HASOR_DATAQL_FX_PAGE_DIALECT: mysql
# dataway  API工作路径（可选，默认：/api/）
HASOR_DATAQL_DATAWAY_API_URL: /interface/
# dataway-ui 的工作路径（可选，默认：/interface-ui/）
HASOR_DATAQL_DATAWAY_UI_URL: /config/