Method queryByComponent

packages/core/src/ECS/Core/QuerySystem.ts:622–652

* 按单个组件类型查询实体 * * 返回包含指定组件类型的所有实体。 * 这是最基础的查询方法，具有最高的查询性能。 * * @param componentType 要查询的组件类型 * @returns 查询结果，包含匹配的实体和性能信息 * * @example * ```typescript * // 查询所有具有位置组件的实体 * const entitiesWithPosition = querySystem.queryByComponent(PositionCompone

(componentType: ComponentType<T>)

     * ```
     */
    public queryByComponent<T extends Component>(componentType: ComponentType<T>): QueryResult {
        const startTime = performance.now();
        this._queryStats.totalQueries++;

        const cacheKey = this.generateCacheKey('component', [componentType]);

        // 检查缓存
        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 = this._archetypeSystem.getEntitiesByComponent(componentType);

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

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

    /**
     * 从缓存获取查询结果