wok-server 0.3.1 → 0.3.2

package/dist/mvc/index.js

@@ -1,12 +1,22 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.stopWebServer = exports.startWebServer = void 0;
+exports.stopWebServer = exports.startWebServer = exports.removeServerStaticCache = void 0;
 const tslib_1 = require("tslib");
 const server_1 = require("./server");
 /**
  * 服务实例.
  */
 let SERVER;
+/**
+ * 删除服务器静态缓存
+ * @param path 路径，必须以斜杠开头，如：/assets/index.js
+ */
+async function removeServerStaticCache(path) {
+    if (SERVER) {
+        SERVER.removeServerStaticCache(path);
+    }
+}
+exports.removeServerStaticCache = removeServerStaticCache;
 /**
  * 启动 web服务
  * @param opts

package/dist/mvc/server.js

@@ -241,6 +241,15 @@ class WokServer {
         }
         return res;
     }
+    /**
+     * 删除服务器端静态资源缓存
+     * @param path
+     */
+    removeServerStaticCache(path) {
+        if (this.staticHandler) {
+            this.staticHandler.removeServerCache(path);
+        }
+    }
     /**
      * 停止
      */

package/dist/mvc/static/static-handler.js

@@ -351,5 +351,15 @@ class StaticHandler {
         }
         return { filePath, stats: fileStat, maxAge: matchedRule.cacheAge };
     }
+    /**
+     * 删除服务器端静态资源缓存
+     * @param path
+     */
+    removeServerCache(path) {
+        if (this.cache) {
+            this.cache.remove(path);
+            this.cache.remove(`gzip-${path}`);
+        }
+    }
 }
 exports.StaticHandler = StaticHandler;

package/documentation/zh-cn/mvc.md

@@ -577,10 +577,15 @@ dir 参数是映射文件目录的地址，可以是绝对路径，也可以是
 | SERVER_STATIC_CACHE_ENABLE        | 是否启用服务器缓存，默认 false                                    |
 | SERVER_STATIC_CACHE_MAX_AGE       | 服务器缓存时间，单位秒，默认 600                                  |
 | SERVER_STATIC_CACHE_MAX_FILE_SIZE | 最大可缓存的文件大小，支持语义化格式，如 10m 和 100k 等，默认 10m |
-| SERVER_STATIC_CACHE_MAX_SIZE      | 缓存最大空间，一旦超出将执行清理，同上支持语义化格式，默认 100,   |
+| SERVER_STATIC_CACHE_MAX_SIZE      | 缓存最大空间，一旦超出将执行清理，同上支持语义化格式，默认 100m   |
 
-静态文件的服务器缓存不支持清除，只能等待过期，或者空间满被清理掉。所以，只适合缓存长期不需要改变的文件，
-目前还没有支持按规则来缓存，后续的版本有可能会考虑。
+0.3.2 版本新增加了 removeServerStaticCache 函数，可以主动删除指定的服务器端静态缓存。
+
+```ts
+import {removeServerStaticCache} from 'wok-server'
+
+removeServerStaticCache('/assets/index.js')
+```
 
 ### 请求日志
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wok-server",
-  "version": "0.3.1",
+  "version": "0.3.2",
   "packageManager": "pnpm@8.9.0",
   "description": "一个基于 NodeJs 和 TypeScript 的后端框架，轻量级、克制、简洁。A lightweight, restrained, and concise backend framework based on Node.js and TypeScript.",
   "scripts": {

package/types/mvc/index.d.ts

@@ -1,4 +1,9 @@
 import { WokServerOpts } from './server';
+/**
+ * 删除服务器静态缓存
+ * @param path 路径，必须以斜杠开头，如：/assets/index.js
+ */
+export declare function removeServerStaticCache(path: string): Promise<void>;
 /**
  * 启动 web服务
  * @param opts

package/types/mvc/server.d.ts

@@ -78,6 +78,11 @@ export declare class WokServer {
      * @returns
      */
     private getIpv4List;
+    /**
+     * 删除服务器端静态资源缓存
+     * @param path
+     */
+    removeServerStaticCache(path: string): void;
     /**
      * 停止
      */

package/types/mvc/static/static-handler.d.ts

@@ -69,4 +69,9 @@ export declare class StaticHandler {
      * @returns 返回被查询到的文件信息，如果找不到则返回 null
      */
     private findFile;
+    /**
+     * 删除服务器端静态资源缓存
+     * @param path
+     */
+    removeServerCache(path: string): void;
 }