interface da API Java

9

Desde que comecei a brincar com o Scala, tive uma grande dúvida sobre a API Java: por que o Oracle mantém o mesma página HTML antiga com tags" frameset "e nenhuma função de busca? Parece que eles não chegaram à Web 2.0 ...

Por outro lado, a documentação da API do Scala , embora não seja o melhor website em a história da web, é várias ordens de magnitude mais utilizável.

De qualquer forma, se alguém sabe o porquê disso e, mais importante, se existe uma documentação da API Java com uma interface melhor, por favor me avise!

    
por seb 04.07.2011 в 17:22
fonte

4 respostas

3

Recentemente, para o Java 7, o JavaDoc foi aprimorado para poder usar CSS customizado. Aqui estão os primeiros resultados: link . O trabalho continua e acho que veremos mais quando novas atualizações forem lançadas. Eu concordo que o ScalaDoc é superior, mas eles não tiveram que lidar com 15 anos de legado.

    
por Eugene Ryzhikov 04.07.2011 / 18:15
fonte
1

O Javadocs fornece a saída nesse formato e é publicado nesse endereço, eu acho que ninguém realmente viu a necessidade de melhoria, mas agora que você mencionou isso, é um projeto paralelo interessante. Eu pesquisei se havia alguma interface "melhor", mas não tive sorte.

Você pode executar o javadoc -h para ver quais opções extras estão disponíveis se você quiser gerar novamente os javadocs. Alguns interessantes são fornecer cabeçalho / rodapé e links personalizados para a fonte, mas nada no sentido que você está perguntando.

    
por rajasaur 04.07.2011 / 17:32
fonte
1

Essas páginas HTML foram criadas usando as ferramentas Javadoc , forma padrão de construir documentação em Java.

Não sei se existem outras páginas da Web com uma formatação melhor da API, mas se isso ajudar você com qualquer coisa, e você estiver usando um IDE e o SDK, poderá ver o código-fonte da maioria dos arquivos lá.

    
por Luciano 04.07.2011 / 17:33
fonte
0

O JavaDoc foi projetado para ser o menor denominador comum. Praticamente qualquer navegador da Web pode exibi-lo, mesmo sem suporte a JavaScript.

Se você estiver procurando por acesso mais rápido e recursos de pesquisa, poderá acessar o JavaDoc a partir de um IDE, como o Eclipse.

    
por Tony the Pony 06.07.2011 / 09:21
fonte