O exemplo neste artigo descreve o método de geração automática de documentos javadoc no Eclipse. Compartilhe com todos para sua referência. O método específico é o seguinte:
Existem três maneiras principais de usar o Eclipse para gerar documentação (javadoc):
1. Clique com o botão direito na lista de projetos, selecione Exportar, selecione javadoc em java na caixa de diálogo Exportar e envie para a próxima etapa.
Há dois lugares aos quais prestar atenção na caixa de diálogo Geração de Javadoc:
Comando javadoc: bin/javadoc.exe do jdk deve ser selecionado
destino: é o caminho de salvamento do documento gerado, que pode ser selecionado livremente.
Pressione finalizar para enviar para começar a gerar o documento.
2. Use o menu para selecionar: Arquivo->Exportar (Arquivo->Exportar),
As etapas restantes são iguais às do primeiro método.
3. Selecione o projeto para o qual deseja gerar a documentação e, a seguir, utilize o menu para selecionar,
Projeto->Gerar Javadoc entra diretamente na caixa de diálogo Geração de Javadoc. As etapas restantes são iguais ao primeiro método, começando na caixa de diálogo Geração de Javadoc.
Você pode usar qualquer método, mas deve prestar atenção a algumas questões:
1. O Eclipse não pode ser gerado e um erro é relatado:
java.lang.IllegalArgumentException em sun.net.www.ParseUtil.decode
, que é causado pela configuração de variáveis de ambiente java. Por exemplo, o caminho de classe é
.;%JAVA_HOME/lib/dt.jar;%JAVA_HOME%/lib/tool.jar. A solução é deletar o classpath ou consultar o documento oficial http://maven.apache.org/plugins/maven-javadoc-. plugin/faq.html.
2. O documento gerado está distorcido. Melhore o api-doc. Ao usar o Eclipse para gerar javadoc, ocorre "codificação de caracteres não mapeáveis GBK". Abra o eclipse, projeto -> Gere javadoc e selecione o projeto que deseja gerar o javadoc um por um. Na última etapa, adicione o seguinte código à linha de configurações da VM. -8
Espero que este artigo seja útil para a programação Java de todos.