mm_statics 1.5.3 → 1.5.4

package/eslint.config.js

@@ -32,11 +32,8 @@ module.exports = [
       'naming-convention/method-name': 'error',
       'naming-convention/variable-name': 'warn',
       'naming-convention/constant-name': 'error',
-      'naming-convention/private-method-naming': 'warn',
-      'naming-convention/private-variable-naming': 'warn',
       'naming-convention/param-name': 'error', // 启用入参名规则
       'naming-convention/property-name': 'warn',
-      'naming-convention/instance-property': 'warn',
       
       // 禁用与命名规范插件冲突的默认规则
       'camelcase': 'off',

package/index.js

@@ -2,6 +2,14 @@ let send = require('koa-send');
 const { EsToAmdConvert } = require('mm_es6_to_amd');
 const { parse } = require('@vue/compiler-sfc');
 
+// 初始化mm_expand模块
+require('mm_expand');
+
+// 确保$对象已初始化
+if (!global.$) {
+  throw new Error('mm_expand模块初始化失败，$对象不存在');
+}
+
 /**
  * 静态文件处理类
  */
@@ -16,7 +24,9 @@ class Static {
     cache: true,
     // 后端缓存时间，单位秒
     cache_age: 7200,
+    // 是否开启immutable缓存头
     immutable: true,
+    //
     hidden: false,
     format: true,
     extensions: false,
@@ -27,11 +37,14 @@ class Static {
     compile_vue: true,
     // 指定路径文件需要转换
     path: '/src',
+    // 
     files: ['.js', '.vue'],
     // 是否将files中的文件的js转换为amd格式
     convert_amd: true,
     // 是否启用文件修改监听（实时检测文件修改）
-    watch_files: false
+    watch_files: false,
+    // 是否检查文件修改时间（当watch_files为false时生效）
+    check_file_mtime: false
   };
 
   /**
@@ -41,8 +54,10 @@ class Static {
   constructor(config) {
     this.config = { ...Static.config };
     this.convert = new EsToAmdConvert();
-    this.setConfig(config);
     this._cache = null;
+    this._cache_config_prefix = this._generateConfigPrefix(); // 初始化配置前缀
+    this._cache_headers = this._generateCacheHeaders(); // 初始化缓存头
+    this.setConfig(config);
     this._init();
   }
 }
@@ -94,9 +109,7 @@ Static.prototype._initFileWatcher = function () {
   if (this.config.watch_files) {
     try {
       this._chokidar = require('chokidar');
-      console.log('[Static] 文件监听功能已启用（使用chokidar）');
     } catch (error) {
-      console.error('[Static] 加载chokidar模块失败:', error.message);
       this.config.watch_files = false;
     }
   }
@@ -130,7 +143,6 @@ Static.prototype._addFileWatcher = function (file_path, cache_key) {
     
     // 监听文件修改事件
     watcher.on('change', (path) => {
-      console.log(`[Static] 检测到文件修改: ${path}`);
       // 文件修改时清除缓存
       this._cache.del(cache_key).catch(error => {
         console.error(`[Static] 清除缓存失败: ${error.message}`);
@@ -176,21 +188,14 @@ Static.prototype._getCache = async function (path, full_path) {
   // 生成缓存键
   let cache_key = this._generateCacheKey(path);
 
-  // 统一获取缓存数据
+  // 统一获取缓存数据 - 缓存模块会自动处理TTL过期
   let data = await this._cache.get(cache_key);
 
   if (!data) return null;
 
-  // 简单的缓存过期检查，基于时间戳
-  let current_time = Date.now();
-  if (current_time - data.timestamp > this.config.cache_age * 1000) {
-    // 缓存已过期，清除缓存
-    await this._cache.del(cache_key);
-    return null;
-  }
-
-  // 检查文件是否已修改（仅在未启用文件监听时检查）
-  if (!this.config.watch_files && full_path && data.file_mtime) {
+  // 仅在未启用文件监听且需要检查文件修改时进行检查
+  // 减少文件系统操作，提高性能
+  if (!this.config.watch_files && this.config.check_file_mtime && full_path && data.file_mtime) {
     let current_mtime = this._getFileMtime(full_path);
     if (current_mtime && current_mtime !== data.file_mtime) {
       // 文件已修改，清除缓存
@@ -209,10 +214,9 @@ Static.prototype._getCache = async function (path, full_path) {
  */
 Static.prototype._getFileMtime = function (file_path) {
   try {
-    let fs = require('fs');
-    let stats = fs.statSync(file_path);
-    return stats.mtime.getTime();
-  } catch (error) {
+    let stats = file_path.stat();
+    return stats ? stats.mtime.getTime() : null;
+  } catch (_error) {
     return null;
   }
 };
@@ -238,7 +242,8 @@ Static.prototype._setCache = async function (path, content, mime_type, file_mtim
     file_mtime: file_mtime || Date.now() // 如果没有提供文件修改时间，使用当前时间
   };
 
-  // 统一设置缓存数据
+  // 统一设置缓存数据 - 充分利用缓存模块的TTL机制
+  // 缓存模块会自动处理过期，无需手动检查时间戳
   await this._cache.set(cache_key, data, this.config.cache_age);
 
   // 如果启用文件监听，添加文件监听器
@@ -247,17 +252,40 @@ Static.prototype._setCache = async function (path, content, mime_type, file_mtim
   }
 };
 
+/**
+ * 生成配置前缀
+ * @returns {string} 配置前缀
+ */
+Static.prototype._generateConfigPrefix = function () {
+  return `${this.config.convert_amd ? 'amd' : 'noamd'}_${this.config.files.join('-')}_${this.config.path.replace(/[^a-zA-Z0-9]/g, '_')}`;
+};
+
+/**
+ * 生成缓存头信息
+ * @returns {object} 缓存头对象
+ */
+Static.prototype._generateCacheHeaders = function () {
+  let headers = {};
+  
+  if (this.config.max_age) {
+    let cache_control = 'max-age=' + this.config.max_age;
+    if (this.config.immutable) {
+      cache_control += ',immutable';
+    }
+    headers['Cache-Control'] = cache_control;
+  }
+  
+  return headers;
+};
+
 /**
  * 生成包含配置信息和文件内容哈希的缓存键
  * @param {string} path 文件路径
  * @returns {string} 缓存键
  */
 Static.prototype._generateCacheKey = function (path) {
-  // 纯路径标识：使用配置和路径作为缓存键
-  let config_prefix = `${this.config.convert_amd ? 'amd' : 'noamd'}_${this.config.files.join('-')}_${this.config.path.replace(/[^a-zA-Z0-9]/g, '_')}`;
-
-  // 直接使用路径作为唯一标识，不依赖文件内容
-  return this.config.key_prefix + config_prefix + ':' + path.replace(/[^a-zA-Z0-9]/g, '_');
+  // 直接使用缓存的配置前缀
+  return this.config.key_prefix + this._cache_config_prefix + ':' + path.replace(/[^a-zA-Z0-9]/g, '_');
 };
 
 /**
@@ -267,6 +295,9 @@ Static.prototype._generateCacheKey = function (path) {
 Static.prototype.setConfig = function (config) {
   if (config) {
     Object.assign(this.config, config);
+    // 配置改变时，立即重新计算缓存配置前缀和缓存头
+    this._cache_config_prefix = this._generateConfigPrefix();
+    this._cache_headers = this._generateCacheHeaders();
   }
   if (this.config.extensions && this.config.extensions.length === 0) {
     this.config.extensions = false;
@@ -437,7 +468,7 @@ Static.prototype._convertToDirectVueComponent = function (script_content, vue_co
     const opts = this._cleanScriptContent(script_parsed);
 
     return this._buildVueComponentCode(name, opts, desc);
-  } catch (error) {
+  } catch (_error) {
     // Vue文件解析失败，使用回退方案
     return this._fallbackVueConversion(script_content, vue_content);
   }
@@ -461,7 +492,7 @@ Static.prototype._shouldParseVue = function (vue_content) {
  * @returns {object} Vue描述符
  */
 Static.prototype._parseVueDescriptor = function (vue_content) {
-  const { descriptor, errors } = parse(vue_content);
+  let { descriptor, errors } = parse(vue_content);
 
   if (errors && errors.length > 0) {
     // Vue文件解析错误
@@ -856,27 +887,20 @@ Static.prototype._setHeaders = function (ctx, path) {
   }
 };
 
-/**
- * 发送静态文件
- * @param {object} ctx 上下文
- * @param {string} file_path 文件路径
- */
 /**
  * 发送二进制文件
  * @param {object} ctx 请求上下文
  * @param {string} file_path 文件路径
  */
 Static.prototype._sendBinaryFile = async function (ctx, file_path) {
-  // 处理二进制文件
-  await send(ctx, file_path, {
+  // 处理二进制文件 - 使用koa-send优化大文件传输
+  let relative_path = file_path.startsWith('/') ? file_path.substring(1) : file_path;
+  
+  // 使用koa-send发送文件，支持流式传输、断点续传等优化
+  await send(ctx, relative_path, {
     root: this.config.root,
-    maxage: this.config.max_age,
-    immutable: this.config.immutable,
-    hidden: this.config.hidden,
-    format: this.config.format,
-    extensions: this.config.extensions,
-    brotli: this.config.brotli,
-    gzip: this.config.gzip
+    maxage: this.config.max_age || 7200000, // 2小时缓存
+    immutable: this.config.immutable || false
   });
 };
 
@@ -888,9 +912,15 @@ Static.prototype._sendBinaryFile = async function (ctx, file_path) {
  */
 Static.prototype._sendFromCache = function (ctx, file_path, data) {
   // 使用缓存内容
-  ctx.response.type = data.mime_type;
+  ctx.status = 200;
+  ctx.type = data.mime_type;
   ctx.body = data.content;
-  this._setHeaders(ctx, file_path);
+  
+  // 设置缓存头
+  let headers = this._getCacheHeaders();
+  for (let k in headers) {
+    ctx.set(k, headers[k]);
+  }
 };
 
 /**
@@ -901,6 +931,13 @@ Static.prototype._sendFromCache = function (ctx, file_path, data) {
  */
 Static.prototype._sendNewContent = async function (ctx, file_path, full_path) {
   let original_content = full_path.loadText();
+  
+  // 检查文件内容是否成功加载
+  if (original_content === undefined) {
+    ctx.status = 404;
+    return;
+  }
+  
   let mime_type = this._getMimeType(file_path);
 
   // 检查是否需要转换
@@ -918,14 +955,21 @@ Static.prototype._sendNewContent = async function (ctx, file_path, full_path) {
   }
 
   // 获取文件修改时间戳
-   let file_mtime = this._getFileMtime(full_path);
-   
-   // 缓存转换后的内容（包含文件修改时间戳和文件监听）
-   await this._setCache(file_path, final_content, mime_type, file_mtime, full_path);
+  let file_mtime = this._getFileMtime(full_path);
+  
+  // 缓存转换后的内容（包含文件修改时间戳和文件监听）
+  await this._setCache(file_path, final_content, mime_type, file_mtime, full_path);
 
-  ctx.response.type = mime_type;
+  // 设置响应
+  ctx.status = 200;
+  ctx.type = mime_type;
   ctx.body = final_content;
-  this._setHeaders(ctx, file_path);
+  
+  // 设置缓存头
+  let headers = this._getCacheHeaders();
+  for (let k in headers) {
+    ctx.set(k, headers[k]);
+  }
 };
 
 Static.prototype._send = async function (ctx, file_path) {
@@ -933,7 +977,7 @@ Static.prototype._send = async function (ctx, file_path) {
     let relative_path = file_path.startsWith('/') ? file_path.substring(1) : file_path;
     let full_path = relative_path.fullname(this.config.root);
 
-    if (!full_path.hasFile()) {
+    if (!full_path.isFile()) {
       ctx.status = 404;
       return;
     }
@@ -1005,16 +1049,16 @@ Static.prototype._isTextByExtension = function (file_path) {
  */
 Static.prototype._isTextByContent = function (file_path) {
   try {
-    let fs = require('fs');
-    if (!fs.existsSync(file_path)) return false;
+    if (!file_path.hasFile()) return false;
 
-    let stats = fs.statSync(file_path);
-    if (!stats.isFile()) return false;
+    let stats = file_path.stat();
+    if (!stats || !stats.isFile()) return false;
 
-    let fd = fs.openSync(file_path, 'r');
-    let buffer = Buffer.alloc(512);
-    let bytes_read = fs.readSync(fd, buffer, 0, 512, 0);
-    fs.closeSync(fd);
+    let content = file_path.loadText('binary');
+    if (!content) return false;
+
+    let buffer = Buffer.from(content, 'binary');
+    let bytes_read = Math.min(buffer.length, 512);
 
     let count = 0;
     for (let i = 0; i < bytes_read; i++) {
@@ -1025,7 +1069,7 @@ Static.prototype._isTextByContent = function (file_path) {
     }
 
     return (count / bytes_read) > 0.9;
-  } catch (error) {
+  } catch (_error) {
     return false;
   }
 };
@@ -1087,16 +1131,16 @@ Static.prototype._isBinaryByExtension = function (file_path) {
  */
 Static.prototype._isBinaryByContent = function (file_path) {
   try {
-    let fs = require('fs');
-    if (!fs.existsSync(file_path)) return false;
+    if (!file_path.hasFile()) return false;
 
-    let stats = fs.statSync(file_path);
-    if (!stats.isFile()) return false;
+    let stats = file_path.stat();
+    if (!stats || !stats.isFile()) return false;
 
-    let fd = fs.openSync(file_path, 'r');
-    let buffer = Buffer.alloc(512);
-    let bytes_read = fs.readSync(fd, buffer, 0, 512, 0);
-    fs.closeSync(fd);
+    let content = file_path.loadText('binary');
+    if (!content) return false;
+
+    let buffer = Buffer.from(content, 'binary');
+    let bytes_read = Math.min(buffer.length, 512);
 
     let has_binary_chars = false;
     for (let i = 0; i < bytes_read; i++) {
@@ -1108,7 +1152,7 @@ Static.prototype._isBinaryByContent = function (file_path) {
     }
 
     return has_binary_chars;
-  } catch (error) {
+  } catch (_error) {
     return false;
   }
 };
@@ -1124,6 +1168,31 @@ Static.prototype.isBinaryFile = function (file_path) {
   return is_binary_by_content || is_binary_by_ext;
 };
 
+/**
+ * 获取缓存头信息
+ * @returns {object} 缓存头对象
+ */
+Static.prototype._getCacheHeaders = function () {
+  // 直接使用缓存的头对象
+  return this._cache_headers;
+};
+
+/**
+ * 读取二进制文件
+ * @param {string} file_path 文件路径
+ * @returns {Buffer} 文件内容
+ */
+Static.prototype._readBinaryFile = async function (file_path) {
+  let relative_path = file_path.startsWith('/') ? file_path.substring(1) : file_path;
+  let full_path = relative_path.fullname(this.config.root);
+  
+  if (full_path.isFile() && full_path.hasFile()) {
+    return full_path.loadText('binary');
+  }
+  
+  return null;
+};
+
 /**
  * 执行静态文件处理
  * @param {object} ctx http请求上下文
@@ -1134,8 +1203,18 @@ Static.prototype.run = async function (ctx, next) {
   await next();
   if (!this._shouldProcess(ctx)) return;
 
-  // 直接使用koa-send处理路径映射
-  await this._send(ctx, ctx.path);
+  // 处理静态文件请求
+  let result = await this._send(ctx.path);
+  
+  // 设置响应状态和内容
+  ctx.status = result.status;
+  if (result.type) ctx.type = result.type;
+  if (result.body) ctx.body = result.body;
+  if (result.headers) {
+    for (let key in result.headers) {
+      ctx.set(key, result.headers[key]);
+    }
+  }
 };
 
 // 导出Static类用于测试

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "mm_statics",
-    "version": "1.5.3",
+    "version": "1.5.4",
     "description": "这是超级美眉statics函数模块，用于web服务端statics缓存",
     "main": "index.js",
     "scripts": {
@@ -46,7 +46,7 @@
     "devDependencies": {
         "eslint": "^9.39.2",
         "eslint-plugin-jsdoc": "^61.5.0",
-        "mm_eslint": "^1.3.7",
+        "mm_eslint": "^1.3.8",
         "mocha": "^11.7.5",
         "supertest": "^7.1.4"
     }