SWE: 5. Juli - 9. Juli 2021 (Mm, BWM, ROB, BAI, BGIP, BBWL, BBL, MGIN)
Das Aufgabenblatt ist der Implementierung einer generischen Collection am Beispiel der Klasse Set
gewidmet. Die Methoden der Klasse sind außerdem mit Hilfe des Test-Frameworks xUnit
zu testen.
Schätzen Sie der Aufwand zur Lösung der Aufgaben im Voraus ab und teilen Sie die Aufgaben gleichmäßig untereinander auf. Verwenden Sie zur Organisation der Zusammenarbeit die GitHub-Features.
Organisieren Sie beide Projekte, die zu testende Klassenbibliothek und das Test-Projekt, in einer Solution.
Erstellen Sie die generische Klasse Set
zum Verwalten von Elementen einer Menge. Sinnvoll ist es, gleich zu Beginn eine Solution zu erstellen, die ein classlib-Projekt enthält (oder - wenn Sie die Klasse erst "manuell" testen wollen - ein ausführbares Projekt, das später in ein classlib-Projekt geändert wird). Dieser Solution kann dann ein Unittest-Projekt hinzugefügt werden.
Sie können dazu die dotnet-Kommandos nutzen, z.B.:
dotnet new sln -o unittesting
dotnet new classlib -o SetCollectionLib
(im Verzeichnis unittesting)dotnet sln add SetCollectionLib/SetCollectionLib.csproj
Die Klasse soll die Properties und Methoden des Interfaces ICollection<T>
implementieren:
Properties:
-
int Count
gibt die Anzahl der Elemente an, die in der Collection enthalten sind. -
bool IsReadOnly
gibt an, ob die Collection schreibgeschützt ist.
Methoden:
-
void Add(T)
fügt der Collection ein Element hinzu. -
bool Remove(T)
entfernt das erste Vorkommen eines angegebenen Objekts aus der Collection. -
void Clear()
entfernt alle Elemente aus der Collection. -
bool Contains(T)
ermittelt, ob die Collection einen bestimmten Wert enthält. -
void CopyTo(T[], Int32)
kopiert die Elemente der Collection in ein Array, beginnend bei einem bestimmten Array-Index. -
IEnumerator<T> GetEnumerator()
gibt einen generischen Enumerator zurück, der die Collection durchläuft. -
IEnumerator GetEnumerator()
gibt einen nichtgenerischen Enumerator zurück, der die Collection durchläuft.
Verwenden Sie in der Klasse zum Speichern der Elemente ein privates Feld vom Typ List<T>
. Definieren Sie außerdem zum Verwalten von Elementen die angegebenen bzw. weitere sinnvolle Methoden. Nutzen Sie in den Methoden der Klasse die von der Klasse List
zur Verfügung stehenden Properties und Methoden: Count
, Contains
, Add
, CopyTo
, Remove
. Beachten Sie beim Implementieren der Methoden, dass alle Elemente einer Menge unterschiedlich sein müssen.
Hinweise zu GetEnumerator()
:
-
Für die generische
GetEnumerator()
-Methode bietet sich die Verwendung deryield return
-Anweisung an. -
Die nichtgenerische
IEnumerable.GetEnumerator()
-Methode ist "historisch gewachsen" und wird nicht mehr verwendet, muss aber trotzdem implementiert werden. Im einfachsten Fall delegieren Sie sie an die generische Version (siehe auch: implizite vs. explzite Interface-Implementierung):
System.Collections.IEnumerator System.Collections.IEnumerable.GetEnumerator() => GetEnumerator();
Definieren Sie in der Klasse weitere Properties und Methoden, z.B.:
Cardinality
, IsEmpty
, IsSubsetOf()
, Intersection()
, Union()
a)
Erstellen Sie ein weiteres Projekt zum Testen Ihrer Klassenbibliothek und fügen Sie das Projekt der Solution hinzu, z.B. mit den folgenden dotnet-Kommandos:
dotnet new xunit -o SetCollectionLib.Tests
dotnet sln add SetCollectionLib.Tests/SetCollectionLib.Tests.csproj
Fügen Sie die Klassenbibliothek anschließend dem Test-Projekt als Abhängigkeit hinzu:
dotnet add SetCollectionLib.Tests/SetCollectionLib.Tests.csproj reference SetCollectionLib/SetCollectionLib.csproj
Erstellen Sie in der Test-Klasse für alle Methoden der Klasse Set
jeweilige Testmethoden und führen Sie die Tests mit dotnet test
aus. Verwenden Sie in den Testmethoden unterschiedliche Datentypen für die Elemente der Collection (z.B. int
und double
).
Nutzen Sie in den Testmethoden die Methoden der Klasse Assert
wie Assert.True
und Assert.False
und die speziellen Collection-Methoden, wie z.B. Assert.Empty
, Assert.Equal<T>
, Assert.Contains
, Assert.DoesNotContain
etc.
Verwenden Sie, wo es sinnvoll ist, statt der einzelnen Tests mit dem Attribut [Fact]
die Testreihen mit Theory
und InlineData
.
b)
Erstellen Sie einige Tests (z.B. für die Methoden Intersection
und Union
) mit den Objekten einer selbst definierten Klasse.
Geeignet wäre z.B. die "Stöckchen-Zahlen"-Klasse (s. Aufgabe 5.2), Sie können aber auch eine weitere Klasse dazu definieren. Testen Sie ebenfalls die Methoden dieser Klasse, in der "Stöckchen-Zahlen"-Klasse z.B. die überladenen Operatoren.
https://docs.microsoft.com/de-de/dotnet/core/testing/unit-testing-with-dotnet-test