Wie lädt Eclipse die Javadoc

[micbur]

Hallo,

das kennt sicher jeder. Wenn ich in Eclipse Quellcode eintippe, kann ich mir durch einen Hover den Javadoc anschauen bzw. durch Strg + Space mir eine Liste der verfügbaren Felder 'vorraten' lassen und mir dazu den entsprechenden Javadoc anschauen.

Wie macht Eclipse das?
Das funktioniert sogar, wenn man die Javadocs gar nicht auf dem Rechner hat.

Ciao, micbur

 

[AlArenal]

Weil Javadocs aus Quellcode generiert werden....

 

[micbur]

Hallo,

ja, das ist korrekt. Aber: in der rt.jar ist kein Quellcode. Ich habe auch gar keinen Quellcode von der JRE oder SDK installiert. Ich habe testweise auch mein Javadoc vom Rechner genommen. Die Tooltipps sind aber immernoch da.

Macht einfach plopp und es ist da ???:L

Ciao, micbur

 

[byte]

Das funktioniert sogar, wenn man die Javadocs gar nicht auf dem Rechner hat.

Die öffentlichen Schnittstellen sind ja aus den Sourcen bekannt. Die Dokumenation über diese Methoden muss jedoch explizit bekannt gemacht werden (in Form der Javadoc Dateien). Dann zeigt Eclipse auch diese an.

 

[AlArenal]

ja, das ist korrekt. Aber: in der rt.jar ist kein Quellcode. Ich habe auch gar keinen Quellcode von der JRE oder SDK installiert.

Wenn du ein SDK installiert hast, hast du auch die Quellcodes installiert.

 

[micbur]

Die öffentlichen Schnittstellen sind ja aus den Sourcen bekannt. Die Dokumenation über diese Methoden muss jedoch explizit bekannt gemacht werden (in Form der Javadoc Dateien). Dann zeigt Eclipse auch diese an.

OK, damit ich das richtig verstehe. Die Schnittstellen, also die Signatiur von Klassen, Methode, ... stehen im Bytecode. Das war mir klar. Damit Eclipse mir aber auch anzeigt, was der Konstruktor java.lang.String() alles kann, muss ein Javadoc von Eclipse gefunden werden und dann parst Eclipse die HTML-Dateien?

Öhm, die Javadocs habe ich ihm gerade weggezogen indem ich sie einfach nach /dev/null verschoben habe. Die findet er nicht mehr so leicht. Trotzdem zeigt er mir das an. Die src.zip vom JRE habe ich auch gelöscht. Nun hat er wirklich nur noch Bytecode zur Verfügung und alles, was er sich mitbringt.

Ich will doch nicht widersprechen, nur er macht das doch noch.

Ciao, micbur

 

[micbur]

OK, ja, habs gefunden.

HTML-Code parsen, igitt.

 

[KSG9|sebastian]

Das bezweifel ich mal stark.
Du kommst ja auch über Reflection an alle Felder und Methoden ran. Da brauchst du keine Sourcen oder sonstwas dazu.

 

[hupfdule]

Um an die Javadoc Kommentare zu kommen wird Reflection nicht viel helfen.
Andererseits würde es mich schon wundern, wenn Eclipse wirklich die HTML-Dateien parst und nicht die Quelldateien.

 

[micbur]

Also im SDK ist ein docs-Verzeichnis mit den HTML-Javadocs. Über die Packagelist kann man relativ einfach seine passende Datei finden. Wenn man erstmal die Datei hat, kann man

<A NAME=\"" + uri.getFragment() + ".*\"></A>

suchen. Ich nutze hinter dem Anker ein ".*", da ich keine geeignete Ratefunktion für die Parameter der Konstruktoren und Methoden habe. Mir reicht hierfür das erste Vorkommen.

Ob Eclipse das auch so macht, weiß ich nicht. Aber diese Lösung ist schnell, wenn man nicht über http zugreifen will.

 

[hupfdule]

Ach so. Du meinst du parst jetzt die HTML-Dateien. Ich hatte deine Frage so verstanden, dass du nur wissen wolltest, wie Eclipse das macht und dass du der Meinung gewesen wärst, dass dieses die HTML-Dateien parst.

 

[micbur]

Ich möchte ja auch wissen wie Eclipse das macht, aber wenn im SDK ein Javadoc enthalten ist, im Bytecode nur eine Signatur enthalten ist, und sonst keine Möglichkeit besteht, bringt Eclipse das entweder mit oder parst die HTML-Dateien des Javadoc.

Ciao, micbur

 

[byte]

Also bei mir werden keine Javadocs in Eclipse angezeigt, solange ich nicht die Sourcen hinzufügen, also z.B. in Form der src.zip oder den Weblink zur Javadoc bei Sun.

 

[AlArenal]

Also bei mir werden keine Javadocs in Eclipse angezeigt, solange ich nicht die Sourcen hinzufügen, also z.B. in Form der src.zip oder den Weblink zur Javadoc bei Sun.

Korrekt.

Micbur sollte lieber auf einem frischen System mit neuem Eclipse und ohne JDK testen, statt auf einem System wo Sources und JDocs schon vorhanden waren. Ich habe nun keinen Bock in den Eclipse-Quellen zu suchen, da aber Eclipse u.a. auch heftig mit Lucene arbeitet liegt der Schluss nahe, dass es da noch "Überbleibsel" gibt, die Eclipse weiter nutzt.

 

[chweyer]

Hallo,

zwar ohne Garantie, aber bei mir (Eclipse 3.2 und höher) wurde, mein ich,
automatisch auf das Internet zurückgegriffen, um den Javadoctooltip
anzuzeigen(ohne das vorher irgendetwas deswegen konfiguriert wurde),
falls die Sourcen des JDK nicht installiert sind, oder nur das JRE installiert ist.

Falls die Sourcen des JDK installiert sind, braucht Eclipse keine stehende Internetverbindung,
sofern bei Preferences-->Installed JREs der Pfad zum JDK angegeben ist. (nicht zur öffentlichen
stand-alone JRE)

@micbur, zum Test: Wenn keine Javadoctooltips erscheinen sollen: Internetverbindung trennen
und Sourcen entsorgen. (oder alternativ zu Sourcen entsorgen, obigen Pfad zur öffentlichen JRE
zeigen lassen)

Chris