database2api 意為 DataBase to API，即只要有數(shù)據(jù)庫，就可以生成開放 API。
database2api 是一款強大而便捷的工具，主要功能是依據(jù)現(xiàn)有的數(shù)據(jù)庫自動生成開放的 API 接口，能夠為開發(fā)者大幅節(jié)省時間與精力，尤其適用于那些已擁有數(shù)據(jù)庫且需要提供 API 接口，或者僅會構(gòu)建數(shù)據(jù)庫、而需要迅速實現(xiàn) API 接口的場景。
database2api 能夠智能地解析數(shù)據(jù)庫結(jié)構(gòu)，并根據(jù)用戶的需求和配置，自動生成相應(yīng)的 API 接口，讓您無需繁瑣的手動編碼，即可輕松實現(xiàn)數(shù)據(jù)庫與外部應(yīng)用的交互。
在當(dāng)今的軟件開發(fā)中，數(shù)據(jù)庫與外部應(yīng)用的交互是至關(guān)重要的環(huán)節(jié)。然而，手動編寫 API 接口往往是一項耗時且容易出錯的工作，而且需要具備某一種后端編程語言，門檻較高。database2api 的開發(fā)旨在解決這一痛點，讓開發(fā)者能夠更專注于業(yè)務(wù)邏輯的實現(xiàn)，而無需在接口開發(fā)上花費過多的時間和精力。
例如，在一個快速發(fā)展的項目中，數(shù)據(jù)庫結(jié)構(gòu)可能會頻繁變動。使用 database2api ，您只需更新配置文件，即可快速重新生成適應(yīng)新結(jié)構(gòu)的 API 接口，極大地提高了項目的敏捷性。
無論您是個人開發(fā)者還是團隊，database2api 都將是您提升開發(fā)效率、加速項目進程的得力助手。
本工具使用 Ktor 作為底層框架，JDBC 作為數(shù)據(jù)庫訪問層，通過 java.sql.DatabaseMetaData 獲取到數(shù)據(jù)庫結(jié)構(gòu)，再通過 Ktor 動態(tài)注冊 API 路由，實現(xiàn)直接由數(shù)據(jù)庫生成 API 接口。
目前，database2api 已支持以下多種主流數(shù)據(jù)庫：
? Sqlite
? MySQL
? Postgresql
? Microsoft SQL Server
? MariaDb
高效便捷：通過簡單的配置文件，即可快速生成所需的 API 接口，大大提高開發(fā)效率。
廣泛的數(shù)據(jù)庫支持：涵蓋了常見的數(shù)據(jù)庫類型，滿足不同項目的需求。
易于維護：生成的接口結(jié)構(gòu)清晰，代碼規(guī)范，便于后續(xù)的擴展和測試。
│ database2api.jar <-- 主程序（必選）
└─ data
└─ ext <-- 擴展 API 放置目錄（可選）
└─ web <-- 靜態(tài)文件目錄（可選）
└─ setting.ini <-- 配置文件（必選）
# API 默認(rèn)端口
API_PORT=8080
# 生成API的前綴，如設(shè)置 api/v1 后，則API變?yōu)椋篽ttp://localhost:{PORT}/api/v1/xxxxxx
API_PREFIX=api
# 是否啟用 API 文檔，地址 http://localhost:{PORT}，設(shè)為 false 不會生成 API 文檔
API_INDEX_ENABLED=true
# 是否啟用接口授權(quán)訪問功能，默認(rèn)false，所有 API 無需授權(quán)認(rèn)證即可訪問
API_AUTH_ENABLED=false
# 接口授權(quán)訪問，支持：Basic, JWT。（以后可能會支持其他的授權(quán)認(rèn)證方式）
API_AUTH_TYPE=JWT
# 接口允許訪問的用戶名密碼列表
API_AUTH_USERS=admin:123456,user:1234
# 數(shù)據(jù)庫默認(rèn)鏈接地址（主要需要這里的數(shù)據(jù)庫連接字符串，其他數(shù)據(jù)庫連接字符串樣例在下方）
DB_URL=jdbc:sqlite://G:/database2api-test/sqlite/fqb.db
# 數(shù)據(jù)庫用戶名
DB_USER=
# 數(shù)據(jù)庫密碼
DB_PWD=
# 生成API的數(shù)據(jù)表名稱，為空則所有的表都生成API，多個使用英文逗號分割
INCLUDE_TABLES=
# 需要忽略的數(shù)據(jù)表名稱，如果不為空，則指定的表名被過濾，多個使用英文逗號分割
IGNORED_TABLES=
# 是否啟用靜態(tài)網(wǎng)站，啟用后，則創(chuàng)建web目錄，放入靜態(tài)資源即可訪問
STATIC_WEB_ENABLED=true
# 是否開啟擴展API，允許用戶使用JS代碼使用自定義SQL查詢數(shù)據(jù)庫
EXT_API_ENABLED=true
java -jar database2api.jar
啟動后控制臺日志如下：
2024-07-11 23:43:14.367 [main] DEBUG cn.hutool.log.LogFactory - Use [Slf4j] Logger As Default.
2024-07-11 23:43:14.369 [main] INFO com.mrhuo.Database2Api - Database2Api: 開始初始化
2024-07-11 23:43:14.382 [main] INFO com.mrhuo.Database2Api - Database2Api: 開始初始化 API 配置
2024-07-11 23:43:14.431 [main] DEBUG cn.hutool.setting.SettingLoader - Load setting file [D:\work\java\database2api\data\setting.ini]
2024-07-11 23:43:14.444 [main] INFO com.mrhuo.Database2Api - Database2Api: 靜態(tài)網(wǎng)站主頁[http://127.0.0.1:8080/web/index.html]
2024-07-11 23:43:14.444 [main] INFO com.mrhuo.Database2Api - Database2Api: 開始初始化數(shù)據(jù)庫
2024-07-11 23:43:14.444 [main] INFO com.mrhuo.Database2Api - Database2Api: 使用鏈接字符串[jdbc:sqlite://G:/database2api-test/sqlite/fqb.db]
2024-07-11 23:43:15.236 [main] INFO com.mrhuo.Database2Api - Database2Api: 獲取到所有數(shù)據(jù)表的表結(jié)構(gòu)
2024-07-11 23:43:15.236 [main] INFO com.mrhuo.Database2Api - Database2Api: 已保存到文件[D:\work\java\database2api\data\tables.json]
2024-07-11 23:43:15.236 [main] INFO com.mrhuo.Database2Api - Database2Api: 初始化全部成功
2024-07-11 23:43:15.383 [main] INFO ktor.application - Autoreload is disabled because the development mode is off.
2024-07-11 23:43:16.241 [main] INFO ktor.application - Application started in 0.928 seconds.
2024-07-11 23:43:16.242 [main] INFO ktor.application - Application started: io.ktor.server.application.Application@299266e2
2024-07-11 23:43:16.633 [DefaultDispatcher-worker-1] INFO ktor.application - Responding at http://127.0.0.1:8080
啟動成功后目錄結(jié)構(gòu)變?yōu)椋?/p>
│ database2api.jar
└─ data
│ setting.ini
│ tables.json <-- 這是數(shù)據(jù)庫中所有的表名稱，下次啟動時不會從數(shù)據(jù)庫重新獲取，直接使用此文件。如數(shù)據(jù)庫已更新，則刪除此文件
│ table_names.json <-- 這是數(shù)據(jù)庫中所有表結(jié)構(gòu)，下次啟動時不會從數(shù)據(jù)庫重新獲取，直接使用此文件。如數(shù)據(jù)庫已更新，則刪除此文件
└─ ext <-- 擴展 API 放置目錄（可選）
└─ web <-- 靜態(tài)文件目錄（可選）
└─ index.html <-- 這是靜態(tài)網(wǎng)頁默認(rèn)首頁
打開瀏覽器，訪問 http://127.0.0.1:8080 ，如果開啟了配置 API_INDEX_ENABLED=true，此時界面如下：
端口設(shè)置見配置文件 API_PORT=8080
如果設(shè)置 API_INDEX_ENABLED=false，則不會顯示 API 文檔界面。
隨便找個測試獲取所有數(shù)據(jù)：http://127.0.0.1:8080/api/DEVICE/all
這里的 DEVICE 是數(shù)據(jù)庫中的表名
再測試分頁顯示數(shù)據(jù)：http://127.0.0.1:8080/api/DEVICE/paged
可以看到，僅僅是配置了數(shù)據(jù)庫鏈接，就自動生成一個完整的可用的API接口，非常方便。
現(xiàn)已支持 Basic、JWT 兩種授權(quán)認(rèn)證方式，配置如下：
# 是否啟用接口授權(quán)訪問功能
API_AUTH_ENABLED=false
# 接口授權(quán)訪問，支持：Basic, JWT,
API_AUTH_TYPE=JWT
# 接口允許訪問的用戶名密碼列表
API_AUTH_USERS=admin:123456,user:1234
需要配置 API_AUTH_ENABLED=true 開啟API授權(quán)
需要配置 API_AUTH_TYPE=Basic （注意大小寫）
需要配置 API_AUTH_USERS=user:pass,user1:pass1，設(shè)置允許訪問的用戶密碼對
Basic 授權(quán)失敗演示
Basic 授權(quán)成功演示
需要配置 API_AUTH_ENABLED=true 開啟API授權(quán)
需要配置 API_AUTH_TYPE=JWT （注意大小寫）
需要配置 API_AUTH_USERS=user:pass,user1:pass1，設(shè)置允許訪問的用戶密碼對
注意，JWT授權(quán)，單獨提供了一個用戶登錄接口，路勁為 /api/api-user-login，前面的 api 前綴，由配置 API_PREFIX 來設(shè)置
JWT 驗證失敗演示
JWT 驗證成功演示
JWT 用戶登錄成功演示
JWT 用戶登錄失敗演示
擴展 API 簡單來說就是寫一個JS文件，作為API擴展接口，執(zhí)行數(shù)據(jù)庫訪問，完成API請求的功能。
開啟方式，在配置文件里設(shè)置 EXT_API_ENABLED=true，并在 data 目錄下創(chuàng)建 ext 目錄，創(chuàng)建文件 get_hello.js，內(nèi)容如下：
注意：文件名格式為 {get|post}_{api_name}.js
function main() {
var name = context.query.name || "no name";
return "hello " + name;
}
規(guī)定函數(shù)名 main，重新啟動 database2api 后可看到控制臺提示：
2024-07-14 17:26:58.380 [main] INFO com.mrhuo.plugins.RoutingKt - Database2Api.scriptApiRoute: 創(chuàng)建擴展API[GET:/api/ext/hello]成功
訪問該API http://127.0.0.1:8080/api/ext/hello?name=mrhuo 時，返回結(jié)果如下：
{
"code": 0,
"msg": "OK",
"data": "hello mrhuo"}
注意：擴展API因為用到了腳本引擎來解釋執(zhí)行腳本代碼，性能不是太好，如非必要，請勿過度依賴此功能。
擴展API中目前支持 db, context 兩個對象。
db 對象主要用于數(shù)據(jù)庫查詢，提供 db.query(sql), db.queryOne(sql), db.exec(sql) 這三個方法
context 對象主要用于當(dāng)前請求參數(shù)的獲取，提供 context.uri, context.method, context.headers, context.query, context.body 五個對象
注意如果數(shù)據(jù)庫有密碼，還需要配置 DB_USER 和 DB_PWD
Sqlite
DB_URL=jdbc:sqlite://G:/db.db
MySQL
DB_URL=jdbc:mysql://127.0.0.1:3306/db?useSSL=false&serverTimezone=UTC&charset=utf8mb
PostgreSQL
DB_URL=jdbc:postgresql://127.0.0.1:5432/db
Microsoft SQL Server
DB_URL=jdbc:sqlserver://;serverName=rm-abc.sqlserver.rds.aliyuncs.com;port=1433;databaseName=db_cms
MariaDb
jdbc:mariadb://127.0.0.1:3306/mysql?useSSL=false&serverTimezone=UTC&charset=utf8mb4
https://github.com/mrhuo/database2api
MIT
轉(zhuǎn)自https://www.cnblogs.com/MrHuo/p/18309261/database2api
該文章在 2024/10/8 15:20:17 編輯過
400 186 1886
