feat(metadata): share table metadata cache
This commit is contained in:
1 parent
81f787e8d1
commit
3da3849953
5 files changed
+269
-39
No files matched your search
+119
@@ -0,0 +1,119 @@
|
||||
import { beforeEach, describe, expect, it, vi } from "vitest";
|
||||
import type { ColumnInfo } from "@/types/database";
|
||||
|
||||
const mocks = vi.hoisted(() => ({
|
||||
getColumns: vi.fn(),
|
||||
listIndexes: vi.fn(),
|
||||
}));
|
||||
|
||||
vi.mock("@/lib/backend/api", () => ({
|
||||
getColumns: mocks.getColumns,
|
||||
listIndexes: mocks.listIndexes,
|
||||
}));
|
||||
|
||||
import { clearTableMetadataCache, getCachedTableMetadata, invalidateTableMetadataCache, loadTableMetadata } from "@/lib/metadata/tableMetadataCache";
|
||||
|
||||
function column(name: string): ColumnInfo {
|
||||
return { name, data_type: "integer", is_nullable: false, column_default: null, is_primary_key: true, extra: null };
|
||||
}
|
||||
|
||||
const request = { connectionId: "c1", database: "db", schema: "public", tableName: "users", databaseType: "postgres" } as const;
|
||||
|
||||
describe("tableMetadataCache invalidation", () => {
|
||||
beforeEach(() => {
|
||||
clearTableMetadataCache();
|
||||
vi.clearAllMocks();
|
||||
mocks.listIndexes.mockResolvedValue([]);
|
||||
});
|
||||
|
||||
it("a stale in-flight load cannot overwrite the cache after invalidation", async () => {
|
||||
// 旧加载(结构变更前启动)被挂起
|
||||
let releaseOldColumns: (columns: ColumnInfo[]) => void = () => {};
|
||||
mocks.getColumns.mockReturnValueOnce(
|
||||
new Promise<ColumnInfo[]>((resolve) => {
|
||||
releaseOldColumns = resolve;
|
||||
}),
|
||||
);
|
||||
const oldLoad = loadTableMetadata({ ...request });
|
||||
|
||||
// 结构保存:作废缓存并 force 拉新
|
||||
invalidateTableMetadataCache({ connectionId: "c1", database: "db", tableName: "users" });
|
||||
mocks.getColumns.mockResolvedValueOnce([column("id_new")]);
|
||||
const fresh = await loadTableMetadata({ ...request, force: true });
|
||||
expect(fresh.metadata.columns[0]?.name).toBe("id_new");
|
||||
|
||||
// 旧加载最后返回:不得回填覆盖新值
|
||||
releaseOldColumns([column("id_old")]);
|
||||
const oldResult = await oldLoad;
|
||||
expect(oldResult.metadata.columns[0]?.name).toBe("id_old");
|
||||
expect(getCachedTableMetadata(request)?.metadata.columns[0]?.name).toBe("id_new");
|
||||
});
|
||||
|
||||
it("a follower starting after invalidation does not join the stale in-flight load", async () => {
|
||||
// 旧加载(失效前启动、non-force、已登记在途)被挂起
|
||||
let releaseOldColumns: (columns: ColumnInfo[]) => void = () => {};
|
||||
mocks.getColumns.mockReturnValueOnce(
|
||||
new Promise<ColumnInfo[]>((resolve) => {
|
||||
releaseOldColumns = resolve;
|
||||
}),
|
||||
);
|
||||
const oldLoad = loadTableMetadata({ ...request });
|
||||
|
||||
invalidateTableMetadataCache({ connectionId: "c1", database: "db", tableName: "users" });
|
||||
|
||||
// 失效后的 non-force 跟随者:不得加入旧在途(否则其失效代数取自失效后,
|
||||
// 完成时会把旧结果写回缓存),必须自起新加载
|
||||
mocks.getColumns.mockResolvedValueOnce([column("id_new")]);
|
||||
const follower = await loadTableMetadata({ ...request });
|
||||
expect(follower.metadata.columns[0]?.name).toBe("id_new");
|
||||
expect(mocks.getColumns).toHaveBeenCalledTimes(2);
|
||||
|
||||
releaseOldColumns([column("id_old")]);
|
||||
await oldLoad;
|
||||
expect(getCachedTableMetadata(request)?.metadata.columns[0]?.name).toBe("id_new");
|
||||
});
|
||||
|
||||
it("invalidating one table does not disturb another table's in-flight load", async () => {
|
||||
const requestB = { ...request, tableName: "orders" } as const;
|
||||
// A、B 同时挂起
|
||||
const releases = new Map<string, (columns: ColumnInfo[]) => void>();
|
||||
mocks.getColumns.mockImplementation(
|
||||
(_connectionId: string, _database: string, _schema: string, tableName: string) =>
|
||||
new Promise<ColumnInfo[]>((resolve) => {
|
||||
releases.set(tableName, resolve);
|
||||
}),
|
||||
);
|
||||
const loadA = loadTableMetadata({ ...request });
|
||||
const loadB = loadTableMetadata({ ...requestB });
|
||||
await Promise.resolve();
|
||||
|
||||
// 仅失效 A
|
||||
invalidateTableMetadataCache({ connectionId: "c1", database: "db", tableName: "users" });
|
||||
|
||||
// B 的 follower 必须复用原在途请求:总请求数保持 2(A 一次 + B 一次)。
|
||||
// 先让出 microtask,coordinator 的 load 才会真正启动,断言才有观察力
|
||||
const followerB = loadTableMetadata({ ...requestB });
|
||||
await Promise.resolve();
|
||||
expect(mocks.getColumns).toHaveBeenCalledTimes(2);
|
||||
|
||||
// B 返回后正常写入缓存
|
||||
releases.get("orders")?.([column("order_id")]);
|
||||
expect((await loadB).metadata.columns[0]?.name).toBe("order_id");
|
||||
expect((await followerB).metadata.columns[0]?.name).toBe("order_id");
|
||||
expect(getCachedTableMetadata(requestB)?.metadata.columns[0]?.name).toBe("order_id");
|
||||
|
||||
// A 跨越失效边界:完成后不得写缓存
|
||||
releases.get("users")?.([column("id_old")]);
|
||||
await loadA;
|
||||
expect(getCachedTableMetadata(request)).toBeUndefined();
|
||||
});
|
||||
|
||||
it("caches normally when no invalidation crosses the load", async () => {
|
||||
mocks.getColumns.mockResolvedValueOnce([column("id")]);
|
||||
await loadTableMetadata({ ...request });
|
||||
expect(getCachedTableMetadata(request)?.metadata.columns[0]?.name).toBe("id");
|
||||
// 命中缓存:不再发起请求
|
||||
await loadTableMetadata({ ...request });
|
||||
expect(mocks.getColumns).toHaveBeenCalledTimes(1);
|
||||
});
|
||||
});
|
||||
Reference in new issue
Block a user