Os comentários são informações, textos,
que o programador pode inserir na própria programação Java.
Para quê? Para simplesmente informar a outros programadores
ou documentar a respeito do que está sendo feito.
Eu também posso usar um comentário
para fazer com que uma linha da programação
não seja nem compilada nem executada.
Basta, com isso, usar as tags de comentário.
Existem três formas de usar comentários.
Eu posso usar "//" para simplesmente comentar uma linha.
No exemplo aqui, eu vou colocar esse comentário simples
logo acima da declaração dos atributos
para falar que esses atributos são atributos de classes.
Ou seja, esse "//" vai comentar a linha do começo até o final daquela linha.
Assim como eu também posso usar para comentar o código que está descrito.
Também podemos utilizar o comentário
para comentar mais de uma linha.
Para isso, eu utilizo "/*" no começo da linha
que eu quero começar a comentar, e o "*/" para finalizar.
No exemplo aqui, eu vou comentar o construtor de classe.
Eu coloco "/*", coloco o texto que eu quero,
"Construtor de classe",
e posso citar linhas abaixo.
A partir do momento que eu dou o Enter,
o Java já completa outros asteriscos para poder fazer esse comentário.
Construtor de classe, Classe Conta.
Pronto. Eu fiz um comentário de mais de uma linha.
Esse comentário de mais de uma linha,
eu também posso fazer para comentar um código Java.
Coloco / no começo, / no final,
e ele comenta, ou seja, ele ignora aquele código Java
de compilação e execução.
Mas você pode se perguntar:
"Mas por que eu vou comentar um código em Java?".
Código em Java é normalmente comentado
quando eu quero deixar o registro que aquele código já existiu
ou simplesmente quando eu quero testar sem aquele código Java.
Então, eu comento e depois descomento novamente.
Um detalhe interessante:
para quem gosta de programar de forma otimizada,
eu também tenho atalhos para fazer comentários de mais de uma linha.
Basta você selecionar o trecho no qual você quer realizar o comentário,
ir à opção Ctrl + Shift + /, e ele vai realizar o comentário,
e Ctrl + Shift + \, ele retira aquele comentário.
E o terceiro tipo de comentário
é o comentário de documentação,
onde eu posso fazer toda uma documentação do meu código
e gerar isso para a web.
Como eu faço isso?
Basta eu colocar /** e dar um Enter.
Tudo que eu escrever dentro desse trecho então,
poderá ser passível de geração de documentação.
Vou colocar aqui em cima do método depositar,
vou informar que o método chama-se "Depositar da classe Conta",
vou falar que ele recebe o parâmetro valor,
que é o valor a ser depositado.
Pronto. Eu fiz um comentário documental,
onde eu posso gerar toda uma documentação para outros programadores
e também para que o registro fique dentro da empresa.
Note que, ao colocar o comentário, ele faz a verificação ortográfica.
Então, ficam alguns erros, fica um vermelhinho ali na tela.
Se você se incomoda com essas verificações ortográficas
assim como eu me incomodo, tenho a dica certa.
Basta ir à opção Window, Preferences,
digitar a palavra "spelling",
e aí, dentro de Dictionaries,
você vai verificar que está em inglês americano.
Basta você selecionar none ou colocar a definição da linguagem que você quer.
Ao selecionar none, eu dou um ok.
Quando eu retornar ao meu código
e fizer a primeira alteração e salvar o código,
a revisão ortográfica é automaticamente desabilitada.