Geometrie-Factory: koordinatenbasiert, optionaler Parameter mit globalem Default
Algorithmen erzeugen Ergebnisse über IGeometryFactory. Jeder Algorithmus nimmt sie als optionalen Parameter (IGeometryFactory? factory = null). Bei null greift er auf das statische SpatialNET.GeometryFactory.Default in Core zurück. Ist auch das nicht gesetzt, wirft er eine InvalidOperationException mit klarer Meldung. Es gibt bewusst keinen impliziten Default: Extensions hängt nur von Core ab, und ein stiller Fallback auf die Referenz-Implementierung würde fremde Objekte in einen Host schieben. Die Factory bekommt nur Koordinaten (readonly struct Coordinate(X, Y, Z = NaN)), keine Punkt-Objekte. So können keine Objekte verschiedener Hosts oder Implementierungen gemischt werden, und unveränderte Eingabepunkte müssen nicht neu erzeugt werden.
English version: 0004-geometrie-factory-koordinatenbasiert-optional-mit-default.md
Consequences
- Vertrag:
CreatePoint(Coordinate, source),CreateMultiPoint(ReadOnlySpan<Coordinate>, source),CreatePolyline(ReadOnlySpan<ReadOnlyMemory<Coordinate>>, source),CreatePolygon(ReadOnlySpan<PolygonPart>, source)undbool SupportsZ.PolygonPartist eine Teilfläche (Außenring plus Löcher, gültig, geschlossen, außen gegen den Uhrzeigersinn, ADR 0003). Rückgabe sind die SpatialNET-Interfaces, Host-Wrapper casten auf ihre Typen. - Factories sind thread-sicher bzw. zustandslos und dürfen übergebene Puffer nach dem Aufruf nicht mehr referenzieren.
sourceist die primäre Eingabe-Geometrie (odernull). Darüber übernimmt der Host Metadaten wie die Spatial Reference, ohne dass SpatialNET sie kennt.- Z: Bei
SupportsZ == falserechnet der Algorithmus rein 2D. Sonst liefert er Z, wenn die EingabepunkteIPoint3Dsind, und die Factory darf es verwerfen. Das ist nötig, weil gView/WebGIS immerIPoint3Dliefern. - Kein
CreateGeometryCollection: Ergebnisse sind dimensionshomogen. Leere Ergebnisse sind leere Geometrien (0 Teilflächen/Pfade/Punkte), nienull. Defaultist ein einfaches statisches Property, einmal beim Start gesetzt. Tests übergeben die Factory explizit. EinAsyncLocal-Scope lässt sich später ohne Bruch nachrüsten.
Considered Options
- Nur globale Registrierung (verworfen: Factory pro Aufruf nicht wählbar)
- Factory über die Eingabe-Geometrie (verworfen: neuer Interface-Member, widerspricht ADR 0002)
- Objekt-hierarchische Factory
CreatePath(IReadOnlyList<IPoint2D>)(verworfen: Mischobjekte, eine Allokation je Vertex) und Builder (verworfen: größerer, zustandsbehafteter Vertrag) - Generische Factory
IGeometryFactory<TPoint, …>(verworfen: vier Typparameter an jedem Algorithmus)