このページではMADModelについて説明します。Rptqエンティティ上の読み取りモデルで、各クラスが何であり、どのように設定され最新に保たれ、誰が読むのかを扱います。
元の日付に書かれ、現状の事実は2026-11-22に整合。
スコープ: MAD/Source/model/MADModel*.{h,m}、MAD/Source/model/MADTableFieldIdentifier.{h,m}、およびMADとMAD Designerのレイヤーのすべての消費者。
日付: 2026-10-16、d7faff320で読了。
ステータス: リファレンス。ここにあるものはすべてそのコミットで直接読まれました。§7のリファクタリング候補は提案であり、適用されていません。
MADModel*はドキュメントスコープの読み取り専用ビューで、ドキュメントの定義——接続、スキーマ(テーブルとフィールド)、クエリグラフ(クエリが使うテーブル、フィールド、それらの間の結合)——を表します。デザイナのクエリUIがバインドするものです。
それは正規モデルではありません。正規モデルはポータブルストアのRptq*オブジェクトグラフです。アプリが編集し、保存し、変換し、レンダリングするものです。MADModel*オブジェクトはストア行識別子(int64_t)+ RptqStoreContextへの弱ポインタ + いくつかのコピーされた表示値にすぎず、objectsForEntity:identifier:で行をフェッチして遅延解決されます。
コードが従う経験則:
Rptqを通じて書き、MADModelを通じて読み観察する。
2つのレイヤーは1つの識別子空間を共有します。モデルオブジェクトのidentifierはまさにストア行のidentifierです。それが接着剤のすべてです——§3参照。
MADModelDocument one per open .mad — MADocument.documentModel
└ databases: [MADModelDatabase] (today: exactly one)
├ driverID / driverType / schemaName ← RptqDatabase + RptqDatabaseCredentals
├ tables / tableDictionary : {id → MADModelTable} ← RptqDatabaseSchemaTable
│ └ MADModelTable (name, queryable)
│ └ fields / fieldIDs : {id → MADModelField} ← RptqDatabaseSchemaField
│ └ MADModelField (name, dataType, decimals, width, primaryKey)
└ queries: [MADModelQuery] (today: exactly one; `firstQuery` everywhere)
└ MADModelQuery
├ queryTableIDs / tables : {id → MADModelQueryTable} ← RptqQueryTable
│ └ MADModelQueryTable (schemaTable id, dropIndex, alias)
│ └ queryFields : {id → MADModelQueryField} ← RptqQueryField
│ └ MADModelQueryField (schemaTable + schemaField ids)
└ queryLinkIDs / links : {id → MADModelQueryLink} ← RptqQueryLinks
└ MADModelQueryLink (left/right table+field ids — one join)
MADModel — アイデンティティ(MADModel.h、MADModel.m)基底クラスはアイデンティティのみです。_uid(MADModel.m:32-64)と、hash、isEqual:(同じクラスと同じ_uid)、NSNumberにボックス化されたIDを返す-objectIDを持ちます。+[MADModel newModelDocument:](MADModel.m:35)は名目上のファクトリですが、誰も呼びません。MADocumentはMADModelDocumentを直接割り当てます。MADModelType.hはMADModelTypeUnknown/Document/Database/Queriesを定義しますが、ツリー内でこのenumを使うものはありません。
objectIDという名前と、_objectID.URIRepresentationをフォーマットするコメントアウトされたdebugDescriptionが、レイヤーの年齢を示す手がかりです。オブジェクトはかつてNSManagedObjectIDをラップしていました(§5参照)。
MADModelDocument — ルート(MADModelDocument.h、.m)-MADocument.documentModel(MADocument.m:389-395)が開いているドキュメントごとに一度、self.storeContext上で遅延作成します。本番でそれを構築するものは他になく、アプリデリゲートは関与しません。databasesを保持し(-updateDocumentDatabaseQuery、MADModelDocument.m:210-240が構築: RptqQuery行ごとに1つのMADModelDatabase——ここでの「データベース」は接続+そのスキーマ+クエリ)、firstDatabase / firstQuery便利アクセサを持ちます。コードは複数形が芝居である理由を述べています。「現在のバージョンのソフトウェアは1つのデータベースとクエリだけを使う」(MADModelDocument.m:207-208)。RptqStoreContextObjectsDidChange、WillSave、DidSave、MADModelDocument.m:160-176)。プライベートなNSOperationQueue(MADModelDocument.m:83-87、_objectContextQueue)上です。RptqQueryTableまたはRptqQueryLinks行の挿入/削除で変更をfirstQueryにミラーします——§3.3参照。-update(MADModelDocument.m:201-205)はdocument→database→queryスキャンを再実行し、_databasesを新しいオブジェクトで置き換えます。MADModelDatabase — 接続、スキーマ、クエリ(MADModelDatabase.h、.m)RptqDatabase行の識別子をキーにします。driverType(MADModelDatabase.m:157-164)、schemaName(:166-173)、driverID(:175-182)はそれぞれ遅延してRptqDatabaseをフェッチし、RptqDatabaseCredentalsへ読み通します。schemaNameと壊れたdriverName(§6)はどちらも認証情報のdbnameと答えます。tables / tableDictionary(-updateTables、MADModelDatabase.m:221-247)はinDatabaseが一致するすべてのRptqDatabaseSchemaTableを名前順にソートして一覧します——移行前のフェッチが適用したソートを復元し、BUGS.mdを指すコメント付きです。queries(-updateQueries、:249-261)はRptqQuery行に対して同じことをします。MADModelTable / MADModelField — スキーマ(MADModelTable.{h,m}、MADModelField.h)MADModelTableはnameをキャッシュし、inTableが一致するRptqDatabaseSchemaField行からfields / fieldIDs(MADModelTable.m:120-146)を名前順に遅延構築します。MADModelFieldはプレーンな値です。名前、主キーフラグ、データ型、ネイティブ型、小数桁、幅——ストアアクセスなし。MADModelQuery — 1つのクエリ(MADModelQuery.h、.m)最大のクラスで、実際にその価値を発揮するものです。所有するもの:
queryTableIDs + tables(MADModelQuery.m:213-283): inQueryTable.inQueryがこのクエリであるすべてのRptqQueryFieldが辞書に射影され(MADStoreProjectionForQueryField、:59-68——古いCore Dataフェッチ射影が生成したのと正確な形)、-insertTablesFromFetchRequestResults:に供給されます。queryLinkIDs + links(:302-344): RptqQueryLinksについて同じ(MADStoreProjectionForQueryLink、:70-78)。-tablesInLinks(:183)と-orphanedQueryTables(:196、どのリンクも触れないテーブル、NSExpressionの集合差)。-insertQueryTable: / -insertQueryLink: / -deleteQueryTableID: / -deleteQueryLinkID:とIDベースの変種。それぞれがコレクションに変更を適用し、次にMADNotificationQueryTableInsert/DeleteまたはMADNotificationQueryLinkInsert/Delete(名前はMADModel.h:22-26)を[NSOperationQueue mainQueue] addOperationWithBlock:経由でメインキュー上で再ポストし、影響を受けたモデルオブジェクトをuserInfoに入れます。これらの通知がレイヤーの公開イベントストリームで、デザイナが購読します(§4)。MADModelQueryTable / MADModelQueryField — クエリのテーブルとフィールドMADModelQueryTable(MADModelQueryTable.m)はdropIndexとスキーマテーブルIDをキャッシュし、queryFields / queryFieldIDs(-addField:schemaField:、:92が構築)を遅延保持します。-alias(:119-129)はSQL向けの名前です。最初のコピーはスキーマテーブルの名前、以降は名前+ドロップインデックス(Customer、Customer0、……)。MADModelQueryField(MADModelQueryField.m)は2つのIDです。スキーマテーブルとスキーマフィールド。-schemaField(:52-57)はdatabase → tableDictionary[schemaTable] → fields[schemaField]と歩いて実際のメタデータを解決します。このチェーン——リンク → クエリテーブル → スキーマテーブル → クエリフィールド → スキーマフィールド——がレイヤーの決定的パターンです。MADQueryVisualizationViewController.m:1024-1048がコネクタを配置するために手でそれを行います。MADModelQueryLink / MADTableFieldIdentifierMADTableFieldIdentifier(MADTableFieldIdentifier.{h,m})は小さな値の対(テーブルID + フィールドID)で、NSNumberアクセサを持ちます。MADModelQueryLink(MADModelQueryLink.m)は両端のMADTableFieldIdentifierを保持し、生IDかRptqQueryLinks行から構築されます(-initWithRptqQueryLink:、:60-76、hasLeftField.inQueryTable.identifier / hasLeftField.identifierを読む)。-isAdjacentToQueryTable:(:78)と-tables(:82)はビジュアライゼーションが尋ねるグラフの問いに答えます。MADModelIDProtocol — 4行: identifier(MADModelIDProtocol.h)。MADModelDataProtocol(MADModelDataProtocol.h)— managedObjectContext、-initWithIdentifier:managedObjectContext:、-update。実際には-updateは内部リフレッシュフックで、レイヤー自身の遅延ゲッターからのみ呼ばれます(MADModelDocument.m:188、MADModelTable.m:99、:115)。MADModelDatabase -update(MADModelDatabase.m:148)と-MADModelQuery -update(MADModelQuery.m:354、空のメソッド)には呼び出し元がまったくありません。MADocumentはMADModelDocumentを1つ遅延構築し(MADocument.m:389-395)、ドキュメントの寿命まで保持します。RptqStoreContextを弱く保持します(MADModelDocument.m:42)。コンテキストを保持するすべてのモデルオブジェクトと同様で、ストアコンテキストはドキュメントが所有します。
ドキュメントより下のすべては遅延かつキャッシュされます。databases、tables、fields、queryTableIDs、queryFields、linksの最初の読み取りがフェッチ・アンド・フィルタパスをトリガーします(関連するRptqエンティティに対するobjectsForEntity:、親の識別子でフィルタし、移行前のフェッチがソートした場所でソート)。キャッシュは-updateを呼ぶか下の通知パスによってのみ無効化され、何も自然に期限切れになりません。
デザイナでテーブルやリンクを追加するとRptq行が書かれます(例えばMADQueryViewController.m:745-790のadd-tableフローがRptqQueryTable + RptqQueryField行を作成してコンテキストを保存)。モデルはその後自身で追いつきます。
user adds a table / link
→ RptqQueryTable / RptqQueryLinks rows written + saved
→ RptqStoreContextObjectsDidChangeNotification
→ MADModelDocument's observer (on its private queue) MADModelDocument.m:91-158
→ [firstQuery insertQueryTable:/insertQueryLink:] MADModelQuery.m:361-410
→ MADNotification…Insert/Delete reposted on main MADModelQuery.m:361-514
→ MADQueryVisualizationViewController, MADQueryBuilderAddTableViewController
2つのキューが関与します。モデルは_objectContextQueue(プライベートNSOperationQueue、MADModelDocument.m:83-87)で変更し、通知はメインキューで到着します。コレクション自体は同期されません。
-update(ドキュメントまたはデータベース)は新しいモデルオブジェクトでコレクションを再構築します。以前に渡されたモデルオブジェクトはキャッシュしたものについては動作し続けますが、firstQuery.tablesにあるものではなくなります。ツリー内で今日モデルオブジェクトの-updateを呼ぶものはなく(通知パスがライブのもの)、-updateをまたいでモデルオブジェクトを保存するコードは古いエントリを読むことになります。
MADQueryViewDataSource.m:365 — データソースヘッダーセル: firstDatabaseからの「You are connecting to driverID datasource named schemaName」。MADQueryViewDataSource.m:533-546 — クエリテーブルリストはfirstQueryを取り、query.identifierを使ってRptqQueryTable行をフィルタします。パターンに注意: モデルがアイデンティティとメタデータを供給し、行自体はRptqオブジェクトです。MADQueryTableViewController.m:163-174 — クエリテーブルのボックスタイトルはfirstQuery.tables[id].aliasから来ます。:186-200と:239-266はfirstDatabase.tableDictionary[schemaTableID] → fieldIDs / fieldsからスキーマフィールドリストをレンダリングします。これがスキーマブラウザのコンテンツモデル全体です。MADQueryBuilderAddTableViewController.m:29-33 — モデルの挿入/削除通知を監視してテーブルパネルを最新に保ちます。MADQueryVisualizationModel(MADQueryVisualizationModel.m:40-77)は-[MTGraph initWtthQueryID:](MTGraph+RptqQuery.m:39-67)経由でMTGraphを構築し、それは完全にモデル上で書かれます。query.queryTableIDsが頂点になり、query.linksがエッジになります。次にトポロジカルソートし、startingPoints(どのリンクも入ってこないテーブル)を計算し、DAGフラグを保存します。(同じカテゴリにはストアベースのイニシャライザもあり、:69-93、モデルパスより前のもの。ビジュアライゼーションはモデルのものを使います。)MADQueryVisualizationViewController(MADQueryVisualizationViewController.m)は通知ストリームの主な消費者です。4つのモデル通知すべてを購読し(:314-335)、到着するたびにボックスとコネクタを追加/削除し、リンク削除後に-orphanedQueryTablesを使ってルートテーブルを再マークし(:936)、テーブルごとに-linksForQueryTable:を尋ね(:644)、識別子チェーンを歩いて各コネクタをレイアウトします(:1024-1048、§2.6)。MADQueryVisualizationCacheManagerはモデル識別子をキーにキャンバスレイアウトを永続化します(updateCacheWithQuery:…、MADQueryVisualizationCacheManager.h:20)。MADocument.documentModelが唯一の本番エントリポイントです。テスト: MADDocumentTests.m:263-265(再オープンしたドキュメントのdatabases/queries)、MADDocumentTests.m:399-404(MADModelDatabaseのテーブル/フィールド順)、加えて専用スイートMADModelQueryTableTests、MADModelQueryFieldTests、MADModelValueTypesTestsのMADModelField / MADModelQueryLinkカバレッジ。
MADQueryFullとRptq*+ExtrasクラスはRptqレイヤーで動作します(例えばRptqQueryField+Extras.m:137はRptqQueryTable.aliasからtable.field名を構築)。MADDesignerLayoutとレポートパスはRptqDocumentElementで動作します。MADReportFormatterはレイヤーをまったく使わず(MADReportFormatter.m:18-20の3つのMADModel*インポートは古い)、.maddbキャッシュに触れません。それはMADDataTableFast / MADReportFormatterの領域です。したがってレイヤーの今日の本当のスコープはデザイナのクエリ側だけです。
レイヤーは2017年初頭のもので(ファイルヘッダー1/22/17〜6/3/17)、Core Data時代にクエリUIのための手作りのビューモデルとして構築されました。デザイナのテーブルビューとビジュアライゼーションキャンバスがバインドできる軽量オブジェクトで、NSManagedObjectやNSFetchedResultsControllerの代わりです。証拠はファイルにあります。-objectID、MADModel.m:66-80のコメントアウトされたNSManagedObjectIDデバッグ記述、そして「was an NSFetchedResultsController」と述べる3つの生き残ったコメント(MADQueryChooseFieldController.m:149、MTGroupByViewController.m:53、MADTableViewControllerCoreDataResults.h:14)。
ストア移行(MAD_STORE_MIGRATION.mdのPhase C/D)はすべてのフェッチをCore DataからRptqStoreContext + objectsForEntity:へ再配線し、このレイヤーの表面を変えませんでした——MIGRATION_KICKOFF.md §Findingsがそれを「[a] clean MADModel* domain layer [that] already wraps the Rptq entities; it is the seam to keep.」と呼ぶ理由です。
つまりある種のMVCですが、「アプリのモデル」ではありません。ドキュメントごとの読み取りモデル(コントローラから見たMVCの「モデル」)で、正規ドメインオブジェクトはRptqグラフです。この抽象は3つのものを買い、それ以外では薄いものです。(1) 関係走査なしの表示形状のクエリグラフ(エイリアス、隣接性、IDからメタデータへのルックアップ)、(2) ストア変更通知をクエリグラフイベントに変換する唯一の場所、(3) 下のストアが完全に変わってもUIを変更せずに保てるインターフェース——まさに起こったことです。
直接読了。今日これらに消費者はないため、すべて潜在的です。
MADModelField.inTable(MADModelField.h:20)はweak MADModelField *と宣言されています——型が間違っており(MADModelTable *であるべき)——何も代入しません。MADModelTable.inDatabase、MADModelQueryTable.inQuery、MADModelQueryField.inQueryTableはツリー内のどのコードパスにも代入されません。MADModelQuery.inDatabaseだけが設定されます(MADModelQuery.m:108-114)。(-addField:schemaField:がフィールドのバックポインタを配線しないことはすでにBUGS.mdに記録されています。)MADModelDatabase -driverName(MADModelDatabase.m:184-215)はreturn @"";で終わるため、実際の名前をキャッシュした後でも空文字列と答えます。-schemaNameはすでに同じ場所から同じ文字列を返します。読み手は存在しません。MADModelDocument.m:228-234はドキュメントID(docID)をデコードし、決して使いません。MADModelQuery -update(MADModelQuery.m:354)は空で、MADModelDatabase -updateには呼び出し元がなく、+[MADModel newModelDocument:]にも呼び出し元がありません。MADModelTypeは未使用です。MADModelDocumentはストアコンテキストを弱く保持するため、ドキュメントより長く生きるモデルには何も解決するコンテキストがありません。MADModelDocumentはdatabasesを持ち、MADModelDatabaseはqueriesを持ちますが、ドキュメントはクエリごとに1つの「データベース」を構築し、今日それぞれ正確に1つです。構造は単一データベース/単一クエリの簡素化より前の将来対応です。リスクに対する価値の順。AとBは純粋な整理、Cは公開ヘッダーが約束するものを変え、Dは決定です。
A. 統合ではなく文書化。 最も安い明確化の勝利は、クラスごとのヘッダーコメント(2〜4行: クラスが何か、何をキーにするか、誰が読むか)とこのドキュメントです。クラスのファイルをマージするのは安い選択ではなく高価な選択です。16以上のファイルがクラスごとのヘッダーをインポートし(#import <MAD/MADModelQueryField.h>など)、各ヘッダーはXcodeターゲットの別ファイルで、Linuxビルドのincludeシムはヘッダーごとのシンボリックリンクのディレクトリです(Linux/README.md、MADのシム)。統合は見た目上の利益のためにpbxproj、Linuxソースリスト、すべてのインポートサイトに触れます。マージが望まれるなら、安全な方向は逆です。1クラス1ファイルを保ち、エントリポイントを明白にします(MADModel.hの先頭にドキュメント、「MADModelDocumentから始める」)。
B. 痕跡的な表面を削除または完成させる。 どれも振る舞い安全(何も読まない)ですがヘッダーに触れるため、API決定として扱ってください:
MADModelField.inTable: 型を修正しMADModelTable -updateで設定する(1行、他の親と対称)、またはプロパティを削除する。MADModelDatabase -driverName: 兄弟のようにキャッシュ値を返すか、削除する。MADModelType: ヘッダーを削除する。(プロジェクトファイルの削除が必要。1コミットで行う。)+[MADModel newModelDocument:]: MADocument -documentModelがそれを使うようにする(ファクトリの目的を復元)か、削除する。MADModelDocument.m:228-234の未使用docIDデコード。C. 宣言されたバックポインタを配線する。 inDatabase、inQuery、inQueryTableはグラフを上向きに歩けるように存在しますが、今日は下向きルックアップだけが機能します。構築時に代入すること(MADModelDatabase -updateTablesはすでにselfを持ち、insertTableRptqQueryTable:はモデルクエリを持ち、-addField:schemaField:はテーブルを持つ)はオブジェクトグラフをヘッダーに一致させ、まだ何も読まないからこそ安全です。心に留める意味論: それらはweakと宣言されており、下向きに所有される親には正しい。
D. リフレッシュをまたぐアイデンティティ(整理ではなく決定)。 -updateはオブジェクトを置き換えます。更新をまたぐ安定したアイデンティティが望まれるなら、更新メソッドは再構築ではなくその場で変更する(識別子に対してオブジェクトを再利用し、差分を追加/削除する)必要があります。それは渡されたオブジェクトの観測可能なアイデンティティを変えるため、意図的な選択が必要です。
E. 機械的重複排除。 MADModelTable.fieldsと-fieldIDs(MADModelTable.m:88-118)は同じ初期化ブロックを2回含み、MADModelQueryの3つのゲッターは同じ「コレクションを確実にし、次に更新する」ダンスを繰り返します(MADModelQuery.m:116-181)。どちらも振る舞い変更なしで各1つのプライベートヘルパーに折り畳めます。ファイルが他の理由で開かれたときにのみ行う価値があります。
F. 推奨しない: 名前変更。 MADModelDatabase → MADModelConnectionのような名前はより良く読めますが、ここでの名前変更はXcode/Linuxプロジェクトファイル全体の無駄な変更で、機能的な見返りがありません。
RptqQueryTable / RptqQueryLinks行を作成または削除するものは、MADModelDocumentのオブザーバが自動的に拾います——ただしfirstQueryを通じて到達される行だけです。ドキュメントの2つ目のクエリはミラーされません。MADNotification…名はUIのためのレイヤーの公開APIです。MADQueryVisualizationViewControllerがするように、firstQueryオブジェクトに対してそれらを観察してください。MADスキーム)と./Linux/build.shの両方がこれらのファイルをコンパイルします。Linux/cmake/MADSources.cmake参照。このページは英語原文の日本語翻訳です。内容に相違がある場合は、英語原文が優先されます。