Mitglied seit: 06.04.2005
Forenbeiträge: 687
Besuche: 668
Guten Tag
Allerdings reicht es nicht immer und zweiseitige Methodennamen sind dann auch ein bisschen unhandlich ^^.
Ich gehe mal davon aus, dass wir von objektorientierter Programmierung sprechen. Ein Methodenname kann also mehrfach überladen sein.
Nehmen wir an, wir haben folgende Codestruktur:
[command]
class Customer
{
//Fügt den Artikel x einem Kunden hinzu
void addArticle (int x) {
...
}
//Fügt dem Kunden einen Mietbetrag hinzu
void addRental (long x) {
...
}
}
[/command]
In der obigen Form sind beide Kommentare notwendig. Ohne sie wissen wir nicht genau was 'x' darstellt. An dieser scheinbar einfachen Klasse jedoch ist einiges falsch, was ich nachfolgend schrittweise begründen werde. Wir werden sehen, dass bei einem sauberen Design solche Kommentare überflüssig werden.
Zunächst einmal ändern wir x in einen sinnvollen Bezeichner:
[command]
class Customer
{
//Fügt den Artikel article einem Kunden hinzu
void addArticle (int article) {
...
}
//Fügt dem Kunden einen Mietbetrag rental hinzu
void addRental (long rental) {
...
}
}
[/command]
An dieser Stelle können wir uns überlegen, ob die Klasse Customer überhaupt den Datentyp für die Artikelnummer und denjenigen für die Miete kennen muss. Wenn wir davon ausgehen, dass zu einem späteren Zeitpunkt die Artikelnummer durch einen String ersetzt werden könnte, müssten wir unseren Code an dieser Stelle anpassen. Also erstellen wir eine unabhängige Klasse, welche die notwendigen Datenstrukturen und die Methoden zum Zugriff enthält.
[command]
class Customer
{
void addArticle (Article article) {
...
}
void addRental (Rental rental) {
...
}
}
[/command]
Ab diesem Zeitpunkt werden die Kommentare überflüssig und wir lassen sie weg. Wenn nun jedoch der Parameter bereits die Information darüber enthält, was die Methode verarbeitet, ist diese Information im Methodenname redundant und kann entfernt werden:
[command]
class Customer
{
void add (Article article) {
...
}
void add (Rental rental) {
...
}
}
[/command]
Wir haben dadurch keinen Informationsverlust erlitten.
Wenn nun ein Customer sowohl die Ausleihe wie die Artikel kennt, muss dieser diese intern verknüpfen. In diesem Fall verletzen wir das [[GRASP]] Pattern 'High Cohesion' welches besagt, dass eine Einheit (Methode oder Klasse) nur genau das tun sollte, was sie tun muss und nicht mehr. Wir stellen fest, dass die Klasse Customer nichts von einer Miete wissen muss und entfernen diese aus der Klasse.
[command]
class Customer
{
void add (Article article) {
...
}
}
[/command]
Wir gehen nun davon aus, dass die Klasse Rental den Betrag der Miete berechnen soll und fügen deshalb der Klasse Customer eine Methode hinzu, welche die dem Kunden zugewiesene Artikel zurück gibt:
[command]
class Customer
{
void add (Article article) {
...
}
List<Article> get () {
...
}
}
[/command]
Die Klasse Rental:
[command]
class Rental
{
Customer customer;
Summary calculate ()
{
...
List<Article> articles Customer.get ();
...
}
}
[/command]
Mit diesen Schritten sind wir von einem mieserablen Design zu einem gelangt, das den Anforderungen der objektorientierten Programmierung genügt (über alles andere kann man sich streiten).
An das "weshalb" hab ich bis jetzt noch nicht gedacht, obwohl es ja für spätere Untersuchungen des Codes sehr hilfreich wäre.
Dokumentation ist eben für den Programmierer, und nicht für den Kunden :-)
hth
Marco