Java ist auch eine Insel (3. Aufl.) – 3.3 Die API-Dokumentation

Java ist auch eine Insel (3. Aufl.) von Christian Ullenboom
Programmieren für die Java 2-Plattform in der Version 1.4

Kapitel 3 Klassen und Objekte
	3.1 Objektorientierte Programmierung
		3.1.1 Warum überhaupt OOP?
		3.1.2 Modularität und Wiederverwertbarkeit
	3.2 Klassen benutzen
		3.2.1 Die Klasse Point
		3.2.2 Etwas über die UML
		3.2.3 Anlegen eines Exemplars einer Klasse
		3.2.4 Zugriff auf Variablen und Methoden mit dem Punkt
		3.2.5 Konstruktoren
		3.2.6 Die null-Referenz
	3.3 Die API-Dokumentation
	3.4 Mit Referenzen arbeiten
		3.4.1 Zuweisungen bei Referenzen
		3.4.2 Funktionen mit nichtprimitiven Parametern
		3.4.3 Gleichheit von Objekten und die Methode equals()
	3.5 Arrays
		3.5.1 Deklaration von Arrays
		3.5.2 Arrays mit Inhalt
		3.5.3 Die Länge eines Arrays über das Attribut length
		3.5.4 Zugriff auf die Elemente
		3.5.5 Array-Objekte erzeugen
		3.5.6 Fehler bei Arrays
		3.5.7 Arrays mit nichtprimitiven Elementen
		3.5.8 Arrays und Objekte
		3.5.9 Initialisierte Array-Objekte
		3.5.10 Mehrdimensionale Arrays
		3.5.11 Die Wahrheit über die Array-Initialisierung
		3.5.12 Arrays kopieren und füllen
		3.5.13 Mehrere Rückgabeparameter
		3.5.14 Parameter per Referenz übergeben
		3.5.15 Der Einstiegspunkt für das Laufzeitsystem
		3.5.16 Der Rückgabewert von main()
		3.5.17 Die Klasse Arrays

3.3 Die API-Dokumentation

Die wichtigste Informationsquelle für Programmierer ist die API-Dokumentation von Sun. Für unseren Punkt können wir dort entnehmen, dass dieser eine Funktion setLocation() besitzt, eine Variable x oder einen Konstruktor, dem man zwei Ganzzahlen mitgeben kann.

Die Dokumentation muss extra von der Sun-Seite bezogen werden (http://java.sun.com/docs/) und gehört nicht zu einer Standardinstallation einer Laufzeitumgebung dazu. Wer permanente Internetverbindung besitzt, kann die Dokumentation auch online unter http://java.sun.com/j2se/1.4.1/docs/api/index.html lesen. (Unter Umständen muss nur die Version geändert werden, für 1.4.1 lässt sich auch 1.2 einsetzen und vielleicht später mal 2.1).

Die Sun-Dokumentation in der HTML-Form hat einen Nachteil, der sich im Programmieralltag bemerkbar macht: Die Dokumentation lässt sich nur ungenügend durchsuchen. Wenn wir einfach nach Methoden suchen wollen, die auf »listener« enden, geht das so nicht. Hier kommt die Arbeit des Franzosen Franck Allimant ins Spiel. Er übersetzt regelmäßig die HTML-Dokumentation von Sun in das Windows-Hilfe-Format HTMLHelp und WinHelp. Unter http://www.confluent.fr/javadoc/ lassen sich sich die Dateien besorgen. Der Screenshot zeigt die Hilfe der Datei jdk141.chm für die Version 1.4.1.

Hier klicken, um das Bild zu Vergrößern

<< zurück

<top>

vor >>