mm_dict 1.0.1 → 1.0.2

package/example/index.js

@@ -0,0 +1,52 @@
+/**
+ * mm_dict 字典存储示例
+ * 演示 dictAdmin() 作用域工厂，以及 Dict 类的字符串键值
+ * 增删查与 JSON 文件持久化（save / load）。
+ * 运行：node example/index.js
+ */
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+const { Dict, dictAdmin } = require('../index.js');
+
+/** 示例临时目录 */
+const TMP_DIR = fs.mkdtempSync(path.join(os.tmpdir(), 'mm-dict-example-'));
+
+/**
+ * 主流程
+ */
+function main() {
+  // 方式1：作用域工厂，获取 os 作用域的字典存储实例
+  const store = dictAdmin('os');
+  store.set('country', 'CN');
+  console.log('工厂实例读取 country:', store.get('country'));
+
+  // 方式2：类实例 + 文件持久化
+  const file = path.join(TMP_DIR, 'dict.json');
+  const dict = new Dict(file);
+  dict.set('zh', '中文').set('en', 'English');
+  console.log('字典列表:', dict.list());
+  console.log('has(zh):', dict.has('zh'));
+  console.log('保存到文件:', dict.save());
+
+  // 从文件重新加载
+  const loaded = new Dict(file);
+  loaded.load();
+  console.log('加载后读取 en:', loaded.get('en'));
+
+  // 删除字典项
+  console.log('删除 en:', loaded.del('en'));
+  console.log('删除后列表:', loaded.list());
+
+  // 值必须是字符串
+  try {
+    dict.set('num', 123);
+  } catch (err) {
+    console.log('非字符串值被拒绝:', err.message);
+  }
+
+  // 清理临时目录
+  fs.rmSync(TMP_DIR, { recursive: true, force: true });
+}
+
+main();

package/lib/dict.js

@@ -1,4 +1,4 @@
-const KvStore = require('mm_corejs').KvStore;
+const KvStore = require('mm_kv_store').KvStore;
 
 /**
  * 字典存储类，值只能是字符串
@@ -17,6 +17,14 @@ class Dict extends KvStore {
       throw new TypeError('dict 的值必须是字符串');
     }
   }
+  
+  /**
+   * 是否允许覆盖已存在的配置项
+   * @returns {boolean} 不允许覆盖返回 false
+   */
+  _isOverwritable() {
+    return false;
+  }
 }
 
 module.exports = Dict;

package/package.json

@@ -1,8 +1,12 @@
 {
   "name": "mm_dict",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "description": "字典存储模块：键和值都只能是字符串，用于键值映射",
   "main": "index.js",
+  "repository": {
+    "type": "git",
+    "url": "git+https://gitee.com/qiuwenwu91/mm_dict.git"
+  },
   "keywords": [
     "mm_mod",
     "mm_infra",
@@ -19,7 +23,8 @@
     "test": "jest --coverage"
   },
   "dependencies": {
-    "mm_corejs": "^1.1.4"
+    "mm_corejs": "^1.1.4",
+    "mm_kv_store": "^1.0.0"
   },
   "devDependencies": {
     "jest": "^30.5.2"