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

  Objektmethode

  Klassenmethode
  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 Text der angezeigt werden soll

  der Titel in der Titelleiste des Eingabedialogs
  angegeben.

• Diese Methode benötigt

  eine

  keine
  Auffangvariable, weil der Rückgabetyp in der Methodendokumentation
  nicht void

  void
  ist.

Eingabemethode showInputDialog

Für die grafikbasierte Eingabe wird die Klassenmethode showInputDialog

der Klasse

In der API-Dokumentation ist die Methode showInputDialog

folgendermaßen

angegeben:

Methodenaufruf:

Um die Methode showInputDialog

zu verwenden müssen die selben Punkte

nacheinander überlegt werden, wie bei selbstgeschriebenen Methoden.

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.showInputDialog

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 kann man angeben zu welcher

      grafischen Oberflächenkomponente der Eingabedialog dazu gehört.

      Nachdem wir erst viel, viel später grafische Oberflächen

      verwenden, kann derzeit der Wert

      null

      (ausgeschrieben, nicht

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

      "nichts" verwendet wird.

   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 bitte:"

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

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

   Bei dieser Methode:

   String

   , d.h. es wird eine Auffangvariable vom

   Typ

   String benötigt.

Ergänze folgende Zusammenfassung:

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

• Der Name der Methode für die grafikbasierten Eingabedialoge 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

  der Text der angezeigt werden soll

  der Titel in der Titelleiste des Eingabedialogs

  das Symbolbild im Eingabedialog
  angegeben.

• Diese Methode benötigt

  eine

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

  nicht void
  ist.

• Der Rückgabetyp der Methode ist , deshalb muss auch die Auffangvariable den Typ haben.

Die Klassenansicht

Die Java-API besteht aus sehr vielen Klassen, die zur besseren Übersicht

in der Klassenliste alphabetisch aufgelistet sind. Die Klasse mit den

Eingabe-Methoden heißt JOptionPane. Den Aufbau der Klasse JOptionPane

kann man sich durch Anklicken des Klassennamens anzeigen lassen. Die

Klassenansicht im Hauptbereich gliedert sich auch wieder in einzelne

Teile:

... und ein gutes Stück weiter unten ...

• Paketname

  : Der Paketname ist wichtig, um die Klasse im Programm

  importieren zu können. Jede Klasse, die nicht im Standard-Paket von

  Java

  java.lang und nicht im eigenen Paket ist, muss mit

  import

  Paketname.Klassenname; importiert werden.

• Klassenname

  : Klassenmethoden müssen über den Klassennamen aufgerufen

  werden

• Vererbungshierarchie: von welchen Klassen ist diese Klasse

  abgeleitet und welche Interfaces werden implementiert (erst bei

  Objektorientierung wichtig)

• Kopfzeile der Klasse

  : enthält noch einmal den Klassennamen. Zusätzlich sind auch hier in einer zweiten Zeile die Vererbung und eventuelle Interfaces angegeben (erst bei Objektorientierung

  wichtig)

• Beschreibung der Klasse

  : Hier wird allgemein die Funktionalität der

  Klasse beschrieben

• Kurzbeschreibung der Methoden

  : enthält den Zugriffsmodifikator

  static

  (falls eine Methode diesen hat) den Rückgabetyp, Klassenname,

  Parameterliste und den ersten Satz der Methodenbeschreibung.

• Genaue Beschreibung der Methoden

  : Wenn man auf einen Methodennamen

  klickt oder weiter hinunter schaut, kommt man zur Detailbeschreibung

  der Methoden. Diese enthält die genaue Kopfzeile der Methode und

  alle Informationen, die im Dokumentationskommentar angegeben wurden.

Ergänze folgende Zusammenfassung:

• Nach den Darstellungsoptionen und den Quicklinks ist oben der Name des angegeben.

• Der Packagename ist wichtig, damit die Klasse werden kann.

• Um eine Klasse zu importieren schreibt man .;

• Unter dem Packagenamen folgt der Name der

• Unter der Klassenkopfzeile ist noch eine allgemeine der Klasse angegeben.

• Die Kurzbeschreibung der Methoden zeigt folgende Informationen

  Formalparameterliste
  public (wenn es eine public-Methode ist)
  static (wenn es eine static-Methode ist
  Rückgabewert
  die genaue Methodenkopfzeile
  Erster Satz der Methodenbeschreibung
  Methodenname

• Die Detailbeschreibung der Methoden zeigt folgende Informationen

  die vollständige Beschreibung der Methode
  den Methodenkörper
  die genaue Methodenkopfzeile
  die Beschreibung der einzelnen Parameter
  den Text aus den Zeilen- und Blockkommentaren der Methode
  die Beschreibung des Rückgabewertes

Java-API

Diese Prinzipien gelten nicht nur für die eigenen Methoden und die

Methoden der Klasse Input, sondern auch für die Methoden der Standard

Java-

Wenn man wissen möchte, wie man Methoden aus der API-Bibliothek

verwenden kann, dann kann man sich am besten über die API-Dokumentation

informieren. Diese kann entweder über die Google-Suche nach "Java 8

API" gleich online gelesen werden (

Wenn man die zip-Version heruntergeladen hat, muss diese entpackt werden

("Alle Dateien extrahieren" in Windows), um einen Ordner namens docs

mir vielen html-Dateien zu enthalten. Der Ausgangspunkt für das Starten

der API-Dokumentation ist im Unterverzeichnis namens api die Datei

index.html. Durch Doppelklick wird die API-Dokumentation als

Offline-Webseite geöffnet.

Wenn man die Dokumentation gleich online liest, öffnet sich die gleiche

Datei allerdings als online-Version. Diese Datei bzw. Webseite gliedert

sich in 3 Bereiche:

• Klassenliste: Auflistung aller Klassennamen

• Hauptbereich: Inhalt der gerade gewählten Klasse / des gerade

  gewählten Packages/Paketes

• Paketliste bzw. Package-Liste (nur bei größeren Bibliotheken): wird über der Liste der

  Klassennamen angezeigt und enthält alle vorhandenen Packages/Paketes (ein

  Package ist wie ein Ordner eine Organisationseinheit, in der mehrere

  inhaltlich zusammengehörende Klassen zusammengefasst werden).

Ergänze folgende Zusammenfassung:

• Die Bibliothek in der viele vorgefertigte Klassen und Methoden verfügbar sind, nennt man Java- (kurz für Application Programming Interface)

• Diese Klassen und Methoden sind in der API- beschrieben. Diese besteht aus HTML-Dokumenten für jede Klasse.

• Man kann sich die API-Dokumentation offline als .zip-Datei herunterladen. Damit man sie verwenden kann, muss man sie zuerst .

• Zum Starten wählt man die Datei aus dem Ordner docs\api.

• Der Start-Bildschirm gliedert sich in 3 Bereiche:

  • Die enthält alle Klassen der Java-API in alphabetischer Reihenfolge.
  • Die Paketliste enthält die Ordner-Struktur, in der die Klassen gespeichert sind. Diese Ordner werden in Java auch als bezeichnet.
  • Im wird die gerade ausgewählte Klasse bzw. das ausgewählte Package dargestellt.

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.

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.

Einfache Methoden

Jedes Programm besteht aus vielen Methoden, ohne dass wir bis jetzt viel darüber nachgedacht haben. Eine Methode ist eine Zusammenfassung von Anweisungen, denen ein bestimmter Name gegeben wird. Wir haben bis jetzt schon viele Methoden verwendet, z.B. die Methode zum Einlesen von Werten:

Diese Methode arbeitet mit Parametern und Rückgabewerten und ist damit von ihrem Aufbau her schon ziemlich kompliziert. Bei Hamsterprogrammen haben wir viele verschiedene Methoden kennen gelernt, die auch einfacher im Aufbau waren:

Wir werden nach und nach all diese Formen besprechen und uns so bis zu Methoden mit Parametern und Rückgabewerten vortasten. Allerdings werden wir bei diesem Kapitel die Hamsterprogramme endgültig hinter uns lassen und uns nur mehr mit klassischem Java beschäftigen.

Klassenmethoden

Wenn wir mit Java arbeiten, müssen wir 2 grundsätzliche Kategorien von Methoden unterscheiden. Je nachdem wie später darauf zugegriffen

werden soll, kann es sich um

Ergänze die folgende Zusammenfassung:

• In einer Methode können mehrere zusammengefasst werden und so einen bekommen.

• Welche der folgenden Hamster-Methoden, sind Methoden ohne Parameter und ohne Rückgabewert?

  kornDa()
  liesZahl()
  schreib()
  gib()
  vornFrei()
  linksUm()
  vor()
  nimm()
  maulLeer()

• Welche der folgenden Hamster-Methoden, sind Methoden ohne Parameter aber mit Rückgabewert?

  maulLeer()
  nimm()
  vor()
  gib()
  linksUm()
  kornDa()
  liesZahl()
  vornFrei()
  schreib()

• Welcher Datentyp wird von den Hamstermethoden mit Rückgabewert aber ohne Parameter zurückgegeben?

• Welche der folgenden Hamster-Methoden, sind Methoden mit Parameter aber ohne Rückgabewert?

  gib()
  vornFrei()
  linksUm()
  maulLeer()
  vor()
  nimm()
  liesZahl()
  schreib()
  kornDa()

• Welchen Datentyp hat der Parameter bei den Hamster-Methoden mit Parameter aber ohne Rückgabewert?

• Welche der folgenden Hamster-Methoden, sind Methoden mit Parameter und mit Rückgabewert?

  linksUm()
  kornDa()
  schreib()
  vor()
  maulLeer()
  liesZahl()
  gib()
  nimm()
  vornFrei()

• Welchen Datentyp hat der Parameter bei den Hamster-Methoden mit Parameter und mit Rückgabewert?

• Welcher Datentyp wird von den Hamstermethoden mit Parameter und mit Rückgabewert zurückgegeben?

• Es gibt 2 Kategorien von Methoden:

  • (K...)

  • (O...)

• Methoden werden innerhalb von

  Kommentaren

  Methoden

  Klassen

  Variablen
  geschrieben.

• Ein anderer Name für das Schreiben einer Methode ist

• Eine Methode wird erst dann ausgeführt, wenn sie verwendet wird. Ein anderer Name für das Verwenden einer Methode ist

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

  im Arbeitsspeicher gespeichert

  auf die Festplatte gespeichert

  aus dem Arbeitsspeicher gelöscht

• Ein Block wird durch das Zeichen beendet.

• Deshalb kann eine Methode die Variablen einer anderen Methode

  manchmal

  immer

  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

  ungültig und lassen sich nicht kompilieren

  komplett unabhängig voneinander

  miteinander verbunden
  .

Welchen Rückgabetyp hat die folgende in der API gegebenen Methode der Klasse Short:

Welchen Datentyp hat der Parameter der folgenden in der API gegebenen Methode der Klasse Short: