MAD Designer iconMAD

MADArrayCaching

このページでは、レポートのレンダーキャッシュとして使われるディスクベースの追記専用配列MADArrayCachingについて説明します。

元の日付に書かれ、現状の事実は2026-11-22に整合。

ディスクベースの追記専用順序付き配列で、レポートのレンダーキャッシュとして使われます。2026-10-01、masterの7ebe82f89に対して書かれました。


それが何か

MADArrayCaching<ObjectType>(MADSqlite3内)はNSEnumeratorサブクラスで、要素がメモリではなくディスクに存在するNSMutableArrayのように振る舞います。各要素はNSKeyedArchiverでシリアライズされ、SQLiteファイルのBLOBとして保存されます。MAD_FORMAT.md §5の.madacコンパニオンファイルの背後にあるクラスです。

ドキュメントごとに2つのインスタンスがあり、どちらもMADReportFormatterが所有します。

識別子サフィックス 保持するもの 要素型
…ih{w,h} ページインデックス(どの行が各ページに着地するか) NSArray<NSNumber *>
…lh{w,h} ページレイアウト(ページごとのセクション表現) NSArray<MADSectionRepresentation *>

MADReportFormatterはbeginBulkInserts / addObject: / endBulkInsertsでそれらを埋め、objectAtIndex: / objectAtIndexedSubscript:で読み戻します。これがレンダーキャッシュです——Musicキャッシュの約15 MBの.madacファイル——そして再レンダリングがページレイアウトの再計算をスキップできるようにするものです。

オンディスクフォーマット

<identifier>.madacは1つのテーブルを持つ通常のSQLiteファイルです。

列 型 意味
ci INTEGER、主キー 要素のインデックス(0、1、2、……)
ck BLOB NSKeyedArchiverでシリアライズされた要素

ファイルはドキュメントのキャッシュディレクトリにあり、[self.identifier stringByAppendingPathExtension:@"madac"](MADArrayCaching.m:269-274)で名付けられます。ここでidentifierはフォーマッタのlayoutIdentifier + ih/lh + ページサイズです。

API

initWithIdentifier:cachedDelegate:types: — cachedDelegateがMADCacheProtocolを通じてキャッシュディレクトリを供給し、typesはNSKeyedUnarchiverがデコードしてよいクラスの集合です。

次に: initializeDatabase(開き、テーブルがなければ作成)、addObject:(追記)、objectAtIndex: / objectAtIndexedSubscript:(読み取り)、beginBulkInserts / endBulkInserts(多数の追記を囲むトランザクション)、removeAllObjects、finalizeDatabase、およびcount / state / identifierアクセサ。

なぜ速いのか(設計は正しい)

支配的なコストはSQLiteではなくNSKeyedArchiver / NSKeyedUnarchiverのシリアライズです。レンダーキャッシュはMADSectionRepresentationグラフのマーシャリングに時間を使い、それはフォーマッタがとにかく行うのと同じ作業です。

見つかった問題

項目1〜4は2026-10-01に修正されました。項目5〜6は未解決のままで、修正ではなく記録されています(列挙子は死んだコードで、並行性の落とし穴はフォーマッタがシングルスレッドである間は潜在しています)。

  1. -isEmptyが反転している。 MADArrayCaching.m:440はreturn _numberOfRows > 0;です——キャッシュが行を持つときにYESを返します。死んだコード(呼び出し元なし)なので、生きた不具合ではなく潜在的な罠です。修正済み、読み取り専用プロパティとして公開。
  2. -countが空のキャッシュで1を返す。 MADArrayCaching.m:424-438はカウントをmax(ci) + 1として計算しますが、テーブルが空のときSELECT … ORDER BY ci DESC LIMIT 1はSQLITE_DONEを返し、doneステートメントに対するsqlite3_column_int64はゴミを読みます。結果は0ではなく1になります。修正済み。
  3. -readDataAtIndex:と-writeData:が死んでいる。 ヘッダーになく、呼び出し元もありません。addObject:に取って代わられた生NSDataパスの残りです。readDataAtIndex:は型も混ぜます。lastObjectSelectedヒット時にNSDataではなくアンアーカイブされたオブジェクトを返します。削除済み。
  4. テーブル/列定数が重複している。 MTArrayCachedTableName / …ColumnKey / …ColumnValue / …ExtensionはMADArrayCaching.mでstatic宣言され、MADArrayCachingEnumerator.mでグローバルに再宣言されています。1つのヘッダーがそれらを所有すべきです。修正済み——extern宣言は今MADArrayCaching.hにあり、定義はMADArrayCaching.mにあります。
  5. MADArrayCachingEnumeratorが古いアンアーカイバを使っている。 MADArrayCachingがunarchivedObjectOfClasses:を使う場所で、非推奨のunarchiveObjectWithData:(非セキュア)を呼びます。またそのnextObjectは各ステップ後にステートメントをリセットするため、手動反復は決して進みません(countByEnumeratingWithState:経由の高速列挙は影響を受けません)。未解決——クラスに呼び出し元がありません。
  6. _numberOfRowsがキューの外で読まれる。 addObject:はdispatch_*の前に_numberOfRowsを読むため、並行追記はインデックスで衝突します。フォーマッタは今日シングルスレッドでそれらを呼ぶので潜在的です。未解決。

提案される改善

価値の順:

  1. -isEmptyと-countを修正し(2つの1行修正)、死んだreadDataAtIndex: / writeData:の対を削除する。振る舞い安全: 最初の2つは不具合修正で、2つ目は型不具合のある死んだコード。
  2. MTArrayCached*定数を、両ファイルがインポートする単一のヘッダーに移す。
  3. MADArrayCachingEnumeratorをMADArrayCachingと同じアンアーカイバに引き上げ、壊れたnextObjectを修正または削除する。
  4. プロファイリングが示した場合にのみ: NSKeyedArchiverをより軽いキャッシュ専用シリアライザに置き換え、かつ/またはキューがすでに所有されているときは読み取りごとのdispatch_syncを直接呼び出しに落とす。これらは「本当に速くする」レバーで、上の正確性項目が先です。

このページは英語原文の日本語翻訳です。内容に相違がある場合は、英語原文が優先されます。