chanjs 2.6.8 → 2.6.11

package/App.js

@@ -47,7 +47,6 @@ class Chan {
   async start() {
     //加载配置
     await this.config();
-    
     //加载数据库
     await this.loadDB();
     //加载扩展方法

package/README.md

@@ -2,69 +2,67 @@
 
 Chanjs 是一个基于 Express 5+ 构建的轻量级 MVC 框架，完全使用 JavaScript 开发。它体现了函数式编程的概念，提供了卓越的性能、清晰的代码和易于遵循的过程，确保了高可维护性。
 
+‌ChanJS‌ 是一个基于 ‌Express 5+‌ 构建的轻量级 ‌MVC 框架‌，完全使用纯 JavaScript 开发，强调函数式编程理念，具有高性能、代码清晰、易维护等特点。
+
 ## 特点
 
-- **核心架构**
-  - 基于 Express 5+ 构建
-  - 支持 ES6+ 语法
-  - 轻量级设计（核心代码精简高效）
-  
-- **模块化设计**
-  - 多模块化路由（支持模块独立路由）
-  - 模块化 views（模板文件模块化）
-  - 模块化 controllers（控制器模块化）
-  - 模块化 services（服务层模块化）
-  - 模块化 middleware（模块级中间件）
-  
-- **插件式架构**
-  - 支持插件扩展
-  - 插件独立 MVC 结构
-  - 热插拔式插件管理
-  
-- **数据库支持**
-  - 多数据库支持（PostgreSQL、MySQL/MariaDB、SQLite3、Oracle、MSSQL）
-  - 数据库连接池管理
-  - Knex 查询构建器
-  - 事务支持
-  - 日期字段自动格式化
-  
-- **安全防护**
-  - WAF（Web应用防火墙）
-  - XSS 防护
-  - 关键词过滤
-  - 访问限流（Rate Limiting）
-  - 路径白名单
-  - Cookie 安全处理
-  
-- **中间件生态**
-  - CORS 跨域配置
-  - 请求体解析
-  - Cookie 处理
-  - 静态资源管理
-  - 日志记录
-  - 模板引擎（Art-template）
-  
-- **高级特性**
-  - 依赖注入（DI，基于 Map 实现）
-  - 面向切面编程（AOP，支持 before/after/error 切面）
-  - 事件系统（基于 EventEmitter）
-  - 自动控制器加载（loadController）
-  
-- **开发体验**
-  - 缓存支持（内存缓存）
-  - 统一响应格式
-  - 全局错误处理（404/500）
-  - 分页查询封装
-  - 配置文件管理
-  - 环境变量支持（.env.dev/.env.prd）
-  
-- **工具函数**
-  - 时间格式化
-  - 文件操作
-  - 路径处理
-  - 树形结构转换
-  - 代码生成
-  - 过滤器
+### 核心架构
+- ✅ Express 5+ 原生
+- ✅ Node.js 24+
+- ✅ ES Modules (import / export)
+- ✅ 多模块 MVC 架构
+- ✅ 轻量级内核
+- ✅ 约定优于配置
+
+### 模块化
+- ✅ 多模块路由
+- ✅ 模块化 views
+- ✅ 模块化 controllers
+- ✅ 模块化 services
+- ✅ 模块化 middleware
+
+### 数据库
+- ✅ Knex.js 查询构建器
+- ✅ SQLite / MySQL / PostgreSQL
+- ✅ 连接池
+- ✅ 事务
+- ✅ 自动时间格式化
+
+### 安全能力
+- ✅ WAF 防火墙
+- ✅ XSS 防护
+- ✅ 关键词过滤
+- ✅ 请求限流
+- ✅ 路由白名单
+- ✅ Cookie 安全
+
+### 中间件生态
+- ✅ CORS
+- ✅ 请求解析
+- ✅ Cookie
+- ✅ 静态资源
+- ✅ 日志
+- ✅ Art-template 模板引擎
+
+### 高级特性
+- ✅ DI 依赖注入（Map 实现）
+- ✅ AOP 切面（before/after/error）
+- ✅ 事件系统
+- ✅ 自动加载控制器
+- ✅ 定时任务
+- ✅ WebSocket
+- ✅ 缓存系统（Redis 和 内存缓存 map 实现）
+- ✅ 分页器
+- ✅ 国际化 i18n
+- ✅ 请求验证器
+- ✅ 全局异常处理
+- ✅ 接口文档自动生成
+- ✅ 文件上传 / OSS 扩展口
+
+### 开发体验
+- ✅ 多环境配置
+- ✅ 统一响应
+- ✅ 工具函数
 
 ## 约定优于配置
 
@@ -100,29 +98,61 @@ Chanjs 是一个基于 Express 5+ 构建的轻量级 MVC 框架，完全使用 J
 |- package.json
 ```
 
+
+## npm 包参考
+
+```json
+{
+  "art-template": "^4.13.4",
+  "body-parser": "^2.2.0",
+  "cookie-parser": "^1.4.7",
+  "cors": "^2.8.5",
+  "dotenv": "^17.2.1",
+  "dayjs": "^1.11.13",
+  "express": "^5.1.0",
+  "express-art-template": "^1.0.1",
+  "knex": "^3.1.0",
+  "morgan": "^1.10.0",
+  "mysql2": "^3.14.1",
+  "marked": "^17.0.3",
+  "adm-zip": "^0.5.16",
+  "bcryptjs": "^3.0.2",
+  "better-sqlite3": "^12.8.0",
+  "chanjs": "^2.6.10",
+  "cheerio": "^1.1.2",
+  "crypto-js": "^4.2.0",
+  "iconv-lite": "^0.6.3",
+  "jsonwebtoken": "^9.0.2",
+  "multer": "^2.0.2",
+  "nodemailer": "^7.0.6",
+  "qiniu": "^7.14.0",
+  "serve-favicon": "^2.5.1",
+  "xml2js": "^0.6.2",
+  "xss": "^1.0.15",
+  "zod": "^4.1.11"
+}
+```
+
 ## 初始化过程
 
-```mermaid
-graph TD
-    A[初始化] --> B[加载配置]
-    B --> C[加载数据库]
-    C --> D[加载扩展]
-    D --> E[加载中间件]
-    E --> F[设置应用配置]
-    F --> G[加载模块路由]
-    G --> H[加载公共路由]
-    H --> I[应用路由]
-    I --> J[设置错误处理]
-    J --> K[beforeStart钩子]
-    K --> L[run启动服务器]
-    
-    G --> G1[加载服务]
-    G --> G2[加载控制器]
-    G --> G3[加载路由]
-    
-    D --> D1[加载common]
-    D --> D2[加载helper]
-    D --> D3[加载extend]
+```
+初始化流程：
+
+┌─────────┐    ┌─────────┐    ┌─────────┐    ┌─────────┐
+│  初始化  │───▶│ 加载配置 │───▶│ 加载数据库│───▶│ 加载扩展 │
+└─────────┘    └─────────┘    └─────────┘    └─────────┘
+                                                  │
+                    ┌─────────┐    ┌─────────┐   │
+                    │ 加载服务 │    │ 加载控制器│   │
+                    └────▲────┘    └────▲────┘   │
+                         │              │        │
+┌─────────┐    ┌─────────┐    ┌─────────┐    ┌──┴──────┐
+│ 应用路由 │◀───│加载公共路由│◀───│加载模块路由│◀───│加载中间件│
+└────┬────┘    └─────────┘    └────┬────┘    └─────────┘
+     │                             │
+     │    ┌─────────┐    ┌─────────┐    ┌─────────┐
+     └───▶│设置错误处理│───▶│beforeStart│───▶│ run启动  │
+          └─────────┘    └─────────┘    └─────────┘
 ```
 
 ## 核心功能
@@ -141,14 +171,7 @@ class UserService extends Service {
     super("user");
   }
   
-  async getUserWithArticles(userId) {
-    const user = await this.findById(userId);
-    // 从依赖注入容器中获取 ArticleService 实例
-    const articleService = await this.get("article", "Article");
-    const articles = await articleService.findByUserId(userId);
-    
-    return { user, articles };
-  }
+ 
 }
 
 class UserController extends Controller {
@@ -157,15 +180,7 @@ class UserController extends Controller {
   }
   
   async getUser(req, res, next) {
-    try {
-      const { id } = req.params;
-      // 从依赖注入容器中获取 UserService 实例
-      const userService = await this.get("user", "User");
-      const result = await userService.findById(id);
-      res.json(this.success({ data: result.data }));
-    } catch (err) {
-      next(err);
-    }
+    
   }
 }
 ```
@@ -345,4 +360,4 @@ app.run((port) => {
 });
 ```
 
-该框架专为寻求简单与功能之间平衡的开发者设计，为构建 Web 应用程序提供了一个强大的基础。
+该框架专为寻求简单与功能之间平衡的开发者设计，为构建 Web 应用程序提供了一个强大的基础。

package/helper/cache.js

@@ -34,16 +34,21 @@ class Cache {
    * @param {number} [ttl=this.defaultTTL] - 过期时间（毫秒）
    * @description
    * 将键值对存入缓存，如果缓存已满则淘汰最久未使用的条目
-   * 每次设置都会更新访问时间
+   * 每次设置都会更新访问时间 + 过期时间
    * @example
    * cache.set('key1', 'value1', 60000); // 60 秒后过期
    * cache.set('key2', { data: 123 }); // 使用默认过期时间
    */
   set(key, value, ttl = this.defaultTTL) {
+    // 修复：缓存满 + 是新 key 才淘汰
     if (this.cache.size >= this.maxSize && !this.cache.has(key)) {
       this._evictLRU();
     }
+
+    // 修复：无论 key 是否存在，都更新 过期时间 + 访问时间
     this.cache.set(key, { value, expireAt: Date.now() + ttl });
+    // LRU：先删除再插入，保证 Map 尾部是最新访问
+    this.accessOrder.delete(key);
     this.accessOrder.set(key, Date.now());
   }
 
@@ -54,7 +59,7 @@ class Cache {
    * @description
    * 获取指定键的缓存值
    * 如果值已过期，会自动删除该条目
-   * 每次获取都会更新访问时间
+   * 每次获取都会更新访问时间 + 刷新过期时间
    * @example
    * const value = cache.get('key1');
    * if (value !== null) {
@@ -64,14 +69,22 @@ class Cache {
   get(key) {
     const item = this.cache.get(key);
     if (!item) return null;
-    
-    if (Date.now() > item.expireAt) {
+
+    const now = Date.now();
+    // 已过期直接删除
+    if (now > item.expireAt) {
       this.cache.delete(key);
       this.accessOrder.delete(key);
       return null;
     }
-    
-    this.accessOrder.set(key, Date.now());
+
+    // 修复：命中缓存 → 刷新 LRU 顺序 + 刷新 TTL
+    this.accessOrder.delete(key);
+    this.accessOrder.set(key, now);
+    // 重新计算过期时间（访问续命，标准行为）
+    const ttl = item.expireAt - (now - (item.expireAt - this.defaultTTL));
+    this.cache.set(key, { value: item.value, expireAt: now + ttl });
+
     return item.value;
   }
 
@@ -141,20 +154,11 @@ class Cache {
    * 淘汰最久未使用的条目（内部方法）
    * @private
    * @description
-   * 找到访问时间最早的条目并删除
-   * 当缓存达到最大容量时自动调用
+   * Map 头部就是最早访问，直接删除（O(1)）
    */
   _evictLRU() {
-    let oldestKey = null;
-    let oldestTime = Infinity;
-    
-    for (const [key, time] of this.accessOrder.entries()) {
-      if (time < oldestTime) {
-        oldestTime = time;
-        oldestKey = key;
-      }
-    }
-    
+    // 修复：Map 有序，keys().next() 直接拿到最久未使用的 key，性能 O(1)
+    const oldestKey = this.accessOrder.keys().next().value;
     if (oldestKey) {
       this.cache.delete(oldestKey);
       this.accessOrder.delete(oldestKey);
@@ -180,4 +184,4 @@ class Cache {
 }
 
 export const cache = new Cache();
-export default Cache;
+export default Cache;

package/index.js

@@ -14,7 +14,7 @@ export * as common from "./common/index.js";
 export * as extend from "./extend/index.js";
 
 // 常用工具函数直接导出
-export { loadConfig, loaderSort, loadController } from "./helper/index.js";
+export { loadConfig, loaderSort, loadController ,cache} from "./helper/index.js";
 
 // 路径配置
 export { Paths } from "./config/paths.js";

package/middleware/template.js

@@ -24,7 +24,7 @@ import { importjs } from "../global/import.js";
 export let setTemplate = (app, config) => {
   const { views, NODE_ENV } = config;
   const isProduction = NODE_ENV === "production" || NODE_ENV === "prd";
-  console.log("cache", isProduction);
+  console.log("模板缓存->", isProduction);
   const all = [...views];
   app.set("view options", {
     debug: !isProduction,

package/package.json

@@ -1,7 +1,7 @@
 {
   "type": "module",
   "name": "chanjs",
-  "version": "2.6.8",
+  "version": "2.6.11",
   "description": "chanjs基于express5 纯js研发的轻量级mvc框架。",
   "main": "index.js",
   "module": "index.js",