Method queryByName

packages/core/src/ECS/Core/QuerySystem.ts:504–535

* 按名称查询实体 * * 返回具有指定名称的所有实体。 * 名称查询使用专用索引，适用于查找特定的命名实体。 * * @param name 要查询的实体名称 * @returns 查询结果，包含匹配的实体和性能信息 * * @example * ```typescript * // 查找名为"Player"的实体 * const player = querySystem.queryByName("Player"); * ```

(name: string)

     * ```
     */
    public queryByName(name: string): QueryResult {
        const startTime = performance.now();
        this._queryStats.totalQueries++;

        const cacheKey = `name:${name}`;

        // 检查缓存
        const cached = this.getFromCache(cacheKey);
        if (cached) {
            this._queryStats.cacheHits++;
            return {
                entities: cached,
                count: cached.length,
                executionTime: performance.now() - startTime,
                fromCache: true
            };
        }

        // 使用索引查询
        this._queryStats.indexHits++;
        const entities = Array.from(this._entityIndex.byName.get(name) || []);

        // 缓存结果
        this.addToCache(cacheKey, entities);

        return {
            entities,
            count: entities.length,
            executionTime: performance.now() - startTime,
            fromCache: false
        };
    }

    /**
     * 查询自指定 epoch 以来发生变更的实体