Richtige Benutzung der API-Doku

[UdoKessler]

So, jetzt habe ich mich etwas in die grundsätzliche Syntax von Java eingearbeitet.
Mein Problem ist nur, daß ich die Möglichkeiten der Sprache noch nicht kenne.
Dafür gibts ja die Doku, in welcher beschrieben ist, was mir Java so
zu bieten hat.

Die Frage ist nur, wie ich die Sache angehe.
Die Doku ist etwas verwirrend für mich - weil ich vermutlich die ganze Sache
mit Paketen, Klassen, Objekten, Methoden usw noch nicht
ganz verstanden habe. Oder besser gesagt, wie diese alle zusammenhängen.



Ich hoffe das Folgende klingt nicht zu doof, aber irgendwie kapier
ichs noch nicht ganz...Beispiel:


Also, nehmen wir mal an, ich möchte einen Text in der Konsole ausgeben -
mit System.out.println(). Und nehmen wir an, ich kenne diesen Aufruf noch
nicht.
Wie müsste ich anfangen in der Doku zu suchen?



Ich versuche folgendes(Java-doku in meinem Browser geöffnet):

Unter Packages suche ich mir >java.io< raus, weil es mir logisch erscheint(input/output)..
Dann wähle ich bei den dort verfügbaren Klassen >PrintStream<..ebenfalls Logik
Die dort verfügbaren Methoden sind ja kurz beschrieben (in der "Method Summary").
Ich finde auch recht schnell das >println<

println

public void println()

    Terminates the current line by writing the line separator string. 
    The line separator string is defined by the system property line.separator, and is not 
    necessarily a single newline character ('\n').

Soweit so gut, danach habe ich gesucht.



Aber -und das ist die entscheidende Frage- wie komme ich jetzt auf das >System.out< ?



.

 

[faetzminator]

Das alles kannst du schon in Eclipse (und in anderen IDE's sicher auch)
- Du schaust dir den Typ von "out" an --> PrintStream
- Du siehst die Javadoc zu System.out und merkst dass out "stdout" ist
- Du siehst die Javadoc zu println() und merkst für was sie ist
Natürlich kannst du noch die Javadoc von System oder PrintStream online anschauen

 

[diggaa1984]

das ist ja nicht der weg den er gehen würde ... in deinem (UdoKessler) Fall kann ich mir nicht vorstellen, dass man damit immer das findet wonach man sucht, weil man schlicht nicht weiss wonach man suchen soll. Du fängst in der Hierarchie oben an mit der Suche, und fragst dich welche Klassen drunter das jemals nutzen. Und wenn man System.out nicht kennt, wie soll man da jemals von PrintStream drauf kommen.

Es gibt Sache die muss man einfach wissen, durch Erfahrung, oder erfragen, und sie danach als Erfahrung ablegen .. Aber google könnte dir eventuell hilfreiche Schlagworte liefern, wenn man in etwa weiss was man erreichen möchte

 

[0x7F800000]

Aber -und das ist die entscheidende Frage- wie komme ich jetzt auf das >System.out< ?

Mit Hilfe der Doku alleine? Gar nicht. Dazu ist sie nicht da. Wenn du einfach so draulossuchst, ohne in etwa zu wissen was du suchst und ob es sowas überhaupt gibt, wirst du in der Doku niemals etwas finden, dazu ist sie viel zu groß.

Api ist für feine Details.
Für den groben Überblick sind Bücher wie etwa:
Galileo Computing :: Java ist auch eine Insel (8. Auflage) – 2 Sprachbeschreibung
oder Tutorials wie etwa:
The Java™ Tutorials
wesentlich besser geeignet.

Und wenn man nicht weiterkommt, kann man ja auch hier direkt fragen...

Wenn man eine Skulptur erschaffen will, fängt man ja auch nicht an, mit Schleifpapier an einem 3x5x17 km großen Felsen rumzufummeln, da nimmt man schon eher sowas wie Dynamit...

 

[faetzminator]

Ah so, habe die Frage wohl falsch verstanden. Google hilft (gerade bei der Java SE Api) da am besten, einfach in diesem Fall nach "java console ouput" oder "java console print" suchen.

 

[Ebenius]

Was in jedem Fall die Arbeit erleichtert, ist, sich von vornherein mal alle java.* und javax.*-Pakete aus dem Java SE anzusehen. Nicht gleich alle Klassen, aber die Paket-Beschreibung. So lernt man eben recht schnell, dass alles was Standard-I/O ist, in den Paketen java.io und java.nio liegt. Wenn man später irgendwas mit IO machen will und nicht weiß, was man genau benötigt, hilft es oft, sich schnell mal alle Klassennamen in den beiden Paketen anzusehen. Oft findet man anhand der Liste der Klassennamen schnell das gewünschte Hilfsmittel, wenn man bereits im richtigen Paket sucht.

Das stellt natürlich die beiden Aussagen über dieser keines Wegs in Abrede.

Ebenius

 

[UdoKessler]

Hi,

ok, danke erstmal!

Mein Problem ist, denke ich, daß ich zwar schon in der Lage bin,
in etwa das zu finden was ich möchte (in der Doku), aber die
Zusammenhänge nicht verstehe.

Mal wieder unser println als Beispiel:

println ist eine Methode der Klasse PrintStream aus dem Paket java.io.
Das verstehe ich ja!
Aber out ist ein Feld aus der Klasse System aus dem Paket java.lang.

Bei out steht jetzt zwar in der Doku, daß per System.out.println eine
Ausgabe gemacht wird..aber würde das dort zufällig nicht stehen, woher
wüsste ich das dann? Wo sieht man diesen Zusammenhang?

Oh mann, ich hoffe ihr versteht mich

 

[faetzminator]

Du musst das von einer anderen Seite betrachten:
Du willst einen PrintStream haben, welcher auf die Konsole schreibt - d.h. du willst STDOUT verwenden (ein Framework kann durchaus System.out mit einem anderen PrintStream austauschen, so dass es z.B. deine Ausgaben lesen, editieren und loggen kann)
Und diese "STDOUT-Instanz" muss nunmal irgendwo gespeichert werden, was im Fall von Java die Klasse System ist.

Abgesehen davon siehst du in der Doku dass System.out ein PrintStream ist, was deine Frage beantworten sollte

 

[UdoKessler]

Du musst das von einer anderen Seite betrachten:
Du willst einen PrintStream haben, welcher auf die Konsole schreibt - d.h. du willst STDOUT verwenden (ein Framework kann durchaus System.out mit einem anderen PrintStream austauschen, so dass es z.B. deine Ausgaben lesen, editieren und loggen kann)
Und diese "STDOUT-Instanz" muss nunmal irgendwo gespeichert werden, was im Fall von Java die Klasse System ist.

Danke erstmal..ich merke daß ich noch einiges lernen muss...

Abgesehen davon siehst du in der Doku dass System.out ein PrintStream ist, was deine Frage beantworten sollte

Das habe ich kurz nach dem Abschicken auch gesehen



Danke euch


Gruß
Udo