Wie lassen sich Dateien, die gleichnamige generische Klassen enthalten, am besten strukturieren und benennen?

In meinem aktuellen Projekt bin ich auf die Anforderung gestoßen, generische Klassen mit demselben Namen, aber unterschiedlicher Anzahl von generischen Parametern zu erstellen. Beispielsweise:

MyClass<T1>
MyClass<T1, T2>
MyClass<T1, T2, T3>

Da ich alle im selben Namespace haben möchte, bin ich nicht sicher, wie ich meine Klassen und Dateien strukturieren und benennen soll.

Wenn wir der Idee folgen, dass wir Klassen auf eine pro Datei beschränken sollten und dass sich Dateien in einer Ordnerstruktur befinden sollten, die die Namespace-Hierarchie darstellt, und dass der Name der Datei mit dem Namen der Klasse übereinstimmen sollte, wie gehe ich mit dieser Situation um ?

Was ich hier wirklich frage, ist, wie soll ich die Datei benennen, die enthält MyClass<T1>, und wie soll ich die Datei benennen, die enthält MyClass<T1, T2>? Ich frage nicht, wie die Namen der Typparameter sein sollten.

MyGenericClass`1.cs
MyGenericClass`2.cs
MyGenericClass`3.cs

Und so weiter, wobei die Zahl nach dem Backtick die Anzahl der generischen Typparameter ist. Diese Konvention wird von Microsoft verwendet.

Alternativ können Sie auch so etwas verwenden

MyGenericCollectionClass[TKey, TValue].cs

Dabei bleibt nicht nur die Anzahl der generischen Typparameter erhalten, sondern auch deren spezifische Namen. Zugegeben, es bewahrt nicht die spitzen Klammern, aber wir können nicht alles im Leben haben, was wir wollen, oder?

Im Fall von Tupleund Action, die Pete erwähnt hat, verwendet Microsoft selbst eine einzige Datei - siehe Tuple.cs und Action.cs .

Ich denke, es hängt zum Teil davon ab, ob die Funktionalität für alle Klassen grundsätzlich gleich ist oder nicht. Ich persönlich mag es nicht, Klassen in einer einzelnen Datei zusammenzufassen, aber dies könnte eine Ausnahme sein. In dem Quellcode, in dem ich arbeite, habe ich eine automatisch generierte NamedTupleKlasse (unter Verwendung von T4) hinzugefügt, die genauso funktioniert wie Tuple, aber einen String-Namen als erstes Argument in den Konstruktor einfügt.

Um Ihre Frage zu beantworten, wenn Sie keine einzige Datei verwenden möchten MyClass<T1>, verwenden Sie möglicherweise MyClass_1.cs für , MyClass_2.cs für MyClass<T1, T2>usw.

Keine der beiden Optionen ist jedoch ideal, weshalb ich das Argument "Microsoft macht es so, also ..." vorschlagen möchte.

Hast du dich gefragt, ob die Klassen wirklich die gleiche Absicht haben? Wenn eine Klasse generischer als die andere ist, handelt es sich um eine GenericClass , eine MoreGenericClass und eine MostGenericClass . Stellen Sie sich vor, jeder Typparameter einer Klasse fügt der Klasse eine neue Dimension hinzu. Daher kann es hilfreich sein, zu fragen, um welche Dimension es sich handelt.

Nehmen wir dieses Beispiel:

• Container<Thing>
• MetricContainer<Thing, Metric>
• MetricTransportableContainer<Thing, Metric, Transport>

Mir ist bewusst, dass es nicht das beste Beispiel ist, aber es ist sehr aussagekräftig, drei Dimensionen zu zeigen:

• innere Dimension, was es laden kann
• metrisch Dimension, mit welcher Metrik es geladen werden kann, nur nach Anzahl der Dinge oder nach Quadratmaß oder nach Hubraum oder nach Gewicht
• äußere Dimension, wo es geladen werden kann.

So können Sie den Transport von Autos modellieren:

Container<Cars>
MetricContainer<Cars, CountMetric>
MetricTransportableContainer<Cars, CountMetric, Ship>

Transport von Flüssigkeiten:

Container<Fluid>
MetricContainer<Fluid, Volume>
MetricTransportableContainer<Fluid, Volume, Shelf>

Transport von Energie:

Container<Energy>
MetricContainer<Energy, ElectricPower>
MetricTransportableContainer<Energy, ElectricPower, Box>

Transport von Zucker, Getreide:

Container<CrumblyMaterial>
MetricContainer<CrumblyMaterial, Weight>
MetricTransportableContainer<CrumblyMaterial, Weight, Silo>

Oh, was für eine Überraschung: a List<T>hat eine Dimension, die die Dinge repräsentiert, die die Liste enthalten kann; und dies ist eine Map<T, S>zweidimensionale Karte, die die Dinge darstellt, die die Karte enthalten kann, und die Zugriffstasten.