后端【免費(fèi)下載鏈接】mikro-ormTypeScript ORM for Node.js based on Data Mapper, Unit of Work and Identity Map patterns. Supports MongoDB, MySQL, MariaDB, MS SQL Server, PostgreSQL and SQLite/libSQL databases.項(xiàng)目地址https://gitcode.com/gh_mirrors/mi/mikro-orm點(diǎn)擊查看免費(fèi)下載導(dǎo)讀AdminJS 是一款自動(dòng)生成后臺(tái)管理界面的開源工具它通過(guò)適配器Adapter機(jī)制將數(shù)據(jù)庫(kù)實(shí)體直接映射為可增刪改查CRUD的 Web 管理面板。本文基于當(dāng)前倉(cāng)庫(kù) version-7.2 版本文檔 編寫完整講解如何在 MikroORM 項(xiàng)目中接入 AdminJS從依賴安裝、Express/Hapi 兩種主流框架的初始化與路由掛載到為后臺(tái)面板添加用戶認(rèn)證全程提供可直接復(fù)制運(yùn)行的 TypeScript 示例。讀完本文你將掌握用一條MikroORM.init()初始化即讓全部實(shí)體自動(dòng)出現(xiàn)在 AdminJS 側(cè)邊欄、并安全暴露給運(yùn)營(yíng)人員的完整方案。適用前提本文示例基于當(dāng)前倉(cāng)庫(kù) v7 版本的mikro-orm/core與各數(shù)據(jù)庫(kù)驅(qū)動(dòng)包以及adminjs/mikroorm適配器MikroORM.init()的用法與當(dāng)前倉(cāng)庫(kù) packages/core/src/MikroORM.ts 中的實(shí)現(xiàn)保持一致。一、為什么需要 AdminJS 適配器MikroORM 是構(gòu)建在 Data Mapper、Unit of Work 與 Identity Map 模式之上的 TypeScript ORM負(fù)責(zé)實(shí)體發(fā)現(xiàn)、元數(shù)據(jù)構(gòu)建、EntityManager 管理和數(shù)據(jù)庫(kù)連接。AdminJS 本身并不了解 MikroORM 的實(shí)體元數(shù)據(jù)二者之間需要一層“橋接”Database 類由adminjs/mikroorm提供負(fù)責(zé)接收一個(gè)已初始化的MikroORM實(shí)例讀取其中的實(shí)體元數(shù)據(jù)Resource 類將單個(gè)實(shí)體如User、Car、Seller包裝成 AdminJS 可操作的資源對(duì)象從而在面板中自動(dòng)生成列表、詳情、新建、編輯、刪除等頁(yè)面。因此接入流程的本質(zhì)是先正常初始化 MikroORM再把 ORM 實(shí)例注冊(cè)給 AdminJS最后把 AdminJS 的路由掛到你的 Web 服務(wù)器上。二、安裝依賴按官方文檔共分三步安裝。1. AdminJS 核心包$ yarn add adminjs2. MikroORM 適配器與驅(qū)動(dòng)$ yarn add adminjs/mikroorm # 根據(jù)你的數(shù)據(jù)庫(kù)選擇對(duì)應(yīng)的 MikroORM 驅(qū)動(dòng)與核心包 $ yarn add mikro-orm/core mikro-orm/mongodb # for mongo $ yarn add mikro-orm/core mikro-orm/mysql # for mysql $ yarn add mikro-orm/core mikro-orm/mariadb # for mariadb $ yarn add mikro-orm/core mikro-orm/postgresql # for postgresql $ yarn add mikro-orm/core mikro-orm/sqlite # for sqlite提示當(dāng)前倉(cāng)庫(kù)packages/目錄下即包含 core、mongodb、mysql、mariadb、postgresql、sqlite、libsql、mssql、oracledb 等驅(qū)動(dòng)包的源碼安裝的正是這些包。若使用 npm將yarn add替換為npm install即可。3. 服務(wù)器框架插件Express$ yarn add adminjs/express # Peer dependencies $ yarn add express express-formidable express-sessionHapi$ yarn add adminjs/hapi # Peer dependencies $ yarn add hapi/boom hapi/cookie hapi/hapi hapi/inert三、基礎(chǔ)初始化MikroORM ExpressExpress 是最常見的掛載方式。完整示例import AdminJS from adminjs; import { Database, Resource } from adminjs/mikroorm; import AdminJSExpress from adminjs/express; import { MikroORM } from mikro-orm/postgresql; import { validate } from class-validator; // optional const PORT process.env.PORT ?? 3000; const run async () { /* 像平時(shí)一樣初始化 MikroORM也可以從獨(dú)立文件導(dǎo)入已創(chuàng)建的 ORM 實(shí)例 */ const orm await MikroORM.init({ entities: [User, Car, Seller], // 換成你自己的實(shí)體 dbName: process.env.DATABASE_NAME, clientUrl: process.env.DATABASE_URL, }); /* 可選如果使用 class-validator將其賦值給 Resource */ Resource.validate validate; /* 告訴 AdminJS 使用哪個(gè)適配器 */ AdminJS.registerAdapter({ Database, Resource }); const app express(); /* 創(chuàng)建 AdminJS 實(shí)例 */ const admin new AdminJS({ databases: [orm], }); const router AdminJSExpress.buildRouter(admin); app.use(admin.options.rootPath, router); app.listen(PORT, () { console.log(App listening at http://localhost:${PORT}); }); } run();關(guān)鍵點(diǎn)拆解MikroORM.init()的職責(zé)從當(dāng)前倉(cāng)庫(kù) packages/core/src/MikroORM.ts 的源碼可以看到init會(huì)加載可選依賴、執(zhí)行元數(shù)據(jù)發(fā)現(xiàn)MetadataDiscovery、創(chuàng)建全局EntityManager最終返回可用的 ORM 實(shí)例。傳入的entities數(shù)組正是元數(shù)據(jù)發(fā)現(xiàn)的入口AdminJS 會(huì)基于這些被發(fā)現(xiàn)的實(shí)體生成后臺(tái)資源。連接參數(shù)dbName指定數(shù)據(jù)庫(kù)名clientUrl提供完整的連接串會(huì)覆蓋單獨(dú)的主機(jī)/端口/用戶名等配置。當(dāng)前倉(cāng)庫(kù) packages/core/src/utils/Configuration.ts 中ConnectionOptions還支持host、port、user、password、pool等字段生產(chǎn)環(huán)境建議把數(shù)據(jù)庫(kù)憑據(jù)放到環(huán)境變量中避免硬編碼。適配器注冊(cè)AdminJS.registerAdapter({ Database, Resource })必須在創(chuàng)建AdminJS實(shí)例之前完成否則 AdminJS 無(wú)法識(shí)別傳入的 ORM 實(shí)例。路由掛載admin.options.rootPath默認(rèn)是/admin通過(guò)app.use將 AdminJS 路由掛到 Express 應(yīng)用上。啟動(dòng)后訪問(wèn)http://localhost:3000/admin側(cè)邊欄會(huì)列出User、Car、Seller等全部實(shí)體即可對(duì)它們執(zhí)行基礎(chǔ)的CRUD操作。四、基礎(chǔ)初始化MikroORM HapiHapi 的接入思路相同只是把“構(gòu)建路由”換成了“注冊(cè)插件”import AdminJS from adminjs; import { Database, Resource } from adminjs/mikroorm; import AdminJSHapi from adminjs/hapi; import { MikroORM } from mikro-orm/postgresql; import { validate } from class-validator; // optional const PORT process.env.PORT ?? 3000; const run async () { /* 像平時(shí)一樣初始化 MikroORM也可以從獨(dú)立文件導(dǎo)入已創(chuàng)建的 ORM 實(shí)例 */ const orm await MikroORM.init({ entities: [User, Car, Seller], // 換成你自己的實(shí)體 dbName: process.env.DATABASE_NAME, clientUrl: process.env.DATABASE_URL, }); /* 可選如果使用 class-validator將其賦值給 Resource */ Resource.validate validate; /* 告訴 AdminJS 使用哪個(gè)適配器 */ AdminJS.registerAdapter({ Database, Resource }); const server Hapi.server({ port: PORT }) /* 配置 AdminJS */ const adminOptions { databases: [orm], }; /* 將 AdminJS 注冊(cè)為 Hapi 服務(wù)器的插件 */ await server.register({ plugin: AdminJSHapi, options: adminOptions, }); await server.start(); console.log(App listening at ${server.info.uri}); } run();Hapi 與 Express 的主要差異環(huán)節(jié)ExpressHapi接入方式AdminJSExpress.buildRouter(admin)構(gòu)建 Routerserver.register({ plugin: AdminJSHapi, options: adminOptions })注冊(cè)插件AdminJS 配置new AdminJS({ databases: [orm] })放入options傳給插件路由掛載app.use(admin.options.rootPath, router)由插件內(nèi)部自動(dòng)處理啟動(dòng)后管理面板同樣位于http://localhost:{PORT}/admin側(cè)邊欄展示全部實(shí)體并支持 CRUD。五、為管理面板添加認(rèn)證默認(rèn)配置下 AdminJS 是無(wú)認(rèn)證的任何人訪問(wèn)/admin都能管理數(shù)據(jù)這在生產(chǎn)環(huán)境是危險(xiǎn)的。文檔給出了兩種框架的認(rèn)證改造方案。Express改用 buildAuthenticatedRouter把原來(lái)的AdminJSExpress.buildRouter(admin)替換為AdminJSExpress.buildAuthenticatedRouter并傳入認(rèn)證回調(diào)與 cookie 加密口令Beforeconst router AdminJSExpress.buildRouter(admin);Afterconst ADMIN_EMAIL exampletest.com; const ADMIN_PASSWORD password; const router AdminJSExpress.buildAuthenticatedRouter(admin, { authenticate: async (email, password) { /* 在這里編寫校驗(yàn)郵箱與密碼的邏輯 */ return email ADMIN_EMAIL password ADMIN_PASSWORD ? { email } // 認(rèn)證成功后返回包含用戶數(shù)據(jù)的對(duì)象 : null; }, cookiePassword: process.env.COOKIE_PASSWORD ?? makesurepasswordissecure, });要點(diǎn)authenticate返回對(duì)象表示認(rèn)證成功該對(duì)象會(huì)被寫入會(huì)話可作為當(dāng)前登錄用戶信息返回null表示失敗cookiePassword用于加密會(huì)話 cookie務(wù)必從環(huán)境變量讀取且在生產(chǎn)環(huán)境使用足夠強(qiáng)的隨機(jī)字符串切勿沿用示例中的默認(rèn)值示例中的郵箱/密碼僅用于演示真實(shí)項(xiàng)目應(yīng)改為查庫(kù)校驗(yàn)例如結(jié)合密碼哈希比對(duì)。Hapi在 adminOptions 中追加 auth 配置Beforeconst adminOptions { databases: [orm], };Afterconst ADMIN_EMAIL exampletest.com; const ADMIN_PASSWORD password; const adminOptions { databases: [orm], auth: { authenticate: async (email, password) { /* 在這里編寫校驗(yàn)郵箱與密碼的邏輯 */ return email ADMIN_EMAIL password ADMIN_PASSWORD ? { email } // 認(rèn)證成功后返回包含用戶數(shù)據(jù)的對(duì)象 : null; }, strategy: session, cookiePassword: process.env.COOKIE_PASSWORD ?? makesurepasswordissecure, isSecure: false, // 僅允許 https 請(qǐng)求時(shí)設(shè)為 true }, };要點(diǎn)strategy: session表示使用基于會(huì)話session的認(rèn)證策略配合hapi/cookie工作isSecure: false表示允許通過(guò)非 HTTPS 訪問(wèn)本地開發(fā)常用如果站點(diǎn)部署在 HTTPS 之后應(yīng)設(shè)為true否則瀏覽器可能拒絕攜帶 cookie。六、驗(yàn)證與進(jìn)一步定制驗(yàn)證接入是否成功按上述任一方案完成初始化并啟動(dòng)服務(wù)器后可以這樣驗(yàn)證瀏覽器訪問(wèn)http://localhost:{PORT}/admin側(cè)邊欄應(yīng)出現(xiàn)你傳入entities的全部實(shí)體如User、Car、Seller對(duì)每個(gè)實(shí)體嘗試新建、編輯、刪除一條記錄確認(rèn) CRUD 讀寫的是 MikroORM 所連接的數(shù)據(jù)庫(kù)若已開啟認(rèn)證未登錄訪問(wèn)應(yīng)被重定向到登錄頁(yè)。從當(dāng)前倉(cāng)庫(kù)結(jié)構(gòu)看tests/entities 中提供了Author、Book、Publisher等現(xiàn)成實(shí)體定義tests/features 下有各類功能的測(cè)試示例可在本地實(shí)驗(yàn)中參考其實(shí)體寫法。進(jìn)一步定制AdminJS 面板的深度定制自定義頁(yè)面、屬性標(biāo)簽、action 按鈕、表單組件等屬于 AdminJS 框架本身的能力請(qǐng)參閱 AdminJS 官方文檔需要更豐富的資源行為時(shí)可以通過(guò)adminjs/mikroorm的Resource對(duì)實(shí)體資源做細(xì)粒度配置若項(xiàng)目使用 NestJS可參考倉(cāng)庫(kù) usage-with-nestjs 的依賴注入思路把已初始化的 ORM 實(shí)例注入到 AdminJS 初始化邏輯中。生產(chǎn)環(huán)境注意事項(xiàng)憑據(jù)安全DATABASE_URL、COOKIE_PASSWORD等一律通過(guò)環(huán)境變量注入?yún)⒖嘉臋n示例中的process.env寫法會(huì)話保護(hù)cookiePassword必須使用強(qiáng)隨機(jī)值Hapi 側(cè)視部署環(huán)境設(shè)置isSecure只讀需求若管理面板面向內(nèi)部運(yùn)營(yíng)且只允許查看可在 AdminJS 資源上禁用部分 action如 delete避免誤刪數(shù)據(jù)并發(fā)模型AdminJS 面板對(duì)實(shí)體的讀寫經(jīng)由 MikroORM 的EntityManager完成涉及請(qǐng)求上下文RequestContext的場(chǎng)景可參考倉(cāng)庫(kù) RequestContext 相關(guān)實(shí)現(xiàn) 與 unit-of-work 文檔 理解其事務(wù)與上下文行為。七、參考資料本文對(duì)應(yīng)的版本文檔version-7.2 的 usage-with-adminjs未版本化的最新版見 docs/usage-with-adminjs.mdMikroORM 初始化實(shí)現(xiàn)packages/core/src/MikroORM.ts連接參數(shù)定義packages/core/src/utils/Configuration.ts官方為 MikroORM 提供的 AdminJS 適配器示例應(yīng)用位于adminjs/mikroorm包的example-app目錄可將其 clone 到本地對(duì)照運(yùn)行。贊分享后端【免費(fèi)下載鏈接】mikro-ormTypeScript ORM for Node.js based on Data Mapper, Unit of Work and Identity Map patterns. Supports MongoDB, MySQL, MariaDB, MS SQL Server, PostgreSQL and SQLite/libSQL databases.項(xiàng)目地址https://gitcode.com/gh_mirrors/mi/mikro-orm點(diǎn)擊查看免費(fèi)下載相關(guān)推薦在 MikroORM 項(xiàng)目中使用 AdminJS安裝、接入與認(rèn)證配置完整指南在 MikroORM 項(xiàng)目中使用 AdminJS安裝、接入與認(rèn)證配置完整指南 導(dǎo)讀 本文基于 MikroORM 官方文檔 usage with adminj后端在 MikroORM 7.x 中集成 AdminJS從安裝到認(rèn)證授權(quán)的完整實(shí)戰(zhàn)指南在 MikroORM 7.x 中集成 AdminJS從安裝到認(rèn)證授權(quán)的完整實(shí)戰(zhàn)指南 本指南以 MikroORM 7.1 官方文檔 docs/versione后端在 React Router FrameworkRemix v3中集成 react-admin子路由掛載、basename 配置與 Supabase API 代理實(shí)戰(zhàn)在 React Router FrameworkRemix v3中集成 react admin子路由掛載、basename 配置與 Supabase AP前端UI組件上一篇2025 Blender新特性全解析革命性建模工具與AI集成指南下一篇Certbot革命性特性解析ACME協(xié)議客戶端如何徹底改變SSL證書管理創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考