-
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.
