/**
 * SQL語句解析引擎，負責SQL語句的解析和緩存管理
 * 核心作用是將原始SQL字符串解析為結構化的SQLStatement對象，同時提供緩存機制提升性能
 */
public final class SQLStatementParserEngine {
    
    /**
     * SQL語句解析執(zhí)行器，實際執(zhí)行SQL解析的組件
     * 封裝了不同數(shù)據庫類型的SQL解析邏輯
     */
    private final SQLStatementParserExecutor sqlStatementParserExecutor;
    
    /**
     * SQL語句緩存，使用LoadingCache實現(xiàn)（通常是Guava的緩存實現(xiàn)）
     * 鍵為SQL字符串，值為解析后的SQLStatement對象
     * 具備自動加載和過期淘汰能力
     */
    private final LoadingCache<String, SQLStatement> sqlStatementCache;

    /**
     * 構造方法，初始化解析引擎
     * 
     * @param databaseType 數(shù)據庫類型（如MySQL、PostgreSQL等）
     * @param sqlCommentParseEnabled 是否解析SQL中的注釋
     */
    public SQLStatementParserEngine(String databaseType, boolean sqlCommentParseEnabled) {
        // 初始化解析執(zhí)行器，傳入數(shù)據庫類型和注釋解析開關
        this.sqlStatementParserExecutor = new SQLStatementParserExecutor(databaseType, sqlCommentParseEnabled);
        
        // 構建SQL語句緩存
        // CacheOption參數(shù)說明：
        // 2000：緩存最大條目數(shù)（maximumSize）
        // 65535L：緩存過期時間（expireAfterWrite，單位根據實現(xiàn)可能為秒或毫秒）
        // 4：可能是并發(fā)級別（concurrencyLevel），允許同時寫入緩存的線程數(shù)
        this.sqlStatementCache = SQLStatementCacheBuilder.build(
            new CacheOption(2000, 65535L, 4), 
            databaseType, 
            sqlCommentParseEnabled
        );
    }

    /**
     * 解析SQL語句的核心方法
     * 
     * @param sql 原始SQL字符串
     * @param useCache 是否使用緩存：true-優(yōu)先從緩存獲取，未命中則解析并緩存；false-直接解析不使用緩存
     * @return 解析后的SQLStatement對象（包含SQL結構化信息，如表名、條件、排序等）
     */
    public SQLStatement parse(String sql, boolean useCache) {
        // 根據useCache參數(shù)決定是否使用緩存
        return useCache 
            ? (SQLStatement)this.sqlStatementCache.getUnchecked(sql)  // 使用緩存：從緩存獲取，無則自動加載
            : this.sqlStatementParserExecutor.parse(sql);  // 不使用緩存：直接調用執(zhí)行器解析
    }
}