Bibliotheksjavadocs, die von maven-javadoc-plugin generiert wurden, funktionieren nicht, wenn sie in Eclipse verlinkt sind - java, maven, javadoc, maven-plugin

UPDATE1: Es sind nicht nur Parameternamen, Eclipse zeigt überhaupt keine Javadoc-Informationen an. Wenn Sie mit der Maus über eine Klasse fahren, wird nichts angezeigt.

UPDATE2: Meine Eclipse-Version ist 4.2.0.

Ich verwende Eclipse und möchte die Javadocs einer Bibliothek an mein Projekt anhängen, so dass ich, wenn ich eine Schnittstelle implementiere und die Option wähle Fügen Sie nicht implementierte Methoden hinzu das Methoden Parameternamen richtig auftauchen statt arg0, arg1, etc.

Das Problem ist:

• Wenn ich die Javadocs über Eclipse generiere (Projekt> Javadocs generieren ...) und mit meinem Projekt verknüpfe Es klapptMit anderen Worten, ich sehe die korrekten Methodenparameternamen.

• Wenn ich die Javadocs über Maven-Javadoc-Plugin generiere und mit meinem Projekt verknüpfe es funktioniert nichtMit anderen Worten, ich verstehe arg0, arg1, etc.

Vielleicht konfiguriere ich mein maven-javadoc-plugin nicht korrekt? pom.xml:

  <plugin>
<artifactId>maven-javadoc-plugin</artifactId>
<version>2.8</version>
<executions>
<execution>
<id>attach-javadocs</id>
<goals>
<goal>jar</goal>
</goals>
</execution>
</executions>
</plugin>

Jede Hilfe wird geschätzt. Die Parameternamen nicht zu sehen, ist sehr schlecht.

Antworten:

Das hat mit zu tun dieser Eclipse Bug das wurde nur in Version 4.3 behoben. Grundsätzlich beendet Eclipse die Verarbeitung einer Javadoc-HTML-Datei in der folgenden Zeile:

<meta http-equiv="Content-Type" content="text/html" charset="utf-8">

weil es den Zeichensatz im Inhaltsattribut wie folgt erwartet:

 <meta http-equiv="Content-Type" content="text/html; charset=utf-8">

Ich glaube nicht, dass es eine Möglichkeit gibt, dem maven Javadoc-Plugin mitzuteilen, dass dieses Meta-Tag geändert werden soll. Sie können jedoch eine ANT-Task unten in maven ausführen, um alle Ihre HTML-Dateien zu reparieren:

<replace dir="target/apidocs">
<include name="**/*.html"/>
<replacetoken><![CDATA[<meta http-equiv="Content-Type" content="text/html" charset="utf-8">]]></replacetoken>
<replacevalue><![CDATA[<meta http-equiv="Content-Type" content="text/html; charset=utf-8">]]></replacevalue>
</replace>