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 + ページサイズです。
initWithIdentifier:cachedDelegate:types: — cachedDelegateがMADCacheProtocolを通じてキャッシュディレクトリを供給し、typesはNSKeyedUnarchiverがデコードしてよいクラスの集合です。
次に: initializeDatabase(開き、テーブルがなければ作成)、addObject:(追記)、objectAtIndex: / objectAtIndexedSubscript:(読み取り)、beginBulkInserts / endBulkInserts(多数の追記を囲むトランザクション)、removeAllObjects、finalizeDatabase、およびcount / state / identifierアクセサ。
prepareStatement*)、呼び出しごとに再バインドされます——再パースはありません。ciが主キーなので、objectAtIndex:はSELECT ck WHERE ci = ?——O(1)のインデックスプローブで、スキャンではありません。beginBulkInserts / endBulkInsertsが追記を囲むため、フルレンダリングはページごとのfsyncではなく1回のコミットです。objectAtIndex:はアンアーカイブするすべての要素を(インデックスをキーに)キャッシュするため、繰り返し読み取り——レンダラーの通常のパターン——はSQLiteラウンドトリップもアンアーカイブもないNSDictionaryルックアップです。lastObjectSelectedはnextObjectのために残ります。archivingQueue、unarchiveQueue)が単一のSQLite接続を1つのライターと1つのリーダーに保ちます。支配的なコストはSQLiteではなくNSKeyedArchiver / NSKeyedUnarchiverのシリアライズです。レンダーキャッシュはMADSectionRepresentationグラフのマーシャリングに時間を使い、それはフォーマッタがとにかく行うのと同じ作業です。
項目1〜4は2026-10-01に修正されました。項目5〜6は未解決のままで、修正ではなく記録されています(列挙子は死んだコードで、並行性の落とし穴はフォーマッタがシングルスレッドである間は潜在しています)。
-isEmptyが反転している。 MADArrayCaching.m:440はreturn _numberOfRows > 0;です——キャッシュが行を持つときにYESを返します。死んだコード(呼び出し元なし)なので、生きた不具合ではなく潜在的な罠です。修正済み、読み取り専用プロパティとして公開。-countが空のキャッシュで1を返す。 MADArrayCaching.m:424-438はカウントをmax(ci) + 1として計算しますが、テーブルが空のときSELECT … ORDER BY ci DESC LIMIT 1はSQLITE_DONEを返し、doneステートメントに対するsqlite3_column_int64はゴミを読みます。結果は0ではなく1になります。修正済み。-readDataAtIndex:と-writeData:が死んでいる。 ヘッダーになく、呼び出し元もありません。addObject:に取って代わられた生NSDataパスの残りです。readDataAtIndex:は型も混ぜます。lastObjectSelectedヒット時にNSDataではなくアンアーカイブされたオブジェクトを返します。削除済み。MTArrayCachedTableName / …ColumnKey / …ColumnValue / …ExtensionはMADArrayCaching.mでstatic宣言され、MADArrayCachingEnumerator.mでグローバルに再宣言されています。1つのヘッダーがそれらを所有すべきです。修正済み——extern宣言は今MADArrayCaching.hにあり、定義はMADArrayCaching.mにあります。MADArrayCachingEnumeratorが古いアンアーカイバを使っている。 MADArrayCachingがunarchivedObjectOfClasses:を使う場所で、非推奨のunarchiveObjectWithData:(非セキュア)を呼びます。またそのnextObjectは各ステップ後にステートメントをリセットするため、手動反復は決して進みません(countByEnumeratingWithState:経由の高速列挙は影響を受けません)。未解決——クラスに呼び出し元がありません。_numberOfRowsがキューの外で読まれる。 addObject:はdispatch_*の前に_numberOfRowsを読むため、並行追記はインデックスで衝突します。フォーマッタは今日シングルスレッドでそれらを呼ぶので潜在的です。未解決。価値の順:
-isEmptyと-countを修正し(2つの1行修正)、死んだreadDataAtIndex: / writeData:の対を削除する。振る舞い安全: 最初の2つは不具合修正で、2つ目は型不具合のある死んだコード。MTArrayCached*定数を、両ファイルがインポートする単一のヘッダーに移す。MADArrayCachingEnumeratorをMADArrayCachingと同じアンアーカイバに引き上げ、壊れたnextObjectを修正または削除する。NSKeyedArchiverをより軽いキャッシュ専用シリアライザに置き換え、かつ/またはキューがすでに所有されているときは読み取りごとのdispatch_syncを直接呼び出しに落とす。これらは「本当に速くする」レバーで、上の正確性項目が先です。このページは英語原文の日本語翻訳です。内容に相違がある場合は、英語原文が優先されます。