Adicionar comentários ao código java
Video: Como Adicionar Comentários no Construtor de Páginas | LeadLovers
Conteúdo
Este anúncio Java tem uma versão melhorada de um programa de amostra. Além de todas as expressões, identificadores, e pontuação, ele tem o texto que significou para os seres humanos a ler.
/ ** Listagem 3-6 em "Java For Dummies, 6ª Edição"** de Copyright 2014 Wiley Publishing, Inc. * Todos os direitos reservados. * // *** O Exibidor de classe exibe texto * na tela do computador. ** @author Barry Burd * @version 1.0 10/24/13 * @see java .lang.System * / Exibidor classe pública {/ *** o método principal é onde * execução do código começa. ** args @param (ver Capítulo 11). * / public void main (args String []) estáticos { System.out.println ("Eu amo Java!")- //EU? Você?}}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: As cinco primeiras linhas da forma de listagem um tradicional comente. O comentário começa com / * e termina com * /. Tudo entre a abertura / * e o fechamento * / é apenas para os olhos humanos. Não há informações sobre “Java For Dummies, 6ª Edição” ou Wiley Publishing, Inc. é traduzida pelo compilador.
A segunda, terceira, quarta, e quinta linhas 3-6 na Listagem tem um asterisco (*) adicionais. Eles são chamados de extra porque estes asteriscos não são necessários quando você cria um comentário. Eles simplesmente fazer o comentário bonita.
Fim-de-line comentários: O texto //EU? Você? na listagem é uma fim da linha comente. Um comentário de fim de linha começa com duas barras e vai até o final de uma linha de tipo. Mais uma vez, o compilador não traduzir o texto dentro do comentário de fim de linha.
comentários Javadoc: UMA javadoc comentário começa com uma barra e dois asteriscos (/ **). A listagem tem dois comentários Javadoc - um com o texto A classe Displayer. . . e outro com o texto O método principal é onde. . . .
Um comentário javadoc é um tipo especial de comentário tradicional. Um comentário javadoc é feito para ser lido por pessoas que nunca sequer olhar para o código Java. Mas isso não faz sentido. Como você pode ver os comentários javadoc?
Bem, um certo programa chamado javadoc (O que mais?) Pode encontrar todos os comentários Javadoc na listagem e transformar esses comentários em uma página web de boa aparência. Esta figura mostra a página.
comentários Javadoc são grandes. Aqui estão algumas grandes coisas sobre eles:
A única pessoa que tem que olhar para um pedaço de código Java é o programador que escreve o código. Outras pessoas que usam o código pode descobrir o que o código faz visualizando a página web gerado automaticamente.
Video: 006 Adicionar comentários ao código javascript
Porque outras pessoas não olhar para o código Java, outras pessoas não fazer alterações no código Java. (Em outras palavras, outras pessoas não introduzir erros no código Java existente.)
Porque outras pessoas não olhar para o código Java, outras pessoas não têm de decifrar o funcionamento interno do código Java. Todas essas pessoas precisam de saber sobre o código é o que lêem na página web do código.
O programador não cria duas coisas distintas - algum código Java até aqui e alguma documentação sobre o código de lá. Em vez disso, o programador cria um pedaço de código Java e incorpora a documentação (na forma de comentários Javadoc) direito dentro do código.
O melhor de tudo, a geração de páginas da web a partir de comentários Javadoc é automático. Assim, a documentação de todos tem o mesmo formato. Não importa cujo código Java que você usa, você descobrir sobre esse código, lendo uma página como a da figura. Isso é bom porque o formato é familiar para quem usa Java.