Ausgabemethode showMessageDialog

Im obigen Beispiel erfolgt die Ausgabe noch über die Konsole. Die Klasse

Methodenaufruf:

Wer die showMessageDialog-Methode mit der showInputDialog

-Methode

vergleicht, wird feststellen, dass abgesehen vom Namen nur der

Rückgabetyp anders ist. Dementsprechend laufen die Überlegungen zum

Methodenaufruf ähnlich ab:

1. Überprüfen, ob es sich um eine Klassenmethode handelt:

   Ist das Schlüsselwort static in der Methodendokumentation

   vorhanden?

   Bei dieser Methode: Ja, d.h. es ist eine Klassenmethode, damit hat

   der Aufruf die Struktur:

   Klassenname.Methodenname oder konkret: JOptionPane.showMessageDialog

2. Für jeden Formalparameter in der Methodendefinition muss ein

   Aktualparameter (= aktueller Wert) festgelegt werden:

   1. Erster Parameter: dieser ist vom Objekttyp Component

      (erkennbar am

      großen Anfangsbuchstaben). Hier geben wir den Wert

      null

      (ausgeschrieben, nicht

      die Ziffer 0), der bei Objekten als Ersatz für

      "nichts" verwendet wird, an. Das zeigt Java an, dass dieses Dialog-Fenster zu keiner größeren übergeordneten grafischen Oberfläche dazu gehört.

   2. Zweiter Parameter: Ebenfalls ein Objekttyp, der dafür steht, dass

      man irgendeine beliebige Nachricht als Objekt angegeben kann.

      Nachdem String ein Objektdatentyp ist, können auch Variablen

      oder Literale vom Typ String dafür verwendet werden, z.B:

      "Eingabe:" + eingabe

3. Überprüfen, ob eine Auffangvariable benötigt wird (Rückgabetyp ≠

   void) oder nicht (Rückgabetyp = void):
   Welchen Rückgabetyp hat die Methode?

   In dieser Methode:

   void, d.h. es wird keine Auffangvariable

   benötigt

Ergänze folgende Zusammenfassung:

• Die Methode für die grafikbasierten Ausgabedialoge ist in der Klasse definiert.

• Der Name der Methode für die grafikbasierten Ausgabedialoge lautet .

• Das Schlüsselwort in der API-Dokumentation dieser Methode zeigt an, dass es sich um eine

  Klassenmethode

  Objektmethode
  handelt.

• Klassenmethoden werden grundsätzlich mit . aufgerufen.

• Diese Methode wird daher konkret mit . aufgerufen.

• Für den ersten Parameter werden wir derzeit immer den Wert einsetzen, weil wir keine selbst programmierte grafische Oberfläche haben, mit der wir unseren Eingabedialog verbinden wollen.

• Als zweiter Parameter wird

  das Symbolbild im Eingabedialog

  der Titel in der Titelleiste des Eingabedialogs

  der Text der angezeigt werden soll
  angegeben.

• Diese Methode benötigt

  keine

  eine
  Auffangvariable, weil der Rückgabetyp in der Methodendokumentation
  void

  nicht void
  ist.

Methoden mit mehreren Parametern

Methoden können grundsätzlich mehrere Parameter haben. So kann z.B. die

Methode

Bei der Methodendefinition müssen dafür folgende Punkte beachtet werden:

• Die Parameter müssen durch Beistriche getrennt werden.

• Jeder Formalparameter benötigt einen eigenen Datentyp

  , auch wenn die

  Datentypen alle gleich sind.

• Jeder Parameter benötigt einen eindeutigen Namen (wie auch alle

  Variablen innerhalb der Methode einen eindeutigen Namen benötigen --

  Parameter gelten in diesem Zusammenhang als „innerhalb" der

  Methode).

• Für jeden Parameter muss eine eigene @param-Zeile

  im

  Dokumentationskommentar geschrieben werden

Im Code sieht das dann so aus:

Analysiere folgende Aufgabenstellung und beantworte die Fragen:

Definiere in der Klasse Texte eine Methode namens mehrfach. Diese Methode soll als ersten Parameter eine ganze Zahl haben. Diese Zahl gibt an, wie oft der Text, der im zweiten Parameter angegeben werden soll, ausgegeben werden soll. Die Ausgaben sollen nebeneinander ohne Abstand erfolgen. D.h. wenn im ersten Parameter die Zahl 4 und als Text na übergeben wird, dann soll der Text nananana ausgegeben werden.

• Welchen Namen hat die Klasse, in der die Methode geschrieben wird?

• Welchen Namen hat die Methode?

• Wieviele Parameter hat die Methode?

• Welche/n Datentyp/en hat/haben die Parameter? Achte auf die Reihenfolge und trenne mehrere Datentypen durch einen Beistrich

• Was für einen Rückgabetyp braucht die Methode?

Schreibe nun anhand der Informationen die Kopfzeile der Methode (ohne geschwungene Klammer) auf:

Kopiere oder merk dir die Kopfzeile für die nächste Frage

Methoden mit Parameter aufrufen

Auch im Quellcode müssen beim Aufruf die Parameter berücksichtigt werden. Wenn nun die Methode malReihe (die nun einen Parameter hat) genauso, wie die Methode malReihe5 (die Version ohne Parameter) aufgerufen wird, dann lässt sich das Programm nicht kompilieren.

Methoden brauchen für jeden definierten Formalparameter einen

passenden

Wert

Das bedeutet, dass wir nun der Methode "mitteilen" müssen, welche Mal-Reihe wir überhaupt haben wollen. Wir müssen die Methode entsprechend "konfigurieren". Dazu können wir z.B. direkt den Wert 5 verwenden, um genau die gleiche Mal-Reihe, wie bei der ursprünglichen Methode zu bekommen. Wir können uns das dann so vorstellen:

Der Aktualparameter kann entweder direkt ein Literal (ein Wert) sein

oder aber auch eine Variable, die ihren

Im Java-Quellcode sieht der Aufruf dann so aus:

Ergänze die folgende Zusammenfassung:

• Beim Aufruf der Methode muss jeder Variablen in der Formalparameterliste, ein passender gegeben werden.

• Da dieser Wert für diesen Aufruf der aktuelle Wert ist, wird dieser als bezeichnet.

• Wenn ein Formalparameter keinen Wert bekommt, z.B. weil die Klammern beim Aufruf leer gelassen werden, dann lässt sich das Programm nicht .

• Ein Wert ist dann passend, wenn der

  Datentyp

  Name

  Inhalt
  dieses Werts mit dem
  Datentyp

  Inhalt

  Name
  des Formalparameters in der Definition übereinstimmt.

• Anstelle eines Wertes (Literals) kann auch eine als Aktualparameter verwendet werden.

• Diese Variable muss zum Zeitpunkt des Aufrufs bereits einen haben

• Der Wert der Variablen wird dann beim Aufruf in die Variable des Formalparameters .

• Auch hier muss der

  Inhalt

  Name

  Datentyp
  der Aktualparameter-Variablen mit dem
  Name

  Inhalt

  Datentyp
  des Formalparameters in der Definition übereinstimmen.

• Eine Methode kann öfters mit verschiedenen aufgerufen werden.

Methoden mit Parameter in BlueJ ausprobieren

Auch Methoden mit Parametern können direkt in BlueJ ausprobiert werden.

Allerdings ist eine zusätzliche Eingabe erforderlich. Die Methode muss

wissen, welchen Wert der Parameter haben soll. Dazu muss ein passendes

Literal angegeben werden, d.h. für einen int-Parameter eine ganze Zahl,

für einen double-Parameter eine Zahl mit Dezimalpunkt, für einen

String-Parameter eine Buchstabenkette unter Anführungszeichen, usw.

Ein Leerlassen des Feldes für den Aktualparameter ist nicht möglich! Die

Methode benötigt schließlich einen konkreten (d.h. aktuellen) Wert,

sonst kann sie ihre Arbeit nicht machen.

Löse die folgende Aufgabenstellung:

Füge den Code der vorherigen Methode soSuper in BlueJ ein und rufe diese Methode einmal auf. Vergiss nicht, diese Methode innerhalb einer Klasse zu schreiben. Du kannst auch die vorherige Methode soSuper aus der Klasse Super ersetzen.

malReihe mit Parameter

Wenn wir nun in der Methode malReihe

einen Parameter einführen, wollen wir eine "Hilfsmaschine" bauen, die

einen Einlasstrichter für einen Konfigurationswert (den "Malwert") hat:

Dies wird erreicht, in dem die Variable malwert

zu einem Parameter,

genauer gesagt einem

Zugriffsmodifikatoren Rückgabetyp Methodenname

Der Parameter in der Methodenkopfzeile ist ein Formalparameter

, da

er wie bei einer Formel als Platzhalter eingesetzt wird. Jeder Datentyp

kann für einen Parameter verwendet werden. Der Datentyp muss nur zum

Verwendungszweck passen und die entsprechende Zusatzinformation beim

Aufruf speichern können. Der Parameter bekommt

Parameter können dann in der Methode wie jede andere Variable verwendet

werden, so als ob sie schon einen Wert hätten. Sie

Im Dokumentationskommentar

werden Parameter nach der allgemeinen

Beschreibung mit einem

Ergänze die folgende Zusammenfassung:

• Bei der Methodendefinition werden Parameter in der der Methode angegeben.

• Sie werden innerhalb der Klammern geschrieben.

• Die Parameter sind Variablen, die in diesen runden Klammern (erzeugt) werden.

• Ihren Wert bekommen diese Parameter

  außerhalb

  innerhalb
  der Methode.

• Die Parametervariablen selbst sind trotzdem nur

  innerhalb

  außerhalb
  der Methode verfügbar. Sie werden (wie andere Variablen in der Methode) am Ende gelöscht.

• Die Parameter bei der Methodendefinition werden auch als bezeichnet.

• Im Dokumentationskommentar zu der Methode werden Parameter mit Hilfe des

  @version

  @param

  @argument

  @author
  -Tag angegeben.

• Nach dem Tag kommt der des Parameters gefolgt von der Beschreibung.

• Die Tags

  @version

  @author

  @argument

  @param
  und
  @version

  @author

  @argument

  @param
  (in alphabetischer Reihenfolge angeben!) dürfen im Dokumentationskommentar zu einer Methode vorkommen.

Klassenmethoden mit Parametern schreiben

Es ist wichtig Methoden nicht nur für einzelne spezielle Aufgaben zu schreiben, sondern "konfigurierbar" zu machen. Damit können Methoden flexibler gestaltet und öfter wieder verwendet werden. Dies kann mit Hilfe von Parametern (auch als Argumente bezeichnet) geschehen. Mit diesen kann man einer Methode zusätzliche Informationen mitgeben. Zum Beispiel wird Methode schreib im Hamster-Programm der Text, der angezeigt werden soll, mitgegeben.:

Ergänze die folgende Zusammenfassung:

• Mit kann eine Methode flexibler gestaltet werden.

• Ein anderer Name für Parameter ist auch .

• Diese Zusatzinformationen beim Aufruf wird speziell parameter genannt.

Gültigkeit von Variablen in Methoden

Ein häufiges Missverständnis entsteht, wenn man Variablen in den einzelnen Methoden betrachtet. Jede Methode hat einen eigenen Block und ist damit ein ganz eigener Gültigkeitsbereich. Man kann es sich vorstellen, als ob jede Methode eine in sich abgeschlossene Box ist, bei der nur der Methoden-Name sichtbar ist. So kann weder die main-Methode noch eine andere Methode in die Methode malReihe5 "hinein schauen". Die main-Methode und jede andere Methode, die die Methode malReihe5 verwendet, verlässt sich darauf, dass diese Methode ihre Arbeit erledigt – wie sie das macht ist den aufrufenden Methoden egal. Auch die Methode malReihe5 hat keinerlei Informationen darüber, was in der main-Methode oder den anderen aufrufenden Methoden passiert. Sie macht einfach ihren Job, wenn sie aufgerufen wird.

Dies ist insbesondere für Variablen wichtig. Variablen die innerhalb eines Blocks (das gilt auch für Schleifen oder andere Kontrollstrukturen) deklariert werden, sind auch nur innerhalb dieses Blocks gültig und damit verfügbar.

Wenn die zweite Methode (mR5MitTitel) selbst eine Variable mit dem Namen zaehler deklariert, dann wäre die zweite Variable auch komplett unabhängig von der zaehler-Variable aus der Methode malReihe5. Diese zweite zaehler-Variable hätte nur "zufällig" den gleichen Namen, wie die Variable aus der ersten Methode.

Ergänze die folgende Zusammenfassung:

• Jeder Block (auch der von Methoden) bildet einen eigenen .

• Eine Methode kann den Inhalt einer anderen Methode

  immer

  nicht

  manchmal
  sehen.

• Insbesondere Variablen sind nur innerhalb des Blocks, in dem sie deklariert wurden (= verfügbar bzw. verwendbar).

• Mit dem Ende des Blocks werden die Variablen

  auf die Festplatte gespeichert

  aus dem Arbeitsspeicher gelöscht

  im Arbeitsspeicher gespeichert

• Ein Block wird durch das Zeichen beendet.

• Deshalb kann eine Methode die Variablen einer anderen Methode

  immer

  manchmal

  nicht
  sehen. Damit kann die Methode die Variablen einer anderen Methode auch
  manchmal

  nicht

  immer
  verwenden.

• Wenn zwei Methoden Variablen mit dem selben Namen deklarieren, dann sind diese beiden Variablen

  miteinander verbunden

  ungültig und lassen sich nicht kompilieren

  komplett unabhängig voneinander
  .

Dokumentationsansicht

Die Dokumentationskommentare

vor der Klassen- bzw. Methodenkopfzeile

werden geschrieben, um mit Hilfe des javadoc-Tools eine

Dadurch ruft BlueJ eine interne Version des Programms javadoc

auf, das

aus den Dokumentationskommentaren eine HTML-Seite generiert. Diese ist

so formatiert, wie die offizielle Java-API-Dokumentation (diese wurde

mit dem selben Tool erstellt).

Nach den Angaben im Klassenkommentar wird die Kurzbeschreibung aller

Methoden aufgelistet.

Weiter unten folgt noch zu jeder Methode eine Detailbeschreibung, wo

auch die komplette Methodenkopfzeile sowie der vollständige

Beschreibungstext angegeben ist.

Ergänze die folgende Zusammenfassung:

• Durch das Umschalten von Quellcode auf Dokumentationsansicht wird das Programm (Tool) ausgeführt.

• Dieses Programm erzeugt aus den Dokumentationskommentaren eine -Seite

• Die Formatierung ist die selbe, wie bei der offiziellen Java--Dokumentation

• Nach dem Namen und der Kopfzeile der Klasse folgt die allgemeine Beschreibung. Anschließend stehen die Information aus dem

  @version

  @author

  @date

  @description
  -Tag gefolgt von der Information aus dem
  @version

  @author

  @date

  @description
  -Tag.

• Darauf folgt die Kurzbeschreibung aller .

• In der Detailbeschreibung zu jeder Methode steht die sowie der vollständige Beschreibungstext.

Methode in BlueJ direkt ausprobieren

In BlueJ ist es möglich, Methoden auch direkt (ohne main-Methode) auszuprobieren. Dazu muss die Klasse in BlueJ erstellt und mit den Methoden kompiliert werden. Danach kann mit einem Rechtsklick die Methode einfach ausgewählt werden. Dies veranlasst BlueJ diese Methode auszuführen.

Löse die folgende Aufgabe:

Füge den Code der vorherigen Klasse Super in BlueJ ein und rufe jede Methode einmal auf.

Methodenkörper

Die Kopfzeile einer Methodendefinition wird durch eine öffnende

geschwungene Klammer abgeschlossen und es beginnt der Methodenkörper.

Dieser kann beliebige Anweisungen enthalten, die das Innenleben der

"Hilfsmaschine" darstellen, z.B.:

• Variablendeklarationen und -initialisierungen: diese

  lokalen

  Variablen

  sind nur innerhalb der Methode sichtbar

  und damit

  verfügbar. Andere Methoden können diese nicht sehen. Wenn in einer

  anderen Methode eine Variable mit dem gleichen Namen deklariert

  wird, dann gibt es eben 2 unterschiedliche Variablen, die eben in

  diesem Fall den gleichen Namen haben.

• Ausdrücke mit Rechnungen etc.

• Programmstrukturen wie Schleifen und Verzweigungen

• Aufrufe von (anderen) Methoden

• ...

Ergänze die folgende Zusammenfassung:

• eine Variable wird innerhalb des Methodenkörpers deklariert und initialisiert.

• lokale Variablen sind nur in der Methode , in der sie erstellt wurden.

• Grundsätzlich kann ein Methodenkörper folgende Elemente enthalten (kreuze nur jene Elemente an, die tatsächlich im Methodenkörper vorkommen können.

  eine Rechnung, z.B. zahl = zahl*2;
  eine Klassenkopfzeile
  die Kopfzeile der main-Methode
  eine Variablendeklaration, z.B. int zahl;
  eine Variableninitialisierung, z.B. zahl = 3;
  den Aufruf einer anderen Methode
  eine Schleife und/oder eine if-Verzweigung
  die Definition einer anderen Methode