Löse folgende Aufgabe:

Gegeben ist die Klasse mit der Methode aus den vorigen beiden Übungen (die Methode ist in der gegebenen Klasse definiert):

Ergänze die folgenden Aussagen, so dass sie für diese Methode zutreffen.

• Die gegebene Methode ist in der Klasse definiert.

• Der Name der Methode 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.

• Der Parameter hat den Datentyp .

• Daher wird als Parameter

  eine Zahl (am besten 0 oder 1)

  ein Text, der true oder false enthält

  der boolean-Wert true oder false
  angegeben.

• Schreibe ein Beispiel für einen Aktualparameter hin, der für diesen Parameter eingesetzt werden kann. Der Beispielwert soll dem Wert für wahr entsprechen (Achte auf den Datentyp des Parameters)

• Diese Methode benötigt

  eine

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

  void
  ist.

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

• Deklariere eine passende Auffangvariable mit dem Namen ergebnis:

• Schreibe einen Aufruf für diese Methode hin, die das Ergebnis in die bereits deklarierte Variable namens ergebnis speichert. Als Parameter soll ein Wert verwendet werden, der dem Wert wahr entspricht. Achte auf den Datentyp des Parameters.

Die Methode parseDouble

Um die Ähnlichkeiten zwischen den unterschiedlichen parse-Methoden zu

zeigen, wird hier noch die API-Dokumentation der Methode

Die Antworten auf die Überlegungen zum Aufruf ergeben sie daher ähnlich:

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: Double.parseDouble

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

   Aktualparameter (= aktueller Wert) festgelegt werden:

   • 1 Parameter vom Typ String: irgendein String

     , der in eine Fließkommazahl umgewandelt werden kann und dafür nur aus Ziffern, einem Punkt als Dezimaltrennzeichen und ev.

     einem Vorzeichen besteht, z.B.: "37.8" oder ein entsprechender

     Wert in einer Eingabe-Variablen.

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:

   double

   , d.h. es wird eine Auffangvariable vom Typ

   double benötigt

Ein möglicher Aufruf könnte z.B. folgendermaßen aussehen:

Ergänze folgende Zusammenfassung:

• Die Methode für Umwandlung von String in double ist in der Klasse definiert.

• Der Name dieser Methode 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 einzigen Parameter wird

  eine Kommazahl

  ein Text, der aus Ziffern und einem Punkt besteht

  eine ganzzahlige Zahl
  angegeben.

• Diese Methode benötigt

  keine

  eine
  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 Methode parseInt

Die Methode parseInt

übernimmt einen als Parameter übergebenen

Für den Aufruf müssen wieder die bei den Eingabe-Methoden besprochenen

Punkte überlegt werden:

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: Integer.parseInt

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

   Aktualparameter (= aktueller Wert) festgelegt werden:

   • 1 Parameter vom Typ String: irgendein String

     , der in eine ganze

     Zahl umgewandelt werden kann und dafür nur aus Ziffern und ev.

     einem Vorzeichen besteht, z.B.: "5242" oder ein entsprechender

     Wert in einer Eingabe-Variablen.

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:

   int

   , d.h. es wird eine Auffangvariable vom Typ

   int benötigt

Ein möglicher Aufruf könnte z.B. folgendermaßen aussehen:

Ergänze folgende Zusammenfassung:

• Die Methode für Umwandlung von String in int ist in der Klasse definiert.

• Der Name dieser Methode 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 einzigen Parameter wird

  ein Text, der aus lauter Ziffern besteht

  eine ganzzahlige Zahl

  eine Kommazahl
  angegeben.

• Diese Methode benötigt

  keine

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

  void
  ist.

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

Umwandeln von Text

Die für Benutzereingaben benützte Methode showInputDialog

der Klasse

Auch für dieses Problem gibt es in der Java-API Methoden für das Umwandlen von String in einen anderen Datentyp. Sie befinden sich in den Wrapper-Klassen (von wrap

... einwickeln) der primitiven Datentypen.

Nachdem in Java alle Methoden in Klassen organisiert sein müssen, dienen

die Wrapper-Klassen u.a. als Container für Methoden die den einfachen

Datentypen zugeordnet sind.

Die Umwandlungsmethoden selbst beginnen mit dem Wort parse

(= "Text

analysieren") gefolgt vom Datentyp, in den umgewandelt werden soll. Die

folgende Tabelle bietet einen kleinen Auszug:

Die Klasse Integer

Als Beispiel wird hier die Methode parseInt der Klasse Integer

genauer

vorgestellt. Die anderen parse-Methoden sind ganz ähnlich aufgebaut. Die

Klasse

Das Paket java.lang

Das Paket, in dem sich die Klasse Integer

befindet, ist das Kernpaket

der Programmiersprache Java. Die Bezeichnung

Ergänze folgende Zusammenfassung und beantworte die Fragen:

• Die Methode showInputDialog der Klasse JOptionPane gibt immer den Datentyp zurück.

• Um einen anderen Datentyp z.B. zum Berechnen von Werte zu bekommen muss der String-Wert

  ohne Umwandlung einfach

  umgewandelt und
  in eine passende Variable (z.B. in eine Zahlenvariable) gespeichert werden.

• Für das Umwandeln von String-Werten in einen einfachen Datentyp gibt es passende Methoden in den -Klassen.

• Die Umwandlungsmethoden in den Wrapper-Klassen beginnen alle mit dem Wort (für Text analysieren}

• Die Wrapper-Klasse für den Datentyp int heißt .

• Die Methode zum Umwandeln String in int heißt .

• Die Klasse Integer befindet sich im Paket

• Dieses Paket ist besonders, weil Klassen aus diesem Paket

  nicht

  immer
  vom Programm importiert werden müssen. Diese Klassen sind
  nicht

  immer
  automatisch importiert.

• Weitere Klassen, die in diesem java.lang-Package sind, und daher nicht vom Programm importiert werden müssen, sind:

  String
  JOptionPane
  System

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

  keine

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

  void
  ist.

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

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

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

• Die Detailbeschreibung der Methoden zeigt folgende Informationen

  den Methodenkörper
  die genaue Methodenkopfzeile
  den Text aus den Zeilen- und Blockkommentaren der Methode
  die vollständige Beschreibung der Methode
  die Beschreibung der einzelnen Parameter
  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 aus der Java-API aufrufen

Wie wir in den vorigen Kapiteln gelernt haben, ist eine Methode ein

Programmteil, der mehrere Anweisungen unter einem Namen zusammenfasst.

Doch um Methoden noch besser zu verstehen, betrachten wir sie noch

einmal von außen.

Methoden kann man sich als kleine "Hilfsmaschinen" vorstellen, die wir

verwenden können, um unser Programm umsetzen zu können. Zum Beispiel

können wir die

Um ihre Arbeit zu machen, benötigt die Methode Daten, mit deren Hilfe

sie ihre Aufgabe erledigen kann: die

Die readInt

Methode z.B. braucht einen Text zum Anzeigen als Parameter und

liefert uns die Zahl, die der Benutzer eingegeben hat, als Rückgabewert.

Klassen und Klassenmethoden:

Nachdem es in Java viele Methoden gibt, genügt es nicht, einfach nur

ihren Namen zu kennen. Es gibt immer wieder Methoden, die gleich heißen.

Aber auch wenn der Methodenname eindeutig wäre, würde Java eine Methode,

die nur mit ihrem Namen aufgerufen wird im Allgemeinen nicht finden.

Methoden gehören immer zu einer Klasse und damit man sie richtig

aufrufen (=verwenden) kann, muss man auch den

Wenn man also den Klassennamen weiß und die Klasse mit Hilfe des zugehörigen Packages auch

• Klassenmethoden werden direkt mit Hilfe des Klassennamens

  aufgerufen (deshalb auch der Name

  Klassenmethode)

• Objektmethoden werden mit Hilfe einer Objektreferenz

  , die

  erst aus dieser Klasse erzeugt werden muss, aufgerufen (deshalb der

  Name

  Objekt

  methode). Objektmethoden werden aber in diesem Kapitel

  nicht weiter besprochen.

Für Klassenmethoden ist also der Aufrufname folgendermaßen aufgebaut:

Für die Methode readInt aus der Klasse Input sieht dies z.B. so aus:

Input.readInt

Ergänze die folgende Zusammenfassung:

• Methoden sind innerhalb von definiert.

• Die Klassen wiederum sind in organisiert.

• Damit eine Klasse verwendet werden kann, muss sie erst zusammen mit dem Package werden (außer sie befindet sich im gleichen Package bzw. Ordner wie die Klasse, die sie verwenden möchte).

• Es gibt 2 Kategorien von Methoden:

  • Methoden, die mit Hilfe des Klassennamens aufgerufen werden =
  • Methoden, die mir Hilfe einer Objektreferenz aufgerufen werden =

• Klassenmethoden werden mit aufgerufen.

• Die Methode namens readChar aus der Klasse Input wird also mit aufgerufen.

• Damit die Methoden ihre Arbeit machen können, kann man den Methoden Daten hinein übergeben. Man nennt diese Werte

• Methoden können auch Ergebnisse heraus geben. Man nennt diese Ergebnisse .

• Eine Methode kann

  nur einen

  viele

  keinen
  Parameter haben, aber
  viele

  keinen

  nur einen
  Rückgabewert.

Welchen Datentyp braucht eine Auffangvariable, die das Ergebnis von folgender Methode speichern soll:

public static boolean methode() {

Welchen Datentyp braucht eine Auffangvariable, die das Ergebnis von folgender Methode speichern soll:

public static double methode() {