Como usar Comentários em Java Progamming

Na programação Java, há uma diferença entre o código escrito apenas para máquinas e código escrito para ser lido por pessoas. Esta primeira listagem é muito simples e é destinado apenas para máquinas.

pacote MyFirstJavaClass classe org.allyourcode.myfirstproject-pública {/ *** args @param * / public static void main (String [] args) {javax.swing.JOptionPane.showMessageDialog (null, "Olá") -}}

Esta segunda lista tem uma versão melhorada do código na primeira listagem. Além de todas as palavras-chave, identificadores e pontuação, esta segunda lista tem o texto que significou para os seres humanos a ler.

/ ** Listagem 5-2 em * "Java para desenvolvedores Android For Dummies" ** de Copyright 2013 Wiley Publishing, Inc. * Todos os direitos reservados. * /org.allyourcode.myfirstproject- pacote/ *** MyFirstJavaClass exibe uma caixa de diálogo * na tela do computador. ** @author Barry Burd * @version 1.0 02/02/13 * @see java.swing.JOptionPane * /MyFirstJavaClass classe pública { / *** O ponto de execução de partida. ** Args @param * (Não usado.) * /void main (String [] args) public static {javax.swing.JOptionPane.showMessageDialog (null, "Olá") - //nulo?}}

UMA comente é uma seção especial do texto dentro de um programa cujo objetivo é ajudar as pessoas a entender o programa. Um comentário é parte da documentação de um bom programa.

A linguagem de programação Java tem três tipos de comentários:

  • Comentários tradicionais: Tudo entre a abertura / * e o fechamento * / é apenas para os olhos humanos.

    Linhas 2-6 na segunda lista tem asteriscos extras (*). Eles são extra porque esses asteriscos não são necessárias quando você cria um comentário. Eles só fazer o comentário bonita. Eles são incluídos na lista porque, por algum motivo, a maioria dos programadores Java insistem em adicionar estes asteriscos extra.

  • Fim-de-line comentários: O texto //nulo? no segundo perfil é um fim da linha comentar - começa com duas barras e vai para o fim de uma linha de texto. Mais uma vez, o compilador não traduzir o texto dentro de um comentário de fim de linha.

  • comentários Javadoc: UMA javadoc comentário começa com uma barra e dois asteriscos (/ **). A segunda lista tem dois comentários javadoc - um com o texto MyFirstJavaClass exibe uma caixa de diálogo. . . e outro com o texto O ponto de partida. . . .

    UMA javadoc comentário é um tipo especial de comentário tradicional: É concebido para ser lido por pessoas que nunca sequer olhar para o código Java.

    Espere - que não faz sentido. Como você pode ver os comentários javadoc na listagem se você nunca olhar para a lista?

    Bem, com alguns pontos e cliques, você pode encontrar todos os comentários Javadoc na segunda lista e transformá-los em uma página web de boa aparência, como mostrado na figura.

    image0.jpg

Para tornar as páginas de documentação para o seu próprio código, siga estes passos:

  1. Coloque comentários Javadoc em seu código.

  2. A partir do menu principal, em Eclipse, escolha Project-Gerar Javadoc.

    Como resultado, a caixa de diálogo Javadoc Geração aparece.

  3. Na caixa de diálogo Javadoc Geração, selecione o projeto Eclipse cujo código que deseja documentar.

  4. Ainda na caixa de diálogo Javadoc Generation, observe o nome da pasta no campo Destino.

    O computador coloca as páginas de documentação recém-criados nessa pasta. Se preferir uma pasta diferente, você pode alterar o nome da pasta neste campo Destino.

  5. Clique em Concluir.

    Como resultado, o computador cria as páginas de documentação.

Se você visitar a pasta de destino e clique duas vezes no novo index.html ícone de arquivo, você verá seus belos (e informativas) páginas de documentação.

Você pode encontrar as páginas de documentação para as classes API built-in do Java, visitando o site da Oracle Documentação Java SE at a Glance página. API do Java contém milhares de aulas, por isso não memorizar os nomes das classes e seus métodos. Em vez disso, você simplesmente visitar estas páginas de documentação on-line.

Semelhante

menu