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:

Schreibe die Kopfzeile der Methode für folgende Aufgabenstellung:

Definiere eine Klassenmethode mit dem Namen schulName in der Klasse SchulInfo die den Schulnamen (TGM) zurückgibt.

Schreibe den Aufruf für die Methode für folgende Aufgabenstellung, so dass das Ergebnis in der Variablen namens hurra gespeichert wird (die Variable wurde schon deklariert):

Definiere eine Klassenmethode mit dem Namen istHeuteWochenende in der Klasse Datum, die ermittelt, ob der heutige Tag Teil des Wochenendes ist (true), oder nicht (false) und das Ergebnis zurückgibt.