MAD Designer iconMAD

MADModel — ドキュメント読み取りモデルレイヤー

このページでは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のリファクタリング候補は提案であり、適用されていません。


1. レイヤーとは何か

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)

2. クラス

2.1 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参照)。

2.2 MADModelDocument — ルート(MADModelDocument.h、.m)

2.3 MADModelDatabase — 接続、スキーマ、クエリ(MADModelDatabase.h、.m)

2.4 MADModelTable / MADModelField — スキーマ(MADModelTable.{h,m}、MADModelField.h)

2.5 MADModelQuery — 1つのクエリ(MADModelQuery.h、.m)

最大のクラスで、実際にその価値を発揮するものです。所有するもの:

2.6 MADModelQueryTable / MADModelQueryField — クエリのテーブルとフィールド

2.8 プロトコルと痕跡的な部分

3. ライフサイクル

3.1 作成

MADocumentはMADModelDocumentを1つ遅延構築し(MADocument.m:389-395)、ドキュメントの寿命まで保持します。RptqStoreContextを弱く保持します(MADModelDocument.m:42)。コンテキストを保持するすべてのモデルオブジェクトと同様で、ストアコンテキストはドキュメントが所有します。

3.2 人口

ドキュメントより下のすべては遅延かつキャッシュされます。databases、tables、fields、queryTableIDs、queryFields、linksの最初の読み取りがフェッチ・アンド・フィルタパスをトリガーします(関連するRptqエンティティに対するobjectsForEntity:、親の識別子でフィルタし、移行前のフェッチがソートした場所でソート)。キャッシュは-updateを呼ぶか下の通知パスによってのみ無効化され、何も自然に期限切れになりません。

3.3 ライブ変更 — ラウンドトリップ

デザイナでテーブルやリンクを追加すると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)で変更し、通知はメインキューで到着します。コレクション自体は同期されません。

3.4 陳腐化

-update(ドキュメントまたはデータベース)は新しいモデルオブジェクトでコレクションを再構築します。以前に渡されたモデルオブジェクトはキャッシュしたものについては動作し続けますが、firstQuery.tablesにあるものではなくなります。ツリー内で今日モデルオブジェクトの-updateを呼ぶものはなく(通知パスがライブのもの)、-updateをまたいでモデルオブジェクトを保存するコードは古いエントリを読むことになります。

4. 消費者

4.1 Queryタブ(アドホッククエリビルダ)

4.2 Query Visualizationタブ(ボックスとコネクタ)

4.3 ドキュメントとテスト

MADocument.documentModelが唯一の本番エントリポイントです。テスト: MADDocumentTests.m:263-265(再オープンしたドキュメントのdatabases/queries)、MADDocumentTests.m:399-404(MADModelDatabaseのテーブル/フィールド順)、加えて専用スイートMADModelQueryTableTests、MADModelQueryFieldTests、MADModelValueTypesTestsのMADModelField / MADModelQueryLinkカバレッジ。

4.4 使わないもの

したがってレイヤーの今日の本当のスコープはデザイナのクエリ側だけです。

5. なぜ存在するのか

レイヤーは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を変更せずに保てるインターフェース——まさに起こったことです。

6. 既知の粗いエッジ

直接読了。今日これらに消費者はないため、すべて潜在的です。

  1. MADModelField.inTable(MADModelField.h:20)はweak MADModelField *と宣言されています——型が間違っており(MADModelTable *であるべき)——何も代入しません。
  2. 他の親バックポインタも同様に未使用です。MADModelTable.inDatabase、MADModelQueryTable.inQuery、MADModelQueryField.inQueryTableはツリー内のどのコードパスにも代入されません。MADModelQuery.inDatabaseだけが設定されます(MADModelQuery.m:108-114)。(-addField:schemaField:がフィールドのバックポインタを配線しないことはすでにBUGS.mdに記録されています。)
  3. MADModelDatabase -driverName(MADModelDatabase.m:184-215)はreturn @"";で終わるため、実際の名前をキャッシュした後でも空文字列と答えます。-schemaNameはすでに同じ場所から同じ文字列を返します。読み手は存在しません。
  4. MADModelDocument.m:228-234はドキュメントID(docID)をデコードし、決して使いません。
  5. MADModelQuery -update(MADModelQuery.m:354)は空で、MADModelDatabase -updateには呼び出し元がなく、+[MADModel newModelDocument:]にも呼び出し元がありません。
  6. MADModelTypeは未使用です。
  7. モデルを変更するプライベートキューとメインスレッドの読み手の間に同期がなく、MADModelDocumentはストアコンテキストを弱く保持するため、ドキュメントより長く生きるモデルには何も解決するコンテキストがありません。
  8. 命名: MADModelDocumentはdatabasesを持ち、MADModelDatabaseはqueriesを持ちますが、ドキュメントはクエリごとに1つの「データベース」を構築し、今日それぞれ正確に1つです。構造は単一データベース/単一クエリの簡素化より前の将来対応です。

7. リファクタリング候補(提案——適用なし)

リスクに対する価値の順。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決定として扱ってください:

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プロジェクトファイル全体の無駄な変更で、機能的な見返りがありません。

8. このレイヤーを変更するなら

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