2016-04-06 27 views
5

UPDATE1: To nie tylko nazwy parametrów, eclipse nie wyświetla żadnych informacji javadoc. Po najechaniu kursorem na klasę nic nie jest wyświetlane.Biblioteczne javadocs generowane przez maven-javadoc-plugin nie działa po podłączeniu do Eclipse

UPDATE2: Moja wersja eclipse to 4.2.0.

Używam Eclipse i chciałbym dołączyć Javadocs bibliotekę do mojego projektu, tak, że kiedy implementować interfejs i wybrać opcję dodać metody niewdrożonych Nazwy parametrów metody pojawiają się poprawnie zamiast arg0, arg1 itp

problem:

  • Podczas generowania Javadocs poprzez Eclipse (projek t> Generuj Javadocs ...) i połącz go z moim projektem działa, innymi słowy widzę poprawne nazwy parametrów metod.

  • Kiedy generowania Javadocs poprzez maven-javadoc plugin i połączyć go z mojego projektu nie działa, innymi słowy, widzę arg0, ARG1 itd

Być może nie konfiguruję poprawnie mojej wtyczki maven-javadoc? Poniżej konfiguracji z mojego 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> 

Każda pomoc będzie mile widziane. Niewidoczne nazwy parametrów są bardzo złe.

+0

Czy próbowali pękanie otwarte pliki jar i porównywanie plików? Jak oni się różniły? Podobnie jak na marginesie, wierzę, że większość IDE, w tym Eclipse, będzie polegać głównie na słoiku * source * dla tego rodzaju inteligencji. –

+0

To dobry pomysł. Zrobię różnicę i zobaczę, co mogę znaleźć. Ale nie będę rozpowszechniać źródeł, tylko javadocs. Wygenerowane przez Eclipse javadoki działają dobrze, więc maven robi coś zupełnie innego. –

Odpowiedz

2

To ma związek z this eclipse bug, który został naprawiony tylko w wersji 4.3. Zasadniczo zaćmienie przestaje przetwarzać plik html javadoc na następującej linii:

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

ponieważ spodziewa charset w atrybucie jak poniżej Treść:

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

Nie sądzę, istnieje sposób, aby powiedzieć wtyczki Maven javadoc do zmiany tej meta tag, ale można uruchomić poniżej ANT zadanie z Maven naprawić wszystkie pliki hTML:

<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>