Update1: Nie sú to len názvy parametrov, zatmenie nezobrazuje žiadnu informáciu o javadoc. Keď prejdete kurzorom nad triedu, nič sa nezobrazí.
Update2: Moja zatmenie verzia je 4.2.0.
Používam program Eclipse a rád by som do môjho projektu pripojil knižnicu javadocs, aby som pri implementácii rozhrania zvolil možnosť Pridajte neimplementované metódy na názvoch parametrov metódy Ukázať správne miesto arg0, arg1, atď.
Problém je:
Keď som generovať javadocs pomocou eclipse (projekt > generovať Javadocs...) a odkaz na môj projekt funguje to, inými slovami, vidieť správnu metódu parametra mená.
Keď vygenerujem javadocs prostredníctvom maven-javadoc-plugin a prepojím ho s mojím projektom to nefungujeInými slovami, vidím arg0, arg1, atď.
Možno nie som správne nakonfigurovaný môj maven-javadoc-plugin? Pod konfiguráciou z môjho 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>
Akákoľvek pomoc bude ocenená. Nevidenie názvov parametrov je veľmi zlé.
odpovede:
2 pre odpoveď č. 1Týka sa to túto chybu zatmenia ktorý bol stanovený len vo verzii 4.3. V podstate zatmenie zastaví spracovanie javadoc html súboru na nasledujúcom riadku:
<meta http-equiv="Content-Type" content="text/html" charset="utf-8">
pretože čaká na znakovú sadu v atribúte obsahu, ako je uvedené nižšie:
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
Nemyslím si, že existuje spôsob, ako povedať maven javadoc plugin zmeniť túto značku meta, ale môžete spustiť úlohu ANT nižšie z maven opraviť všetky vaše súbory 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>