mirror of
https://github.com/XiaoDaiGua-Ray/ray-template.git
synced 2026-11-22 03:23:35 +08:00
11 lines
8.3 KiB
JavaScript
11 lines
8.3 KiB
JavaScript
import{_ as i,o as a,c as e,a3 as t}from"./chunks/framework.BNdm2jZV.js";const c=JSON.parse('{"title":"缓存与兼容加密","description":"","frontmatter":{},"headers":[],"relativePath":"reference/utils/storage.md","filePath":"reference/utils/storage.md"}'),n={name:"reference/utils/storage.md"};function r(l,s,h,p,d,k){return a(),e("div",null,[...s[0]||(s[0]=[t(`<h1 id="缓存与兼容加密" tabindex="-1">缓存与兼容加密 <a class="header-anchor" href="#缓存与兼容加密" aria-label="Permalink to "缓存与兼容加密""></a></h1><h2 id="web-storage" tabindex="-1">Web Storage <a class="header-anchor" href="#web-storage" aria-label="Permalink to "Web Storage""></a></h2><p>默认使用 <code>sessionStorage</code>,传 <code>'localStorage'</code> 跨刷新保存。所有读写值按 JSON 序列化。类型参数仅影响 TypeScript,不能确认缓存格式。</p><table tabindex="0"><thead><tr><th>API</th><th>行为</th></tr></thead><tbody><tr><td><code>setStorage(key, value, storageType?, options?)</code></td><td>写入可序列化值,空键、循环引用或浏览器拒绝写入时记录错误。</td></tr><tr><td><code>getStorage<T>(key, storageType?, options?)</code></td><td>缺键、损坏或不可读时返回 <code>options.defaultValue</code> 或 <code>null</code>;显式 JSON <code>null</code> 仍返回 <code>null</code>。</td></tr><tr><td><code>hasStorage(key, storageType?, options?)</code></td><td>检查键存在,存储不可访问时返回 <code>false</code>,不验证 JSON 内容。</td></tr><tr><td><code>removeStorage(key, storageType?, options?)</code></td><td>删除单键。也可传 <code>__all__</code>、<code>__all_sessionStorage__</code> 或 <code>__all_localStorage__</code> 做批量删除。</td></tr><tr><td><code>prefixCacheKey(key, { customPrefix }?)</code></td><td>拼接自定义前缀或默认 <code>APP_CATCH_KEY_PREFIX</code>,分隔符需包含在前缀内。</td></tr></tbody></table><p>缓存方法只有在 <code>options.prefix: true</code> 时才调用前缀函数,<code>prefixKey</code> 覆盖默认值。启用非空前缀时,批量删除只影响匹配的键;空前缀会清整个对应存储区域。读写和删除使用同一套前缀选项。Pinia 插件使用自己的持久化配置,修改工具前缀不会迁移 Pinia 的历史数据。</p><div class="language-ts vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">ts</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">import</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> { getStorage, removeStorage, setStorage } </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">from</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> '@/utils'</span></span>
|
||
<span class="line"></span>
|
||
<span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">const</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> options</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> =</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> { prefix: </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">true</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">, prefixKey: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">'inventory:'</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> }</span></span>
|
||
<span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">export</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> function</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> saveOrderFilter</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#E36209;--shiki-dark:#FFAB70;">status</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">:</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> string</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">) {</span></span>
|
||
<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> setStorage</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">'order-filter'</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">, { status }, </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">'sessionStorage'</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">, options)</span></span>
|
||
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">}</span></span>
|
||
<span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">export</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> const</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> readOrderFilter</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> =</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> () </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">=></span></span>
|
||
<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> getStorage</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"><{ </span><span style="--shiki-light:#E36209;--shiki-dark:#FFAB70;">status</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">:</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> string</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> }>(</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">'order-filter'</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">, </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">'sessionStorage'</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">, options)</span></span>
|
||
<span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">export</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> const</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> clearOrderFilter</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> =</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> () </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">=></span></span>
|
||
<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> removeStorage</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">'order-filter'</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">, </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">'sessionStorage'</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">, options)</span></span></code></pre></div><h2 id="兼容-aes-json" tabindex="-1">兼容 AES JSON <a class="header-anchor" href="#兼容-aes-json" aria-label="Permalink to "兼容 AES JSON""></a></h2><p><code>encrypt(data, key?)</code> 返回 JSON 密文,<code>decrypt(ciphertext, key?)</code> 解码。可用字符串口令或 CryptoJS <code>WordArray</code>,同一数据须使用同类型和内容的 key。字符串沿用 OpenSSL 兼容格式,原始密钥使用随机 IV,字符串序列化为 <code>IV:密文</code>。错误密文或密钥会记录错误并返回 <code>undefined</code>,无法 JSON 序列化的输入会使加密抛错。</p><p><code>CRYPTO_KEY</code> 是应用公开的历史兼容常量。这个工具用于读取既有本地数据(如演示锁屏),不能保护服务端密钥或替代认证。迁移格式时先保留对历史密文的读取能力。</p><p><a href="https://github.com/XiaoDaiGua-Ray/ray-template/blob/403fdd589abbe37b38e1240d34f8daf2a60d3690/apps/admin/src/utils/cache.ts" target="_blank" rel="noreferrer">缓存实现</a> · <a href="https://github.com/XiaoDaiGua-Ray/ray-template/blob/403fdd589abbe37b38e1240d34f8daf2a60d3690/apps/admin/src/utils/legacy-crypto/encrypt.ts" target="_blank" rel="noreferrer">加密</a> · <a href="https://github.com/XiaoDaiGua-Ray/ray-template/blob/403fdd589abbe37b38e1240d34f8daf2a60d3690/apps/admin/src/utils/legacy-crypto/decrypt.ts" target="_blank" rel="noreferrer">解密</a></p>`,10)])])}const g=i(n,[["render",r]]);export{c as __pageData,g as default};
|