Die Dokumentation für Kontextausdrücke in Java 

Mit „Kontextausdruck “ ist hier ein Ausdruck gemeint, der als Kontext verwendet wird, wie etwa »""« in »"".valueOf( 3 )«.

Beim Aufruf »java.lang.String.valueOf( 3 )« mit dem Kontext »java.lang.String« wird die statische Methode »valueOf(int)« aufgerufen, deren Dokumentation in der Dokumentation des Kontexts »java.lang.String« zu finden ist.

Statt »java.lang.String.valueOf( 3 )« kann man auch schreiben »"".valueOf( 3 )«. Dadurch wird immer noch dieselbe Methode aufgerufen. Legt man aber den Aufruf »"".valueOf( 3 )« zugrunde, so findet sich die Dokumentation der aufgerufenen Methode nun in der Dokumentation des Typs  des Kontexts und nicht mehr des Kontexts selber. Der Typ des Kontext  ist beim Aufruf »"".valueOf( 3 )« ja »java.lang.String«.

Finden des Ortes der Dokumentation

Der Aufruf »java.lang.System.out.println()« besteht aus dem Kontext »java.lang.System.out« und dem Verbaufruf »println()«.

Der Kontext »java.lang.System.out« ist ein Feld des Typs »java.lang.System« mit dem Typ »java.io.PrintStream«. Der Typ des Kontexts  ist also »java.io.PrintStream«. Entsprechend findet sich die Dokumentation der aufgerufenen Methode in der Dokumentation des Typs »java.io.PrintStream«.

Zerlegung eines Aufrufs

java.lang.System.out . println()
      Kontext          Verbaufruf
         |
         | Typ
         V
java.io.PrintStream

Durch den Verbaufruf »println()« wird eine Methode aufgerufen, deren Dokumentation sich in der Dokumentation des Typs des Kontexts, also in der Dokumentation des Typs »java.io.PrintStream«, befindet.

ℛ Dokumentationsprinzip (vereinfacht) Die Dokumentation  einer Methode, deren Aufruf einen Ausdruck  als Kontext hat, findet man unter dem Typ des Kontexts  ihres Aufrufs.

Übungsfragen

?   Dokumentationsort angeben

In der Dokumentation welchen Typs findet man die Dokumentation der in dem folgenden Programm aufgerufenen indexOf-Methode?

Main.java

public final class Main
{ public static void main( final java.lang.String[] args )
  { java.lang.System.out.println( "abcd".indexOf( "c" )); }}

Protokoll

2

Dokumentationsprinzip Die Dokumentation  einer Methode, deren Aufruf einen Ausdruck  als Kontext hat, findet man unter dem Typ des Kontexts  ihres Aufrufs.

?   Dokumentationsort angeben

In der Dokumentation welchen Typs findet man die Dokumentation der in dem folgenden Programm aufgerufenen valueOf-Methode?

Main.java

public final class Main
{ public static void main( final java.lang.String[] args )
  { java.lang.System.out.println( "abcd".valueOf( 3 )); }}

Protokoll

3

Dokumentationsprinzip Die Dokumentation  einer Methode, deren Aufruf einen Ausdruck  als Kontext hat, findet man unter dem Typ des Kontexts  ihres Aufrufs.

?   Dokumentationsort angeben

In der Dokumentation welchen Typs findet man die Dokumentation der in dem folgenden Programm aufgerufenen readLine-Methode?

Main.java

public final class Main
{ public static void main( final java.lang.String[] args )
  { java.lang.System.out.println( java.lang.System.console().readLine() ); }}

Dokumentationsprinzip Die Dokumentation  einer Methode, deren Aufruf einen Ausdruck  als Kontext hat, findet man unter dem Typ des Kontexts  ihres Aufrufs.

Bei einigen Versionen von Netbeans  sind nicht alle Möglichkeiten von »java.lang.System.console()« verfügbar.