# api-table > api-table 使用文档:无需编写 SQL 的表级增删改查接口、查询条件与导出 ## 检索入口 - [机器可读目录](https://api-table.io.nexus/ai/index.json): 页面标题、章节、摘要、原文地址、内容哈希和占位状态。 - [分段语料](https://api-table.io.nexus/ai/chunks.jsonl): 每行一个 JSON 对象,按正文标题分段,保留代码块。 - [完整正文](https://api-table.io.nexus/llms-full.txt): 所有页面原文。优先按章节或单页获取。 - [站点地图](https://api-table.io.nexus/sitemap.xml): HTML 页面入口。 回答时引用 url 字段;结合版本与验证范围,placeholder 表示短内容候选,不应当作完整实现。 ## overview - [本章完整正文](https://api-table.io.nexus/ai/chapters/overview.txt) - [ApiTable 概述](https://api-table.io.nexus/ai/pages/01.md): 概述 ApiTable 是一款灵活的,高性能的,非 ORM 的 java 数据库操作框架 - 支持常用的 sql 数据, sqlite,mysql,oracle,postgresql,tdengine - 根据参数参数自动生成 sql 语句 - 快速实现支持增删改查 入门使用 添加依赖 - [使用 ApiTable 连接 SQLite](https://api-table.io.nexus/ai/pages/02.md): 入门示例 创建数据表并插入数据 SQLite 是一种轻量级嵌入式数据库。使用 Navicat Premium 可以轻松创建 SQLite 数据库,数据库文件将保存在本地。 以下是一个创建表并插入数据的示例: 整合 SQLite 在项目中整合 SQLite,首先需要添加以下依赖: 在 app.properties 配置文 - [使用 ApiTable 连接 Mysql](https://api-table.io.nexus/ai/pages/03.md): 11.2.1.创建表,插入数据 创建一张简单的 student 表 11.2.2.添加依赖 11.2.3.配置文件-app.properties 11.2.7.编写启动类 11.2.5.编写配置类 DbConfig.java, 注意观察 DataSource 的 priority 是 1,priority 表示 bea - [使用 ApiTable 连接 Postgres](https://api-table.io.nexus/ai/pages/04.md): postgresql 简介 略 整合 简单整合示例 创建表,插入数据 创建一张简单的 student 表 添加依赖 新建工程 tio-boot-postgresql-demo 配置文件 app.properties 编写启动类 编写配置类 DbConfig.java, 注意观察 - DataSource 的 prior - [使用 ApiTable 连接 TDEngine](https://api-table.io.nexus/ai/pages/05.md): 本节列出了整合 TDEngine 所需的 Maven 依赖。这些依赖包括 tio-boot 用于构建基于事件驱动的应用程序,以及相关的 JDBC 驱动和连接池用于数据库连接。 连接 TDEngine 添加依赖 添加配置信息 app.properties 启动类 ActiveRecordPluginConfigurati - [使用 api-table 连接 oracle](https://api-table.io.nexus/ai/pages/06.md): - [使用 api-table 连接 mysql and tdengine 多数据源](https://api-table.io.nexus/ai/pages/07.md): 如何在 tio-boot 应用程序中配置多个数据源,这里以 MySQL 和 TDengine 为例。 ActiveRecordPluginConfiguration 类 1. 数据源配置 : - getMysqlDataSource() : 此方法创建并配置 MySQL 的数据源。使用 HikariCP 作为连接池管理 - [EasyExcel 导出](https://api-table.io.nexus/ai/pages/08.md): 在本指南中,我们将演示如何使用 EasyExcelUtils 和 EasyExcelResponseUtils 来支持 Excel 导出功能。 EasyExcelUtils 主要用于将数据导出到本地文件,而 EasyExcelResponseUtils 则用于将导出的 Excel 表格文件直接下载到客户端。 1. 使用 - [EasyExcel 导入](https://api-table.io.nexus/ai/pages/09.md): 简介 背景 在数据处理和分析的过程中,读取和解析 Excel 文件是一个非常常见的需求。在 Java 开发中,有许多库可以帮助我们实现这一功能。其中,阿里巴巴的 EasyExcel 库因其高性能和易用性,备受开发者青睐。本文将详细介绍如何使用 EasyExcel 读取 Excel 文件,并将内容转换为自定义的数据结构 - [ApiTable 的权限与业务边界](https://api-table.io.nexus/ai/pages/10.md): 表可以被 CRUD 不代表所有业务操作都适合直接通过通用更新实现。 | 操作 | 实现边界 | | --- | --- | | 后台维护字典和普通配置 | ApiTable,并核对表、字段与操作权限 | | 扣款、支付履约、库存扣减 | 独立业务接口,事务内校验和更新 | | 审核、状态流转 | 独立命令,检查允许的状 - [ApiTable 联调与故障定位](https://api-table.io.nexus/ai/pages/11.md): 先区分独立 ApiTable 与 tio-boot-admin 内置控制器,再对照同版本接口验证。 | 现象 | 检查点 | | --- | --- | | 404 | 控制器注册、上下文路径、是否被其他 Handler 接管 | | 401 / 403 | 后台 Token 与操作授权,不通过放行全部表接口解决 | - [ApiTable 实现增删改查](https://api-table.io.nexus/ai/pages/12.md): 本节介绍如何使用 tio-boot 整合 ApiTable ,实现一个简单的增删改查(CRUD)示例应用。通过该示例,您将了解如何创建数据库表、配置依赖、编写控制器以及测试各项功能。 创建表和插入数据 创建表 首先,创建一个名为 system users 的用户信息表,用于存储系统用户的相关信息。以下是建表的 SQL - [数组类型](https://api-table.io.nexus/ai/pages/13.md): 本指南介绍了在前后端交互中如何处理数组类型的数据,包括数据的创建、后端接收与存储,以及数据查询的流程。 1. 创建数据时发送的格式 在创建新数据时,数组类型的字段需要按照特定的格式发送给后端。以下是一个示例,其中 permit area 为数组类型字段: 说明: - permit area : 这是需要发送的数组字段, - [单独使用 ApiTable](https://api-table.io.nexus/ai/pages/14.md): 在现代应用开发中,简化数据库操作、提高代码复用性和维护性是每个开发者追求的目标。 ApiTable 作为一个基于 java-db 框架的通用数据表操作工具,旨在实现这一目标。本文将详细介绍如何封装 ApiTableService 以及如何在控制器中使用 ApiTableService ,以实现高效、灵活的增删改查(CR - [TQL(Table SQL)前端输入规范](https://api-table.io.nexus/ai/pages/15.md): toc TQL(Table SQL)是一种以 http 请求参数 为载体的结构化查询语言,用于操作数据表。 - 解析前端输入的 Http 请求 参数 - 转换为底层数据库可执行的 SQL 语句 - 执行 SQL - 将执行结果返回至前端 - 支持对表的增删改查操作 基本概念 数据表(Data Table) 例如,以下请 - [api-table](https://api-table.io.nexus/ai/pages/index.md): api-table 让应用不写 SQL 就能对数据表进行增删改查、分页与导出。 文件清单 - 01.md : 文档《ApiTable 概述》。 - 02.md : 文档《使用 ApiTable 连接 SQLite》。 - 03.md : 文档《使用 ApiTable 连接 Mysql》。 - 04.md : 文档《使用