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.