このページはMADDataTableと、MADFoundation、MAD、MADSqlite3、MADMySQL、MADTdsClientにまたがるすべての実装のアーキテクチャレポートです。クラスクラスタと分離作業を記録します。
元の日付に書かれ、現状の事実は2026-11-22に整合。
スコープ: MADDataTableと、MADFoundation、MAD、MADSqlite3、MADMySQL、MADTdsClientにまたがるすべての実装、サブクラス、プロトコル、呼び出しサイト。
ブランチ: refactor/mad-database-decouple
日付: 2026-10-01
検証: xcodebuild test — 11スキームすべて、809テスト、0失敗。スコープ内のどのファイルからも警告なし(MADDatabaseMySQL.mの2つの-Warc-repeated-use-of-weak警告は既存で未変更)。(Revision 2で798、Revision 3で804、Revision 4で807。)
以下のすべてのfile:line参照はこの分析中に直接読まれたもので、推測ではありません。
Revision 5 — 2026-10-01。 Phase 3と5は閉じられ、Phase 1ステップ7は証明されました。
-dropTable、-dropTableName:、-deleteAll、-vacuumCacheDbは今、rowCounterを ファイルを記述する状態で残します(§2.5)。それがステップ10/11のすべてでした。危険にさらされた 3つの定数は4つの新しいテストでカバーされています。裸の<MADDataTableWriting>準拠者で sqlite行ループを駆動すること——背後にMADDataTableなし、.maddbなし——がステップ7で、 今テストです(MADWritePortRecorder)。ステップ14は完了:MADDataTableLocationは削除されました。 ステップ13と15は下のエントリで理由付きで評価され、実行はされていません。それらのテストを書くことで2つの生きた不具合が落ちてきて、どちらも今修正されています。
-deleteAllは 文字列を-[MADQueryCacheDeleteAllFromTable initWithObject:]に渡し、それは引数をパラメータ辞書として 添字アクセスし、最初の行でraiseしました——メソッドに呼び出し元がないため、誰もそれに当たったことが ありませんでした。今は-initWithTableName:を使います。そしてMTTableControllerは失敗パスでdatatable.countをページカーソルとして読み、テーブルはまだ前のページを保持していたため、失敗した フェッチがhasMore = YESを報告し永遠にリトライしました。カウンタのコメントが
MADDataTableFast.mを-deleteAll以降で13行シフトさせたため、それ以降のすべてのfile:line参照は調整ではなく再導出されました。MTTableController.mも動き、その参照もそれとともに 再導出されました。Revision 4 — 2026-10-01。 Revision 3のMySQL障害はなくなりました。
MADMySQLFetch+DataTable.mが フェッチ中に読む列メタデータは今<MADDataTableWriting>自身が宣言するため、3つのドライバすべて——MADDatabaseMySQL、MADDatabase.m、MADDatabaseDataSourceプロトコルを含む——がid <MADDataTableWriting>を取り、フェッチの出力パラメータは値渡しです(すべての呼び出しサイトで&が 落とされました)。Phase 2(「urlFastCacheを保存し、キャッシュディレクトリを注入する」)とPhase 4 ステップ12(書き込みパイプラインを直列化する)は完了し、Phase 3は再水和パスのみ完了です。§2.1と §2.3〜§2.5と§4.2がそれぞれをマークします。3つのテストが追加され、スイートは804 → 807になりました。 修正がMADDataTableFast.mを87行シフトさせたため、このレポートのそれへのすべてのfile:line参照は 調整ではなく再導出され、付録の行数もそれとともに更新されました。Revision — 2026-09-30。 最初のリビジョンが3点で間違っていると判明した後、§2.5、§3.3、§3.5、 §4.2が書き換えられました。
-dataForRow:error:の診断(2行のメソッドシグネチャが誤読された——メソッドはMADDataTableFastに実装されています)、-allObjectsの「生きた不具合」(本番呼び出し元なし)、rowCounterドリフトの枠組み(到達不能)。§4.5は新規です。修正されたテキストはCorrected / Fixedとマークされ、元の主張は示唆的だった場所に可視のまま残されています。このリビジョンで3つの コード修正が着地しました——§3.5参照。Revision 3 — 2026-10-01。 Phase 1ステップ5が着地しました。
<MADDataTableWriting>、<MADDataTableReading>、<MADDataTableCursoring>がMADDataTable.hで宣言され、クラスは3つすべてを 採用します。ステップ6は3つのドライバのうち2つで着地しました——MADDatabaseSQLServerとMADDatabaseSqlite3は今write-port型です。ステップ6はMADDatabaseMySQLでは着地できませんでした。 ステップ5の「今や冗長なスタブブロックを削除する」は却下されました。§4.2がそれぞれの理由を記録します。 パス全体は追加的です。振る舞いは変わらず、11スキームすべてが通ります(804テスト)。Revision 2 — 2026-09-30。 §4.5の8つの
sqlite3_mprintfフォーマット文字列サイトは今修正され、 Phase 0が着地しました。MADDataTable.mの未実装オペレーションは静かに失敗するのではなくアサートします (§3.2、§4.2)。§3.1の表と付録の行数は変更されたファイルに対して再導出されました。前のリビジョンの 2つの誤りも修正されました。ワークスペースのテスト総数は799と述べられていましたが798で、§3.6は_databaseサイトを4つ引用していましたが15あります。
MADDataTableは単一のクラスではありません。ストレージ軸に沿って3つのフレームワークに分割された小さなクラスクラスタに、別々の列挙子オブジェクトとして実装されたカーソル軸を加えたものです。
MADFoundation
└── MADDataTable NSObject <NSCoding, NSFastEnumeration>
│ "abstract": declares the full surface,
│ implements metadata + plist persistence
│
├── MADDataTableVirtual MADFoundation/Source/MADDataTableVirtual.m (240 ln)
│ In-memory. Rows live in per-column MADDataColumn arrays plus a
│ `sortIndex` NSMutableArray of row NSDictionaries.
│
└── MADDataTableFast MADSqlite3/Source/MADDataTableFast.m (1368 ln)
sqlite3-backed. Rows live in a `.maddb` file; the object holds two
MADDatabaseSqlite3 handles (one for writes, one for reads).
MADSqlite3 (private — NOT exported from the framework)
├── MADDataTableObjectEnumerator 173 ln — wraps a live sqlite3_stmt, yields row dicts
└── MADDataTableSingleColumnEnumerator 149 ln — same, yields a single column (row-ids)
MAD
└── MADDataTable+Constructor the ONLY place that maps type -> concrete class
(`MADDataTableLocation`, the other class here at
Revision 4, was deleted — see §3.7)
検証されたエクスポート表面(ビルドされた.framework/Headersから):
| フレームワーク | 公開エクスポートされるデータテーブルヘッダー |
|---|---|
MADFoundation |
MADDataTable.h、MADDataTableType.h、MADDataTableVirtual.h |
MADSqlite3 |
MADDataTableFast.hのみ |
MADMySQL |
なし |
MADTdsClient |
なし |
この分割は意図的で健全です。列挙子クラス名は決して漏れません。消費者はNSEnumerator *だけを見て、それがMADDataTable.hの返すものです。
MADDataTableType(MADFoundation/Source/MADDataTableType.h)はストレージ軸のみをエンコードします。
typedef NS_ENUM(short, MADDataTableType) {
MADDataTableTypeVirtual, // -> MADDataTableVirtual
MADDataTableTypePhysical, // -> MADDataTableFast
};
アクセス軸——行ごとかカーソルか——は直交し、型ではなく列挙子を返すことで表現されます。MADDataTableTypeCursorはありません。これはリファクタにとって重要です。カーソルシームはすでに存在し、正しく隠されています。
MAD/Source/MADDataTable+Constructor.m:51-69はコードベースで具体的なサブクラスを名指しする唯一の場所です。
+ (instancetype)newDataTableOfType:(MADDataTableType)type withObjectID:(NSUInteger)objectID {
switch (type) {
case MADDataTableTypeVirtual: result = [[MADDataTableVirtual alloc] initWithId:objectID]; break;
case MADDataTableTypePhysical: result = [[MADDataTableFast alloc] initWithId:objectID]; break;
default: NSAssert(NO, @"Not implemented."); break;
}
return result;
}
コードベースのどこにもデータテーブルに対するisKindOfClass:、NSClassFromString、クラス名文字列比較、respondsToSelector:プローブはないことを確認しました。これがリファクタにとって最も価値ある性質です——クラスタはこの1つのメソッドの背後で再形成できます。
同じファイルの2つの注意点:
+newDataTableWithDefinition:はオブジェクトIDがないときNSAssert(NO, @"Not implemented.")を呼びnilを返します(:44-46)。:31-32のコメントの「デフォルトでvirtual」という意図は到達不能です——objectIdSetが唯一の戻りパスをゲートします。+newDataTableForIdentifier:(:79-92)は事実上の公開エントリポイントです。ほとんどの呼び出しサイト(MTTableController.m:90、MADQuerySampleDataTable.m:68、MADQuerySampleDataTableRange.m:69)は代わりにnewDataTableWithDefinition:を直接通り、常に型をVirtualに固定します。すべてのデータベースドライバは基底クラスAPIを通じてテーブルを充填し、サブクラス固有のAPIは決して使いません。MADDatabaseSqlite3.m:474-540が正規のループです。
[dataTable removeAllObjects];
// first row only:
[dataTable addColumn:dataColumn]; // per column, discovered from sqlite metadata
[dataTable beginBulkInsert];
// per row:
[dataTable addRowWithDataForFieldKeys:resultsForRow];
[dataTable endBulkInsert];
MADDatabaseSQLServer.m:500 / :1367 / :1472は同一の5呼び出し形状を使います。MADMySQLFetch+DataTable.m:211 / :438 / :442も同様です。
これは狭く、よく定義された書き込みポートです。5つのメソッド。ファミリで最も強い既存境界であり、リファクタはそのまま保存すべきです。
ドライバ間の差異:
| ドライバ | 構築するテーブル | 書き込みパス |
|---|---|---|
MADDatabaseSqlite3 |
渡されたもの(通常MADDataTableFast) |
executeSQL:...intoResultTable: |
MADDatabaseMySQL |
自身でMADDataTableVirtualを構築(MADDatabaseMySQL.m:83, 110, 137, 175, 196, 376) |
MADMySQLFetch+DataTable.m |
MADDatabaseSQLServer |
決して構築しない——呼び出し元供給のテーブルへの純粋な書き込み専用 | MADDatabaseSQLServer.m |
したがってMySQLはMADDataTableFastを生成できず、SQL Serverはどのテーブルも生成できません。「物理」(sqliteベース)ストレージはリモート結果ではなくローカルキャッシュにのみ存在します。
3つの異なる読み取りスタイルが本番で使われています。
ランダムアクセス — -objectAtRow: / -objectAtRow:column:。
MADMySQLはO(n)ループ内でobjectAtRow:i column:0を使い(MADDatabaseMySQL.m:88-92, 118-122, 150-154, 187-189)、SHOW TABLES結果を読みます。MADQuerySampleDataTable.m:126 / MADQuerySampleDataTableRange.m:131は幅行を読むためにobjectAtRow:0を一度呼びます。MTTableController.m:281, 284, 393はページングにobjectAtRow:を使います。
列挙 — -enumeratorForKeyObjectsSorted。
MADocument.m:865-867がこれをenumeratorForReportDataとして返し、MADReportFormatter.m:449-502が消費します。
カウント — -rowCounter / -count / -numberOfRows。
MADocument.m:197(numberOfResults)、MTTableController.m:249(テーブルサイズ)、:377, :399, :449, :455(ページカーソル演算)。
MADReportFormatterは最も寛容な消費者で、リファクタを最も制約しません。MADReportFormatter.m:463-472に注意:
if (!calculatedRowId) {
if ([resultRow isKindOfClass:[NSDictionary class]]) { rowIdOnly = NO; }
calculatedRowId = YES;
}
self.machineState.detailRowId = rowIdOnly
? ((NSNumber *)resultRow).unsignedIntegerValue
: ((NSNumber *)resultRow[MADIdentifierROWID]).unsignedIntegerValue;
フォーマッタはすでに裸の行ID NSNumberを返す列挙子と完全な行辞書の両方を許容します。enumeratorForAllObjectsSortedRowIdOnlyはまさにそのケースのために存在します。これは既製のシームです。行IDだけをストリームするカーソルはすでに受け入れられる入力です。
すべてのファイルはARCです(#if !__has_feature(objc_arc) #warning ...ガード)。状態はクラス拡張に存在します。MADDataTableFastは正確に1つの非オブジェクトivarを持ちます。
@implementation MADDataTableFast {
sqlite3_stmt *_statementInsert; // MADDataTableFast.m:103
}
それは-dealloc(:163-165)と-endBulkInsert(:1334-1339)でファイナライズされます。パターンは正しいですが壊れやすかったです。-endBulkInsertはバリアを取る前にステートメントをnullにしていたため、ティアダウンが挿入が実行中でない唯一の窓の外にありました。
修正(Revision 4)。 ティアダウンは今バリアの内側、:1337-1338で実行されます。
-reopenDbConnection(:385-401)は同じ.maddbファイルを指す2つの独立したMADDatabaseSqlite3インスタンスを構築します。
// write handle
MADDatabaseConnection *connection = [[MADDatabaseConnectionSqlite3 alloc] initWithUrl:urlFastCache];
MADDatabaseSqlite3 *database = [[MADDatabaseSqlite3 alloc] init];
database.delegate = (id <MADDatabaseResultsProtocol>)cacheDelegate;
database.databaseConnection = connection;
[(MADDatabaseSqlite3 *)database openDatabaseWithFlags:
SQLITE_OPEN_READWRITE | SQLITE_OPEN_CREATE | SQLITE_OPEN_FULLMUTEX];
self.databaseForInserts = database;
// read handle — same URL, separate connection, default flags
MADDatabaseConnection *connectionSelect = [[MADDatabaseConnectionSqlite3 alloc] initWithUrl:urlFastCache];
MADDatabaseSqlite3 *databaseSelect = [[MADDatabaseSqlite3 alloc] init];
[databaseSelect setDatabaseConnection:connectionSelect];
[databaseSelect openDatabase];
databaseSelect.delegate = (id <MADDatabaseResultsProtocol>)cacheDelegate;
self.databaseForSelects = databaseSelect;
読み取りハンドルは-openDatabase(デフォルトフラグ)で開かれ、書き込みハンドルはSQLITE_OPEN_FULLMUTEXで開かれます。SQLITE_OPEN_FULLMUTEXは接続ごとの直列化モードで、同じファイル上の2つの接続間を仲裁しません。§2.4と組み合わせると、これがファミリで最大の正確性の前提です。
-urlFastCacheは計算されたプロパティで(このリビジョン前は:299-311)、保存されていませんでした。
- (NSURL *)urlFastCache {
NSString *filename = [[self filenameCacheMadDB] copy];
NSURL *cacheDirectory;
if (self.cacheDelegate == nil) {
id <UIApplicationDelegate, MADApplicationProtocol> appDelegate = [MADApplication AppDelegate];
id groupIdentifier = [appDelegate groupIdentifier].copy;
cacheDirectory = [MADURLFactory newURLForLocalCacheDirectoryForGroupIdentifier:groupIdentifier];
} else {
cacheDirectory = [self.cacheDelegate cachedFilesDirectory].copy;
}
return [cacheDirectory URLByAppendingPathComponent:filename isDirectory:NO];
}
帰結:
cacheDelegateのないテーブルは、そのオンディスクアイデンティティをグローバルなアプリデリゲートに静かに依存します。それが、MADDataTableFastがデリゲートなしのホストレスロジックテストでインスタンス化できなかった理由で、回帰スイートはMADCacheProtocol + MADDatabaseResultsProtocolに準拠するスタブで回避しています。-setCacheDelegate:(:377-383)は-reopenDbConnectionを呼びます。デリゲートの差し替えはtag/rowCounter/columnKeysをメモリに保ったままテーブルを別のファイルに再ポイントします。何も不一致を検出しません。-copyPlistはurlFastCache != nilをアサートします(:243)——そのためアーカイブされたテーブルの永続化URLはアーカイブ時の周囲状態に依存します。修正(Revision 4)。 -urlFastCacheは今一度解決して答えを保持します(_urlFastCache、:347-355、ゲッターと-setCacheDelegate:(:377-383、再オープン前に落とす)が書く)。-newUrlFastCache(:357-373)が解決自体を保ち、新しい第一候補としてinitで供給されるキャッシュディレクトリを持ちます。MADDataTableFastは-initWithId:cacheDirectory:(:173-181)を得て、+[MADDataTable newDataTableOfType:withObjectID:cacheDirectory:]がそれを渡し(nilは古い振る舞いを保つ)、デリゲートもアプリもなしでテーブルが使えるように接続を即座に開きます。上のデリゲート差し替えによる再ポイントは依然として起こります——それが「URLはデリゲートから導出される」の意図された読み方です——しかしプロパティが最初に読まれた時に依存しなくなりました。
tag(initWithId:fromCache:、:190から設定)が唯一の安定したアイデンティティで、テーブル名(t<tag>、:403-409)とファイル名(<tag>.maddb、:340-343)の両方を生成します。
ファミリ全体をdispatch_sync、dispatch_async、@synchronized、NSLock、os_unfair_lock、pthread_mutexでgrepしました。存在する唯一の並行性プリミティブはqueueBulkAddです。
initWithId:fromCache:(:186)、initWithCoder:(:202)、beginBulkInsert(:1322)——それぞれdispatch_queue_create(..., SERIAL)。-endBulkInsert(:1334)がdispatch_barrier_syncでデリゲート呼び出しを包み、(Revision 4以降)-addRow:error:がdispatch_syncでそれに入ります。-addRow:error:の直列化に決して使われませんでした。したがって-addRow:——変更エントリポイント——はキューによってまったく保護されていませんでした。_bulkInsertLoop下で、-addRow:は呼び出し間で単一のキャッシュされた_statementInsertを再利用します(:529-611): sqlite3_bind_* → sqlite3_step → sqlite3_clear_bindings → sqlite3_reset、相互排除なし。2つのスレッドが同時に-addRow:に入ると、SQLITE_OPEN_FULLMUTEXに関係なくその共有ステートメントで競合します。競合はbind/step/clear/resetのシーケンスにあり、個々のsqlite呼び出しの内側ではないからです。
回帰スイートは現在の並行動作を記録しますが、安全にはできません——直列化を追加しなければなりません。
修正(Revision 4)。 -addRow:error:(:504-528)は今、挿入本体(:529の-insertRow:error:、旧メソッドの名前変更)をdispatch_sync(queueBulkAdd)の下で実行する薄いラッパーで、キューがnilのときだけ直接呼び出しにフォールバックします——それは初期化を完了しなかったテーブルにのみ起こります。-endBulkInsertのsqlite3_finalize(_statementInsert)はそのdispatch_barrier_syncの内側に移りました。キャッシュされたステートメントは挿入が実行中でないときだけティアダウンされます。シリアルキューではバリアとdispatch_syncは相互排他的で、それがbind/step/clear/resetシーケンスに必要な相互排除のすべてです。2つのテストが固定します: testFastTableConcurrentWritersLoseNoRows(新規)は並行キューから4つのライターを駆動し、testFastTableSerializedConcurrentWritesLoseNoRowsはアプリのシリアルキューパターンを保ち、その「テーブルは内部で直列化しない」契約ノートが修正されました。ステップ13(ファイルごとに1接続対)は未変更です。
rowCounterは派生値ではなく独立したカウンタ-insertRow:error:はrowCounterをインクリメントし(:532)、sqliteに決して問い合わせません。-numberOfRows / -countはそれを直接返し(:1222 / :1216)、-removeAllObjectsはそれをゼロにします(:683)。しかし-dropTable(:799)、-dropTableName:(:804)、-deleteAll(:818)、-vacuumCacheDb(:789)はRevision 5までそれに触れませんでした。
したがって2つの真実の源は乖離できます。
rowCounterがNと言い、.maddbファイルが異なる数の行を保持する。-loadFromCacheWithUrl:ラウンドトリップで、カウンタはplistから来(MADDataTable.m:305-306)、行はsqliteファイルから来ます——2つの無関係な機構で再水和されます。修正(Revision 4)——リロード半分。 -loadWithPlist:は今self.rowCounter = [self recountRows];で終わります(:313)。-recountRows(:317-338)はキャッシュファイルにSELECT COUNT(*)を尋ね、テーブルがまだ存在しないときだけplistの値にフォールバックします。メモリ内パスで膨らんだカウンタはリロードを生き延びられなくなりました。testFastTableReloadRecountsRowsFromCacheFileが、カウンタが99と言うplistを3行のファイルの上にロードして固定します。
修正(Revision 5)——メモリ内半分、ステップ10/11。 -dropTable(:799)と-dropTableName:(:804)は今カウンタをゼロにし、-deleteAll(:818)はゼロにし、-vacuumCacheDb(:789)は意図的にゼロにしません。VACUUMはすべての行を保つからです——ソースはそう述べるコメントを運びます。「なぜこれだけがリセットしないのか」は次の読者がまさに持つ問いだからです。-dropTableName:は任意の名前を取るため、消えたテーブルがこれであるときだけカウンタをゼロにします。外部テーブルのドロップはこのカウントに触れてはなりません。-numberOfRows(:1222)と-count(:1216)は依然としてファイルに問い合わせずivarを返します。それが要点です——-recountRowsはリロードパスのチェックで、読み取りごとのコストではありません。
-removeAllObjects(:674)は危険全体を隠していましたし、今も隠しています。4つすべての唯一の呼び出し元で、自身がカウンタをゼロにします(:683)。それが、これを放置せず閉じる価値があったまさに理由です——危険は生きたものになるまで呼び出し元1つでした。-countはアプリへのページカーソルであり(§4.3)、4つのプライベートメソッドはどこか新しい場所から呼ばれるまでgit log -S1つです。ここのRevision-4ノートはドリフトを「コードでは本物だが、今日それに到達できる呼び出し元はいない」と呼びました。呼び出し元監査は依然として成り立ちます——-deleteAllはリポジトリのどこにも呼び出し元がなく、-dropTableは-removeAllObjectsからのみ到達されます——しかしカウンタは今すべてのパスで正しく、唯一の呼び出し元が後で片付けるからだけではありません。MADDataTableRegressionTests.mの4つのテストが4つそれぞれを直接駆動します。
MADDataTableVirtualは同じ形状(:179、:193、:225)ですが、カウンタとsortIndexは一緒に変更されるため、構築上一貫しています。
これはクラスクラスタリファクタで最もリスクのある状態です。MTTableController.mは:377と:399でdatatable.countを読み、:455でそれからhasMore = (count == limit)を導出するため、現実からドリフトしたカウンタはページングを破壊します。Revision 5はその導出も完全にします——空のページはoffset + count - 1をNSUIntegerMaxにラップせず(:380、:402)、失敗パスは前のページを依然として記述するカウントを読む代わりにcompletion(NO)を返します(:449)。
それらのテストを書くことで、カウンタとは無関係な-deleteAllの不具合が浮かびました。それはNSStringを-[MADQueryCacheDeleteAllFromTable initWithObject:]に渡し、それは引数をパラメータ辞書として添字アクセスするため、最初の行でunrecognized selectorをraiseしました。-initWithTableName:が名前を取るイニシャライザで、MADDatabaseSqlite3 -beginBulkInsertがすでに使っていたものです。呼び出し元がないため、誰もそれに当たりませんでした。
| 機構 | 場所 | 保存するもの |
|---|---|---|
Plist、NSPropertyListBinaryFormat_v1_0 |
MADDataTable.m:193-220、:135-191 |
name、columnKeys、columns(メタデータ)、rowCounter。行はなし。 |
sqlite .maddbファイル |
MADDataTableFast.m |
実際の行データ、加えてMADDataTableFast固有キー(urlFastCache、tag、bulkInsertLoop、sortDescriptorsSet、groupKeyIndexes) |
基底クラスの-cacheWithUrl:error:は汎用キャッシュとして文書化されていますが、実際には形状だけをシリアライズし、内容はシリアライズしません。MADocument.m:413-414は[self.dataTable newFilenameMDCache](<tag>.mdcache)からurlDataTableCacheを導出し、MADDataTableFastは<tag>.maddbを読み書きします(:340-343)。2つのファイル拡張子、2つのフォーマット、2つの所有者、1つの論理テーブル。
評価(Revision 5)——ステップ15、調整を求めたもの。枠組みが間違っており、それが発見です。 「基底plistはメタデータのみ」は基底クラスには真で、ファミリには偽です。各サブクラスは-copyPlist / -loadWithPlist:を正確に1つの追加キーで拡張し、そのキーがそのストレージです。
| クラス | ストレージ | それを運ぶplistキー |
|---|---|---|
MADDataTable |
なし(抽象) | name、columnKeys、columns、rowCounter |
MADDataTableVirtual |
sortIndex、行辞書の配列(MADDataTableVirtual.m:106-109、:89-104) |
keySortIndex——行自体 |
MADDataTableFast |
.maddbファイル |
keyUrlFastCache、keyTag、……——行のロケータ |
したがって行はplistがストレージである場所ではすでにplistを通じてラウンドトリップし、ストレージがsqliteファイルである場所ではできません。ファミリ全体にとって、どちらの名前変更(「メタデータと呼ぶ」)も代替(「行を入れる」)も正しくありません。基底クラスは両方のサブクラスが共有するメタデータで、機構は設計上サブクラスごとです。2つの拡張は競合でもありません。MADocumentは<tag>.mdcache(plist)を<tag>.maddb(行)の隣に書き、-loadFromCacheWithUrl:は前者を読んで後者を見つけます——タグが一致する限り。それは一致します。-filename(MADocument.m:1397-1399)はfileURL.lastPathComponentのstringByDeletingPathExtensionで、initがタグのためにハッシュするのと同じ文字列だからです。
価値があり、ここでは行われていないことは、再構築ではなく文書化です。MADocumentのキャッシュディレクトリの2つのファイルをそのまま名指しし、MADDataTable.hで-copyPlistが共有メタデータを返し、独自ストレージを持つサブクラスはそれを拡張しなければならないと述べることです。それは保つべき振る舞いのないコメント変更なので、ここではなくドキュメントパスに属します。
MADDataTableObjectEnumeratorは自身のMADDatabaseSqlite3 + 接続 + プリペアドステートメントを保持し、すべて-initWith...(:60-72)で構築され、-dealloc(:45-49)で解放されます。したがって:
MADReportFormatter.m:449-502はレポートレンダリングの全期間それを持ちます。-removeAllObjects、-dropTable)は未処理の列挙子の生きたステートメントを無効化します。何もこれをガードしません。-objectEnumerator / -enumeratorFor...呼び出しは同じファイルへの新しい接続を割り当てます(:1139、:1158、:1186、:1202)。2回列挙するとsqliteを2回開きます。評価(Revision 5)——ステップ13、ファイルごとに1つの共有接続対を求めたもの。実行されず、理由は数ではなく寿命にあります。 挿入接続はまったく共有できません。MADDatabaseSqlite3 -endBulkInsertは最後にそれを閉じて_databaseをnullにするため(:794-795)、MADDataTableFast -removeAllObjectsは何かをドロップする前に再オープンし、4つのプライベート変更は直接駆動されるとアサートします(直接駆動するのは間違いです——まさにこの理由で先に再オープンするRevision 5のテスト参照)。共有の「対」はしたがって共有読み取り接続とサイクルごとの書き込み接続でなければならず、1つではなく1つのハンドルを節約するだけです。
そして節約は見た目より小さいです。ここのすべての接続はSQLITE_OPEN_SHAREDCACHEを開き(MADDatabaseSqlite3.m:220)、列挙子はすでにファイル全体で1つのページキャッシュと1つのロック集合を共有します。各列挙が実際にコストするのはsqlite3*とファイル記述子で、現実ですが、ステップが示唆する重複キャッシュコストではありません。
それに対して、読み取り接続を共有すると何かを失います。列挙子はレポートレンダリングの長さだけ保持され(MADReportFormatter.m:449-502)、-removeAllObjectsはそれらの下でテーブルをドロップして再構築します。今日、未処理の列挙子は自身のステートメントとハンドルを所有するため、2つはファイルを通じてのみ干渉します。それらに1つの共有ハンドルを渡すと、その相互作用が単一接続の内側に入り、読み取りが独自のロックを持たないクラス上で起こります。設計すべきシナリオは§2.7がすでにフラグするものです——テーブル再構築をまたぐ生きた列挙子——そして接続の共有はそれを悪化させ、改善しません。意図的にそのままにされています。
MADDataTable.hは30のメソッドを宣言します(加えてname / columnKeys / sortDescriptors / columns / rowCounter / tagプロパティ、そのうち2つは書き込みプロトコルが再宣言——§4.2参照)。基底クラスは18を実装し12をスタブします。
MADDataTable.hで宣言 |
基底実装(MADDataTable.m) |
Virtual | Fast |
|---|---|---|---|
-addColumn: |
アサート :365 |
上書き :112 |
上書き :431 |
-addRow:error: |
アサート :369 |
上書き :179 |
上書き :504 |
-addRowWithDataForFieldKeys: |
アサート :374 |
上書き :197 |
上書き :614 |
-sortUsingDescriptors: |
アサート :378 |
上書き :208 |
上書き :634 |
-removeAllObjects |
アサート :382 |
上書き :225 |
上書き :674 |
-objectAtRow:column: |
アサート :386 |
上書き :159 |
上書き :834 |
-objectAtRow: |
アサート :391 |
上書き :151 |
上書き :848 |
-columnsEnumerator |
アサート :396 |
上書き :149 |
上書き :1123 |
-objectEnumerator |
アサート :401 |
上書き :148 |
上書き :1127 |
-beginBulkInsert / -endBulkInsert |
ノーオペレーション :408-409 |
ノーオペレーション :236-238 |
上書き :1311/:1330 |
-allObjects |
return @[] :414-417 |
上書き :118 |
上書き :1209 |
-objectAtRow:limit: |
return @[] :419 |
上書き :220 |
上書き :1086 |
-count / -numberOfColumns / -numberOfRows |
0 :420-422 |
上書き :122、:214、:216 |
上書き :1216、:1220、:1222 |
-countByEnumeratingWithState:... |
0 :423-427 |
上書き :140 |
継承(0) |
-enumeratorForAllObjectsSorted*、-objectsForGroupKeys:、-dataForRow:error:、-enumeratorForKeyObjectsSorted |
NSAssert(NO, @"Not implemented") :327-350 |
同様に NSAssert(NO) :31-54 |
実装 :1034、:1148、:1172、:1193。-dataForRow:error: :941 |
Objective-Cにabstractはありません。そのため基底はかつて-addRow:error:からYESを返し、すべてのリーダーからnilを返していました。部分的に実装されたサブクラスや直接のMADDataTableインスタンスは、静かに書き込みを受け入れて成功を報告し、その後何も読み戻しません。
修正(Phase 0)。 ストレージサブクラスが上書きしなければならない9つの書き込み/読み取りオペレーションは今、NSAssert(NO, @"%s must be overridden", __PRETTY_FUNCTION__)で始まります(MADDataTable.m:365、:369、:374、:378、:382、:386、:391、:396、:401)。:327-350グループに一致します。-addRow:error:はReleaseでtrueではなくfalseを返すため、アサーションがコンパイルアウトされても行が保存されたと主張しません。
2つのグループは静かなデフォルトとして意図的に残されました。それらについては沈黙が正しいからです。
-beginBulkInsert / -endBulkInsert(:408-409)——任意のフック。バルクモードを必要としないサブクラスはノーオペレーションを正当に継承できます。-allObjects(:414-417)、-objectAtRow:limit:(:419)、-count / -numberOfColumns / -numberOfRows(:420-422)、-countByEnumeratingWithState:...(:423-427)——これらは@[] / 0を返し、行のないテーブルにとって真実の答えで、MADDataTableVirtualが返すものに一致します。-countでアサートすると正しい答えがクラッシュになります。この漏れの残り半分——型システムでアサーションではなく分割を表現すること——はPhase 1です(§4.2)。
MADDataTable.h:65は宣言します(@protocol MADDataTableCursoring内)。
- (nonnull NSArray *)allObjects;
MADDataTableFast.mはかつてこう答えていました(このリビジョン前の:1093-1096)。
- (NSArray *)allObjects {
// FIXME: Implement this.
return nil;
}
宣言されたnonnullメソッドが1つのサブクラスでnilを、他で@[] / [self.sortIndex copy]を返す。アノテーションを信頼した呼び出し元はクラッシュします——それはヘッダー契約に矛盾するファミリで唯一のFIXMEでした。
Corrected: 本番呼び出し元はありません。データテーブルの-allObjectsへの送信はこの回帰スイートにのみあり、MADDataTableRegressionTests.mはtestFastTableBulkInsertAllObjectsIsUnimplementedでnilを意図的に固定していました。したがってアノテーションは将来の呼び出し元のために仕掛けられた罠で、生きたクラッシュではありませんでした。
Fixed: MADDataTableFast -allObjects(:1209-1214)は今、-objectAtRow:0 limit:numberOfRowsで毎行を返し、列のないテーブルには@[]を返し、nonnull宣言とMADDataTableVirtualの既存振る舞い(:118-120)に一致します。nilを固定したテストは本当の契約をアサートする2つに置き換えられました。
-objectAtRow:column:がサブクラスごとに異なる意味2つの実装はrowの意味と参照するストレージの両方で不一致です。
// MADDataTableVirtual.m:159-163 — reads the per-column store, applies the sort index
- (id)objectAtRow:(NSUInteger)row column:(NSUInteger)column {
NSString *fieldKey = self.columnKeys[column];
MADDataColumn *dataInColumn = self.columns[fieldKey];
return [dataInColumn objectAtIndex:[self sortedIndexForIndex:row]]; // LOGICAL row
}
// MADDataTableFast.m:834-846 — reads the row dictionary, physical order
- (id)objectAtRow:(NSUInteger)row column:(NSUInteger)column {
NSDictionary *objForRow = [self objectAtRow:row];
if (objForRow == nil || column >= self.columnKeys.count) return nil;
NSString *key = self.columnKeys[column];
MADDataColumn *columnMetaData = self.columns[key];
if (columnMetaData == nil) return nil;
return objForRow[columnMetaData.identifier]; // PHYSICAL (sqlite) order
}
境界の規律も異なることに注意: Virtualはcolumnに境界チェックをせず(self.columnKeys[column]は範囲外でNSRangeExceptionを投げ、-objectAtRow:の@tryだけが捕捉し、ここでは捕捉しない)、dataInColumnのnilチェックもしません。Fastは両方を行います。
同じセレクタ、2つの意味論の集合。MADMySQLはこれをタイトループで呼ぶため(MADDatabaseMySQL.m:88-92ともう3サイト)、意味論を統一するリファクタは最初にMySQLで感じられます。
-dataForRow:error:が一方のサブクラスに実装され、他方で欠けているこのセクションはこのレポートの最初のリビジョンで間違っていました。 MADDataTableFastが-dataForRow:error:を実装しておらず、バーコード/印刷パスが基底クラスのNSAssert(NO)に当たると主張していました。それは偽で、読者を偽の道に送りました。修正された分析は次のとおりです。
MADDataTable.h:67は- (nullable NSDictionary<NSString *, id> *)dataForRow:(NSUInteger)rowID error:(NSError **)error;を宣言し、基底はNSAssert(NO, @"Not implemented: %s") + return nilで実装します(MADDataTable.m:342-345)。
MADDataTableFastは実装しています、MADDataTableFast.m:941-1015:
- (NSDictionary <NSString *, MADResult *> *)dataForRow:(NSUInteger)cacheId
error:(NSError * __autoreleasing *)outError {
それは2行のシグネチャで、以前のリビジョンが誤読したものです。セレクタが2行目に折り返し、2行目が別の-dataForRow:column:オーバーロードと取られました。(本当の-dataForRow:column:error:は:866-932の別メソッドです。)実装は本物で、回帰スイートはすでにそれをカバーしています——MADDataTableRegressionTests.mのtestFastTableDataForRowReturnsValuesとtestFastTableDataForRowCachesLastRowはどちらも2引数セレクタを生きたMADDataTableFastに送り、通ります。
MADDataTableVirtualはどちらの形も実装していません。 :41-44に-dataForRow:スタブがありますが、そのスタブはNSAssert(NO, @"Not implemented: %s") + return nilで、機能するオーバーロードではなく、MADDataTableVirtual.hで宣言されていません。2引数形はアサートする基底に落ちます。したがってメモリ内サブクラスには行IDアクセスがまったくありません。
呼び出しサイトはしたがって危険ではありません。MADocument.m:875/880/919はMADocument.dataTableにディスパッチし、それは静的にも実際にもMADDataTableFastです(MADocument.m:159、:230と:288で割り当て)。MADPrintPageElement.m:80とMADPrintPageElementBarcode.m:30のパスは同じオブジェクトに到達します。生きたパスでアサートするものはありません。
本当の不具合はより狭く、今修正されています。MADDataTableVirtualがセレクタを実装しなかったため、MADDataTable *を保持する将来の呼び出し元がたまたまVirtualテーブルだと、Debugではアサートし、Releaseでは静かにnilを受け取っていました。MADDataTableVirtualは今-dataForRow:error:を-objectAtRow:に委譲して実装し、範囲外ケースをエラーポインタで報告します。
MADDataTableFast実装にも本物の不具合があり、今修正されています。そのif (sqlite3_prepare == SQLITE_OK)にはelseがなく、prepare失敗が*outErrorを設定せずにnilを返し、-getSql:エラーが破棄されていました。兄弟の-dataForRow:column:error:(:905-932)は両方を正しく扱います。SQLはまたsqlite3_mprintfにフォーマット文字列として渡され(sqlite3_mprintf((char *) sql.UTF8String))、%を含むSQLを壊すかクラッシュさせました。今はsqlite3_mprintf("%s", ...)で、:901の兄弟に一致します。MADSqlite3のさらに8サイトが同じ不具合を持ち、すべて今修正されています——§4.5参照。
MADDataTableFastが別クラスのプライベートivarに手を伸ばすMADDataTableFast.mはMADDatabaseSqlite3のプライベートivar _databaseに15サイトで直接アクセスします——:488、:538、:784、:793、:810、:829(_databaseForInserts経由)と:905、:976、:1065、:1078、:1106、:1108、:1248、:1251、:1261(databaseForSelects経由):
sqlite3 *sqlite_database = _databaseForInserts->_database; // :451
NSAssert(prepareResult == SQLITE_OK, @"%s", sqlite3_errmsg(databaseForSelects->_database)); // :1008
これはMADDatabaseSqlite3のAPIを完全に迂回し、MADDataTableFastが何かをするために本物のsqliteファイルを必要とする理由です。また、テストターゲットがMADDataTable+Constructorモジュールインポート作業を必要とした理由でもあります。クラスファミリは両方のフレームワークを一緒にリンクするコードからのみ使えます。
MADDataTableLocation(MAD/Source/MADDataTableLocation.{h,m}、67行)はNSCodingと+newDataTableLocationForRow:inColumn:ファクトリを持つ(row, column)値オブジェクトでした。独自の実装を除いてコードベース全体をgrepしました。その唯一の参照は回帰テストファイルにありました。 本番では死んでいました。またNSCodingを採用しましたがNSSecureCodingは採用せず、回帰スイートがそれを契約として記録していました。
Phase 5ステップ14は選択を提供しました——機能に配線するか削除するか。削除されました。待っていた機能がなかったからです。その全歴史で1コミット(e702bb062、MADフレームワーク再編成)、呼び出し元なし、それが何のためかを記述するのは自身の3つのテストだけ。テストだけで生かされるクラスは、テストが二重に支払っているクラスです。ファイル、2つの.pbxprojビルドエントリ、3つのテストはそれとともに消えました。§3.7は再番号付けされず漏れ6として残り、レポートの残りが引用する番号付けが保たれます。
MADDataTableFastは4つのプロトコルにプライベートに準拠します(:71)。
@interface MADDataTableFast () <MADQueryParametersStandardProtocol,
MADQueryParametersColumnKeysProtocol,
MADQueryParametersColumnMetaProtocol,
MADQueryParametersColumnDataProtocol>
そして-queryTableName / -queryColumnKeys / -queryColumns / -queryRowData(:419-430)を、MADQueryCacheAddRowが書き込み先のテーブルから状態を引き出せるようにするためだけに実装します。したがって挿入パスは循環です。テーブル → クエリオブジェクト → テーブルへ戻る。名前衝突リスクに注意——-queryRowData(:428)とプライベート_rowDataLastInsertedプロパティは公開の-dataForRow:ファミリとは無関係です。
MADDataTable+Constructor.m:51-69にある。MADSqlite3にプライベートで、NSEnumerator *としてのみ表面化する。MADReportFormatter.m:463-472はすでに行IDのみの列挙を許容する。MADArrayCaching(MADSqlite3)は、より狭いプロトコル形状の表面を持つキャッシュ抽象の、このコードベースの先行事例です。目標は、5つのドライバと4つの消費者がすでに依存する振る舞いを変えずに、MADDataTableを交換可能なストレージとアクセス戦略の上の安定したインターフェースにすることです。
クラス名を保ち(NSCodingアーカイブとCore Dataに焼き込まれている)、変動をコンストラクタが返す2つのプロトコルの背後に移します。
┌─────────────────────────────────────┐
│ MADDataTable (concrete base) │
│ metadata, plist persistence, │
│ NSCoding, — no-op defaults removed │
└──────────────┬──────────────────────┘
│
┌──────────────────────────┴───────────────────────────┐
│ │
MADDataTableVirtual MADDataTableFast
(unchanged semantics) (sqlite; owns a connection pair)
Both conform to:
<MADDataTableWriting> removeAllObjects / addColumn: /
begin|endBulkInsert /
addRowWithDataForFieldKeys:
<MADDataTableReading> objectAtRow: / objectAtRow:column: /
count / numberOfRows
<MADDataTableCursoring> enumeratorForKeyObjectsSorted /
enumeratorForAllObjectsSorted /
enumeratorForAllObjectsSortedRowIdOnly
MADDatabaseSqlite3.m:474-540とMADDatabaseSQLServer.m:500-1472はMADDataTable *ではなくid <MADDataTableWriting>を取るべきです。それだけで「基底クラスが破棄した書き込みからYESを返す」危険がすべてのドライバから消えます。
Phase 0 — 失敗モードを大声にする(振る舞い変更なし)。
MADDataTable.m:365-403)。正直な空テーブルの答えと任意のバルクフックはデフォルトとして残されました。それらについては沈黙の値が正しいからです。分割と理由は§3.2、契約はMADDataTableRegressionTests.mのtestBaseTableAbstractOperationsAssert参照。MADDataTableFast -dataForRow:error:を「現在アサートする」ため実装するよう述べていました。そうではありません。メソッドは:941-1015に実装され、以前の読みは2行のシグネチャをcolumn:オーバーロードと誤解しました。セレクタが本当に欠けていたサブクラスはMADDataTableVirtualで、今は-objectAtRow:に委譲して実装します。-allObjects(§3.3)はMADDataTableFastでnilを返すnonnullメソッドでしたが、今は行を返します。同じパスでMADDataTableFast -dataForRow:error:はprepareチェックに欠けていたelseを得て、-getSql:エラーを破棄せず、SQLをフォーマット文字列としてsqlite3_mprintfに渡さなくなりました。MADDataTableRegressionTests.m)に対して再検証します——インスタンス化、列挙、並行性をすでに固定しているため、ここの誤りを検出します。(Revision 5がクラスを削除するまでMADDataTableLocation契約も固定していました。)Phase 1 — プロトコルを宣言する。
完了——スタブブロックは意図的に保たれた。 3つのプロトコルはMADFoundation/Source/MADDataTable.hの@interfaceの上で宣言され、それは今MADDataTable : NSObject <NSCoding, NSFastEnumeration, MADDataTableWriting, MADDataTableReading, MADDataTableCursoring>を読み、@interface本体にあった30のフラットなメソッド宣言はそこから消えました。分割は軸ごとです。Writingは変更可能な表面(removeAllObjects、addColumn:、addRow:error:、addRowWithDataForFieldKeys:、sortUsingDescriptors:、加えて@optionalのbeginBulkInsert/endBulkInsert)、Readingはランダムアクセスとカウント、Cursoringは列挙で、3つのソート済み列挙子とobjectsForGroupKeys:は@optionalです。MADDataTableVirtualがそれらを提供できないからです。
計画の「今や冗長なスタブブロックを削除する」は実行されませんでした。両方のスタブブロックは固定された契約で、冗長ではないからです。testBaseTableAbstractOperationsAssertは9つの基底クラスアサートスタブが存在して投げることを要求し、testVirtualTableDoesNotImplementSortedEnumeratorsはMADDataTableVirtualの4つのsqlite専用セレクタに対して-respondsToSelector:がYESであることをアサートします。どちらかを削除すると、捕捉された不具合がunrecognized-selectorクラッシュになり、まさにそれを防ぐために存在するテストを壊します。MADDataTableはアサートすることでプロトコルの@requiredメンバーを満たし、それがPhase 0がそこに置いたものです。
完了(Revision 4)——3つのドライバすべてとプロトコル。 下のブロックはこれがなぜブロックされたかについてのRevision 3の説明で、記録のために保たれています。それが特定したアンブロックは取られました。MADMySQLFetch+DataTable.mが必要とする列メタデータ(columns、columnKeys)は今<MADDataTableWriting>自身が宣言するため、書き込みポートはMySQLにも十分です。MADMySQLFetchの2つのfetchWithCommand:dataTable:...メソッドとプライベート-fetchResultsFromConnection:intoDataTable:...はid <MADDataTableWriting>を値で取り、同じテーブルを返します((MADDataTable *)dataTable)。MADDatabaseMySQL.mの11呼び出しサイトとMADMySQLLiveTests.mの7つすべてが&を落としました。メタデータは4つ目のプロトコルではなく書き込みプロトコルに置かれました。MySQLが書き込みながらそれを読み(最初の行で列の型を修正する)、すべての準拠者が基底クラスから無料で得るからです。§2.5の// FIXME: This is a hack.は未変更です。
記録のためのRevision 3テキスト: 部分的に完了——3つのドライバのうち2つ、プロトコル宣言は意図的に狭められていない。 MADDatabaseSqlite3(executeSQL:...intoResultTable:、executeQuery:withDataTable:andError:、executeQuery:withError:)とMADDatabaseSQLServer(同じ2つ、加えてプライベート-runQuery:onProcess:withDataTable:と-runSQL:onDataTable:fieldKeys:process:)は今id <MADDataTableWriting>を取ります。どちらも真に書き込み専用です。テーブルに送るものをgrepすると、正確に5呼び出しポート以外何も返りません。
MADDatabaseMySQLはまだ狭められず、MADAPI/Source/MADDatabaseProtocol.h:28-31も同様です。障害はドライバにありません——MADMySQLFetch+DataTable.mにあり、テーブルを充填しながら(*dataTable).columnsと.columnKeysを読み、最初の行を見たときに列の型を修正します(:301と:321、:297の既存// FIXME: This is a hack.の下)。したがって列メタデータを公開しない書き込みポートはそのパスに不十分です。MADDatabaseMySQLはMADDatabaseDataSourceに準拠し続けなければならないため、プロトコルを狭めると自身の実装が果たせないものを約束することになります——コンパイルエラーではなく、次の呼び出し元へのリモートクラッシュ。両方の宣言がここを指すコメントを運びます。
これを確認中に見つかった具体的なアンブロック: MADMySQLFetch+DataTable.mはそのMADDataTable * __autoreleasing *出力パラメータを通じて決して代入しません——grep -n '\*dataTable *=' MADMySQL/Source/MADMySQLFetch+DataTable.mは何も返しません。ポインタは呼び出し元が決して知らされなかった入力パラメータです。値を渡す形(dataTable:(id <MADDataTableWriting>)dataTable)にするとポインタ型の問題が完全に消え、MADDatabaseMySQL.mの11呼び出しサイトが&を落とせます。それと、列メタデータアクセサを<MADDataTableWriting>か4つ目のプロトコルに追加することが、MySQLに残るすべてです。§4.3がすでにMySQLを最高リスクの消費者とランク付けし、変更は単独でレビューできるほど機械的なため、バンドルではなく延期されます。
sqliteには今可能、MySQLには未証明。 MADDatabaseSqlite3の行ループは、<MADDataTableWriting>に準拠する任意のオブジェクトで、.maddbファイルもアプリデリゲートもなしで駆動できます。パラメータがもはやMADDataTableクラスを意味せず、それを通じた§2.3の[MADApplication AppDelegate]への-urlFastCache依存も意味しないからです。そのようなモックテストはまだ書かれていません。自然な次のステップで、Phase 2の注入キャッシュディレクトリが安くする最初のものです。
Revision 4: ホストレス半分は証明されました——testFastTableInitWithCacheDirectoryNeedsNoDelegateがディレクトリとデリゲートなしで機能する物理テーブルを構築します。
Revision 5: 完了、両半分。 testDriverFillsAWritePortWithNoDataTableBehindIt(MADSqlite3Tests/MADDatabaseSqlite3DatabaseTests.m)が行ループにMADWritePortRecorder——<MADDataTableWriting>にのみ準拠するNSObject——を渡すため、MADDataTableもMADDataTableFastもキャッシュデリゲートも.maddbもなく、5つの呼び出しが約束された順序で両方の行を無傷で到着することをアサートし、.maddbファイルが現れたら失敗します。モックが表現できるのはパラメータがプロトコルだからです。
Phase 2 — ストレージ位置の曖昧さを取り除く。完了(Revision 4)。
urlFastCacheを計算ではなく保存にする(§2.3)。一度_urlFastCacheに解決され、デリゲート差し替えが再オープン前に-setCacheDelegate:でそれを落とすため、解決は常に現在のデリゲートに対して行われます。[MADApplication AppDelegate]に手を伸ばすのではなく、キャッシュディレクトリを注入する。-initWithId:cacheDirectory:と+newDataTableOfType:withObjectID:cacheDirectory:がそれを運び、nilは古いチェーンを保ちます。testFastTableInitWithCacheDirectoryNeedsNoDelegateがデリゲートなしで物理テーブルを構築、充填、読み取りします。Phase 3 — rowCounterを派生にする。
SELECT COUNT(*)に裏付けられたプライベート-recountRowsを追加し、MADDataTableFastで-numberOfRows/-countがそれを使う(またはそれに対して無効化する)ようにする。アーカイブ互換のためにrowCounterプロパティを保つが、真実の源として扱うのをやめる(§2.5)。Revision 4: -recountRowsが存在し、-loadWithPlist:の最後に実行されるため、リロードされたテーブルはファイルと不一致のカウンタを運べなくなりました。Revision 5: メモリ内半分が閉じられました——カウンタに触れなかった4つの変更が今それをファイルを記述する状態で残します(§2.5)。-numberOfRows/-countは設計上ivarを返し続けます。それが今唯一の読み手で、-recountRowsがリロードをガードします。4つのテストが4つのメソッドをカバーします。MTTableController.m(以前は:375/395/440/445)を監査する——ページングはファイルからドリフトし得るカウンタを読んではなりません。完了(Revision 5)、カウンタが正直になればできません。すべてのフェッチは-removeAllObjectsで始まり、それはテーブルをクリアしてカウンタをゼロにするため、完了時のカウントは今書かれたページだけを測ります。それでもまさにそれらの行で2つの不具合が見つかり修正されました。:380/:402で空ページのoffset + count - 1がNSUIntegerMaxにラップし、:449の失敗パスがドライバがクリアしていないテーブル(成功時のみクリアする)からカウントを読み、前のページを測り、失敗したフェッチがhasMore = YESを報告して自身を再発行しました。失敗したページは今、これ以上なしを報告します。Phase 4 — 並行性を修正する。
-addRow:error:をqueueBulkAddで直列化する(§2.4)。キューはすでに存在し、-endBulkInsertにすでに使われており、変更パスへ拡張するのは小さく閉じた変更です。-endBulkInsertのsqlite3_finalize(_statementInsert)をバリアの内側に移し、キャッシュされたステートメントが-addRow:の実行中でないときだけティアダウンされるようにする。完了(Revision 4)——ティアダウンは今:1334のdispatch_barrier_syncの内側の最初のものです。-objectEnumeratorが現在呼び出しごとに新しい接続を開くからです(§2.7)。書き込み半分には共有が使えず(-endBulkInsertがそのハンドルを閉じる)、読み取り半分にはほとんど何も買わず(SQLITE_OPEN_SHAREDCACHEがすでにキャッシュを共有する)、テーブル再構築をまたぐ生きた列挙子ケースを改善ではなく悪化させます。§2.7に完全な議論があります。Phase 5 — 死んだ表面を退役させる。
MADDataTableLocation(§3.7)とその3つのテストを削除するか、実際の機能に配線する。現在、本番呼び出し元のない公開APIです。Revision 5で削除——配線ではなく削除されました。歴史に1コミットしかなく、それを記述する自身のテスト以外何もないからです。MADターゲットのHeadersとSourcesフェーズが2つのファイルをそれとともに落とします。MADDataTableVirtualのkeySortIndex)、sqliteファイルである場所ではできません(MADDataTableFastのkeyUrlFastCache)。したがって名前変更も代替も正しくありません。§2.6がサブクラスごとの表と残された文書変更を記録します。| 消費者 | サイト | リファクタ下のリスク |
|---|---|---|
MTTableController |
:249, :281, :284, :377, :393, :399, :449, :455 |
高——countをページカーソルとして扱う。rowCounter意味論の変更はページングを壊す。Revision 5は導出を完全にした——空ページはもはやアンダーフローせず、失敗したフェッチはもはや前のページのカウントを読まない(§2.5)——が、結合は変わらない |
MADDatabaseMySQL |
:88-92, :118-122, :150-154, :187-189 |
高——O(n)のobjectAtRow:i column:0。サブクラスごとのrow意味論を先に統一しなければならない |
MADocument |
:197(rowCounter)、:865-867(列挙子)、:874-919(dataForRow:error:)、:1053-1072 |
高——ただし列挙子とrowCounterのみ。その-dataForRow:error:送信はセレクタを実装するMADDataTableFastに解決されるため、印刷/バーコードパスは健全(§3.5参照) |
MADMySQLFetch+DataTable |
:301, :321 |
中——// FIXME: This is a hack.(:297)の背後でフェッチ中にcolumn.typeを変更する。列辞書は公開で変更可能なままでなければならない |
MADQuerySampleDataTable(Range) |
:118, :126 / :123, :131 |
低——単一のobjectAtRow:0幅プローブ |
MADReportFormatter |
:449-502 |
低——行IDと辞書列挙の両方を許容 |
MADDatabaseSQLServer |
:500, :1367, :1472 |
低——5メソッドポートを通じた書き込み専用 |
MADDataTableTypeの生値を変えない。 MADDataTableParametersTypeは定義辞書にエンコードされ(MTTableController.m:91、MTTableViewControllerBarcodeExtraMaxicode.m:104)、enumはinitWithShort:でシリアライズされます。MADDataTableFastアーカイブは[MADDataTableFast keyTag]形式のキーを運び(:114-119)、MADDataTableVirtualはkeySortIndex(:202)を既存の.mdcache/.maddbファイルに運びます。removeAllObjects → addColumn: → beginBulkInsert → addRowWithDataForFieldKeys: → endBulkInsertに依存します。sqlite3_mprintfに渡す§3.5の修正中に見つかりました。他の8つの呼び出しサイトが変数を引数ではなくフォーマット文字列としてsqlite3_mprintfに渡していました。SQL内の任意の%が変換として読まれ、それを含むクエリが壊れるか、引数リストを読み越えてクラッシュします。
修正済み。 8つすべてが今、リテラル"%s"とSQLを引数として渡し、すでに正しかったサイトに一致します。
| ファイル | サイト |
|---|---|
MADSqlite3/Source/MADDataTableFast.m |
:1062、:1102、:1245 |
MADSqlite3/Source/MADDatabaseSqlite3.m |
:301、:397、:875 |
MADSqlite3/Source/MADDataTableObjectEnumerator.m |
:69 |
MADSqlite3/Source/MADDataTableSingleColumnEnumerator.m |
:64 |
すでに正しかった参照サイトはMADDataTableFast.m:548、:901、:973とMADDatabaseSqlite3.m:459でした。MADSqlite3のすべてのsqlite3_mprintf呼び出しは今、リテラル"%s"か変換を含まないリテラルフォーマット文字列を使います——grep -n sqlite3_mprintf MADSqlite3/Source/*.mは14の呼び出しを返し、変数フォーマット文字列はありません。
到達可能性は低かったです。SQLは生成されたクエリビルダーから来て、リポジトリ全体の検索で%を導入するLIKEパターンは見つかりませんでした。しかし識別子は接続されたデータベースのスキーマから来るため、列名やテーブル名の%はこれに当たっていたでしょう。生きた不具合ではなく潜在的な正確性の不具合でした——変更が機械的で、間違えた結果が静かな破損だから修正されました。
| ファイル | 行数 |
|---|---|
MADFoundation/Source/MADDataTable.h / .m |
123 / 435 |
MADFoundation/Source/MADDataTableVirtual.h / .m |
21 / 240 |
MADFoundation/Source/MADDataTableType.h |
17 |
MADFoundation/Source/MADDataColumn.h、MADDataProtocol.h、MADCacheProtocol.h |
— |
MADSqlite3/Source/MADDataTableFast.h / .m |
47 / 1355 |
MADSqlite3/Source/MADDataTableObjectEnumerator.m |
173 |
MADSqlite3/Source/MADDataTableSingleColumnEnumerator.m |
149 |
MADSqlite3/Source/MADQueryCacheAddRow.m |
152 |
MADSqlite3/Source/MADDatabaseSqlite3.m |
1346 |
MAD/Source/MADDataTable+Constructor.h / .m |
30 / 94 |
MAD/Source/MADocument.m、MADReportFormatter.m |
— |
MADMySQL/Source/MADDatabaseMySQL.m、MADMySQLFetch+DataTable.{h,m} |
— |
MADTdsClient/Source/MADDatabaseSQLServer.m |
— |
MADAPI/Source/MADDatabaseProtocol.h、MADQuery.h、MADDatabaseResultsProtocol.h |
— |
MADDesigner/Source/MTTableController.m |
— |
MAD/MADTests/MADDataTableRegressionTests.m |
69テスト |
このページは英語原文の日本語翻訳です。内容に相違がある場合は、英語原文が優先されます。