chanjs 1.0.36 → 1.0.38

package/README.md

@@ -1,22 +1,22 @@
 
-# Chan.js
+# Chanjs
 
-Chan.js is a lightweight MVC framework developed in pure JavaScript based on Express. It embodies functional programming concepts, offering superior performance, clear code, and easy-to-follow processes that ensure high maintainability.
+Chanjs 是一个基于 Express 构建的轻量级 MVC 框架，完全使用 JavaScript 开发。它体现了函数式编程的概念，提供了卓越的性能、清晰的代码和易于遵循的过程，确保了高可维护性。
 
 ## features
 
-- Built on top of Express
-- Supports ES6 syntax
-- Modular Design
-  - Supports multiple module routes
-  - Supports multiple module views
-  - Supports multiple module controllers
-  - Supports multiple module services
-- Plugin-based architecture
-- Lightweight (core code within 300 lines)
-- Long-term maintenance
+- 基于 Express 构建
+- 支持 ES6 语法
+- 模块化设计
+  - 多模块化路由
+  - 模块化 views
+  - 模块化 controllers
+  - 模块化 services
+- 插件式架构
+- 轻量级（核心代码在300行以内）
+- 缓存支持
 
-## Conventions Over Configuration
+## 约定优于配置
 
 ```code
 |- app
@@ -49,51 +49,51 @@ Chan.js is a lightweight MVC framework developed in pure JavaScript based on Exp
 |- index.js
 ```
 
-### Initialization Process
+### 初始化过程
 
-- Initialization
-- Load configuration
-- Load modules
-  - Load services
-  - Load controllers
-  - Load routers
-- Load extensions
-- Load plugins
-  - Load services
-  - Load controllers
-  - Load routers
-- beforeStart() Hook to merge configurations from the database into the configuration
-- run() Start the server
+- 初始化
+- 加载配置
+- 加载模块
+  - 加载服务
+  - 加载控制器
+  - 加载路由
+- 加载扩展
+- 加载插件
+  - 加载服务
+  - 加载控制器
+  - 加载路由
+- `beforeStart()` 钩子用于将数据库中的配置合并到配置中
+- `run()` 启动服务器
 
-### Official Website
+### ### 官方网站
 
-A CMS system developed with Chan.js
-Website：<https://www.chancms.top>
+使用 Chanjs 开发的 CMS 系统  
+网站：[https://www.chancms.top](https://www.chancms.top)
   
-### Highlights
+### 功能亮点
 
-- Configuration files
-- Multi-module MVC structure
-- Plugin MVC support
-- CORS cross-origin configuration support
-- MySQL database support
-- Route control
-- Art-template template engine
-- Static resources management
-- Cookie handling
-- Logging capabilities
+- 配置文件
+- 多模块 MVC 结构
+- 插件 MVC 支持
+- CORS 跨域配置支持
+- MySQL 数据库支持
+- 路由控制
+- Art-template 模板引擎
+- 静态资源管理
+- Cookie 处理
+- 日志功能
 
-### run
+### 运行
 
 ```javascript
 const Chanjs = require("chanjs");
 const chan = new Chanjs();
-// Load middleware
+// 加载中间件
 chan.beforeStart(fn);
-// Scan modules
+// 扫描模块
 chan.start();
-// Start the server
+// 启动服务器
 chan.run();
 ```
 
-This framework is designed for developers who seek a balance between simplicity and functionality, providing a robust foundation for building web applications with ease.
+该框架专为寻求简单与功能之间平衡的开发者设计，为构建 Web 应用程序提供了一个强大的基础。

package/core/chan.js

@@ -6,6 +6,7 @@ const config = require("./lib/config/config.js");
 const {bindClass,createKnex,loadWebToEnd} = require("./lib/extend/helper.js");
 const Controller = require("./lib/controller/controller.js");
 const Service = require("./lib/service/service.js");
+const cache = require('./lib/extend/cache.js');
 const core = require("./lib/index.js");
 /**
  * @description 基于express封装的mvc框架，遵循约定优于配置原则
@@ -15,6 +16,7 @@ class Chan {
   static modules = {};
   static plugins = {};
   static config = config;
+  static cache = cache;
   static Controller = Controller;
   static Service = Service;
   constructor() {
@@ -130,30 +132,25 @@ class Chan {
     this.loadRoutes(modules, moduleName);
   }
 
+  loadFiles(modules, moduleName, type) {
+    const dir = path.join(Chan.config.APP_PATH, modules, moduleName, type);
+    if (fs.existsSync(dir)) {
+      const files = fs.readdirSync(dir).filter(file => file.endsWith(".js"));
+      files.forEach(file => {
+        const module = require(path.join(dir, file));
+        const name = file.replace(".js", "");
+        Chan[modules][moduleName][type][name] = { ...bindClass(module) };
+      });
+    }
+  }
+
   /**
    * @description 扫描模块下所有service
    * @param {*} moduleDir 模块路径
    * @param {*} moduleName 模块名称
    */
   loadServices(modules, moduleName) {
-    const servicesDir = path.join(
-      Chan.config.APP_PATH,
-      modules,
-      moduleName,
-      "service"
-    );
-    if (fs.existsSync(servicesDir)) {
-      let services = fs
-        .readdirSync(servicesDir)
-        .filter((file) => file.endsWith(".js"));
-      for (let i = 0, file; i < services.length; i++) {
-        file = services[i];
-        const Service = require(path.join(servicesDir, file));
-        const serviceName = file.replace(".js", "");
-        //模块文件夹-模块文件名-服务-方法
-        Chan[modules][moduleName].service[serviceName] = {...bindClass(Service)};
-      }
-    }
+    this.loadFiles(modules, moduleName, "service");
   }
 
   /**
@@ -162,23 +159,7 @@ class Chan {
    * @param {*} moduleName 模块名称
    */
   loadControllers(modules, moduleName) {
-    const controllersDir = path.join(
-      Chan.config.APP_PATH,
-      modules,
-      moduleName,
-      "controller"
-    );
-    if (fs.existsSync(controllersDir)) {
-      let controllers = fs
-        .readdirSync(controllersDir)
-        .filter((file) => file.endsWith(".js"));
-      for (let i = 0, file; i < controllers.length; i++) {
-        file = controllers[i];
-        const controller = require(path.join(controllersDir, file));
-        const controllerName = file.replace(".js", "");
-        Chan[modules][moduleName].controller[controllerName] = {...bindClass(controller)};
-      }
-    }
+    this.loadFiles(modules, moduleName, "controller");
   }
 
   /**

package/core/lib/extend/cache.js

@@ -0,0 +1,134 @@
+class Cache {
+    constructor(maxSize = 1000) {
+      this.cache = new Map(); // 使用 Map 存储缓存数据
+      this.maxSize = maxSize; // 缓存最大容量
+      this.hits = 0; // 缓存命中次数
+      this.misses = 0; // 缓存未命中次数
+    }
+  
+    /**
+     * 设置缓存
+     * @param {string} key - 缓存键
+     * @param {any} value - 缓存值
+     * @param {number} ttl - 缓存时间（毫秒），可选
+     */
+    set(key, value, ttl = null) {
+      // 如果缓存已满，删除最早的一个缓存项
+      if (this.cache.size >= this.maxSize) {
+        const firstKey = this.cache.keys().next().value;
+        this.cache.delete(firstKey);
+      }
+  
+      const cacheItem = {
+        value,
+        expires: ttl ? Date.now() + ttl : null, // 设置过期时间
+        updatedAt: Date.now(), // 记录更新时间
+      };
+      this.cache.set(key, cacheItem);
+    }
+  
+    /**
+     * 获取缓存
+     * @param {string} key - 缓存键
+     * @returns {any} - 缓存值，如果过期或不存在则返回 null
+     */
+    get(key) {
+      if (!this.cache.has(key)) {
+        this.misses++; // 未命中
+        return null;
+      }
+  
+      const cacheItem = this.cache.get(key);
+  
+      // 检查是否过期
+      if (cacheItem.expires && Date.now() > cacheItem.expires) {
+        this.cache.delete(key); // 删除过期缓存
+        this.misses++; // 未命中
+        return null;
+      }
+  
+      this.hits++; // 命中
+      return cacheItem.value; // 返回缓存值
+    }
+  
+    /**
+     * 清除指定缓存
+     * @param {string} key - 缓存键
+     */
+    clear(key) {
+      this.cache.delete(key);
+    }
+  
+    /**
+     * 清除所有缓存
+     */
+    clearAll() {
+      this.cache.clear();
+      this.hits = 0;
+      this.misses = 0;
+    }
+  
+    /**
+     * 获取缓存命中率
+     * @returns {number} - 命中率（0 到 1 之间）
+     */
+    getHitRate() {
+      const total = this.hits + this.misses;
+      return total === 0 ? 0 : this.hits / total;
+    }
+  
+    /**
+     * 获取缓存大小
+     * @returns {number} - 缓存项数量
+     */
+    size() {
+      return this.cache.size;
+    }
+  
+    /**
+     * 获取所有缓存键
+     * @returns {string[]} - 缓存键列表
+     */
+    keys() {
+      return Array.from(this.cache.keys());
+    }
+  
+    /**
+     * 遍历缓存项
+     * @param {function} callback - 回调函数，接收 key 和 value 作为参数
+     */
+    forEach(callback) {
+      this.cache.forEach((cacheItem, key) => {
+        callback(key, cacheItem.value);
+      });
+    }
+}
+
+module.exports = new Cache();
+  
+//   // 示例用法
+//   const cache = new SimpleCache(100); // 设置缓存最大容量为 100
+  
+//   // 设置缓存，有效期为 5 秒
+//   cache.set('name', 'Alice', 5000);
+//   cache.set('name', 'Alice', 5000);
+//   // 获取缓存
+//   console.log(cache.get('name')); // 输出: Alice
+  
+//   // 获取缓存命中率
+//   console.log(cache.getHitRate()); // 输出: 1 (100% 命中率)
+  
+//   // 获取缓存大小
+//   console.log(cache.size()); // 输出: 1
+  
+//   // 获取所有缓存键
+//   console.log(cache.keys()); // 输出: ['name']
+  
+//   // 遍历缓存项
+//   cache.forEach((key, value) => {
+//     console.log(`Key: ${key}, Value: ${value}`);
+//   });
+  
+//   // 清除所有缓存
+//   cache.clearAll();
+//   console.log(cache.size()); // 输出: 0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chanjs",
-  "version": "1.0.36",
+  "version": "1.0.38",
   "description": "chanjs基于express 纯js研发的轻量级mvc框架。",
   "main": "core/chan.js",
   "module": "core/chan.js",