Zyklusschutz

Worum es geht

Beziehungen zeigen in beide Richtungen: Die Firma kennt ihre Mitarbeiter, jeder Mitarbeiter kennt seine Firma. Folgt ein Programm blind allen Beziehungen, läuft es im Kreis: Firma → Mitarbeiter → Firma → Mitarbeiter … Das nennt man einen Zyklus.

flowchart LR
    A["Firma"] -->|employees| B["Mitarbeiter"]
    B -->|company| A
    B -.->|"hier hört CDMS auf"| X(("■"))

Beim Lesen: die response ist die Grenze

CDMS folgt einer Beziehung nur, wenn du sie in der response ausbaust. Jede Ebene musst du selbst hinschreiben. Weil deine response endlich ist, ist es auch die Antwort.

POST /api/rest/group/read/a1…
{
  "response": ["name",
    { "field": "children", "response": ["name",
      { "field": "parent", "response": ["name",
        { "field": "children", "response": ["name"] }
      ] }
    ] }
  ]
}

{
  "data": {
    "name": "A",
    "children": [
      { "name": "B",
        "parent": {
          "name": "A",
          "children": [ { "name": "B", "children": null, "parent": null } ]
        }
      }
    ]
  },
  "meta": { "error": false }
}

Du siehst: A und B kommen mehrfach vor. CDMS fasst sie nicht zusammen, sondern liefert jede Ebene so, wie du sie angefordert hast. Auf der letzten Ebene stehen children und parent als null, weil du sie dort nicht mehr angefordert hast.

Mehr zum Ausbauen unter Referenzen und Listen ausbauen.

Beim Schreiben: Rückreferenz und jedes Objekt einmal

Auch beim verschachtelten Schreiben könnte CDMS im Kreis laufen: Die Firma schreibt ihre Mitarbeiter, jeder Mitarbeiter hat ein Feld company, das wieder auf die Firma zeigt. Zwei Regeln verhindern das:

1. Die Rückreferenz wird nicht verfolgt. Von einem Kind aus geht CDMS nicht zurück zum Elternobjekt, sondern setzt die Verbindung von oben. Steht im Kind trotzdem eine Rückreferenz, gewinnt das Elternobjekt. Siehe Beide Seiten einer Beziehung.
2. Jedes Objekt des Requests wird nur einmal verarbeitet. CDMS markiert dafür intern, welche Objekte es schon bearbeitet hat. Die Markierung steht im internen Feld _reference.

Das Feld _reference

_reference ist ein interner Merker, den CDMS nur während der Verarbeitung eines Requests benutzt. In Leseantworten steht er als "_reference": null.

Der Merker gehört dem Server. Schickst du ein gelesenes Objekt zurück, stört das _reference darin nicht – CDMS nimmt es nicht an. Es zählt also nur, was CDMS während der Verarbeitung selbst setzt.

Fallen

Wie es weitergeht

• Referenzen lesen: Referenzen und Listen ausbauen
• Gegenseite beim Schreiben: Beide Seiten einer Beziehung
• Systemfelder: Systemfelder, die der Server setzt