1
00:00:05,020 --> 00:00:07,540
Os comentários são 
informações, textos,

2
00:00:07,540 --> 00:00:11,360
que o programador pode inserir 
na própria programação Java.

3
00:00:11,360 --> 00:00:14,890
Para quê? Para simplesmente
informar a outros programadores

4
00:00:14,890 --> 00:00:18,310
ou documentar a respeito
do que está sendo feito.

5
00:00:18,310 --> 00:00:20,160
Eu também posso usar
um comentário

6
00:00:20,160 --> 00:00:22,530
para fazer com que uma linha
da programação

7
00:00:22,530 --> 00:00:25,140
não seja nem compilada
nem executada.

8
00:00:25,140 --> 00:00:27,960
Basta, com isso, usar
as tags de comentário.

9
00:00:27,960 --> 00:00:30,540
Existem três formas
de usar comentários.

10
00:00:30,540 --> 00:00:35,050
Eu posso usar "//"
para simplesmente comentar uma linha.

11
00:00:35,050 --> 00:00:38,364
No exemplo aqui, eu vou
colocar esse comentário simples

12
00:00:38,364 --> 00:00:40,744
logo acima da declaração
dos atributos

13
00:00:40,744 --> 00:00:45,184
para falar que esses atributos
são atributos de classes.

14
00:00:45,184 --> 00:00:50,083
Ou seja, esse "//" vai comentar a linha 
do começo até o final daquela linha.

15
00:00:50,083 --> 00:00:54,354
Assim como eu também posso usar
para comentar o código que está descrito.

16
00:00:54,354 --> 00:00:56,318
Também podemos 
utilizar o comentário

17
00:00:56,318 --> 00:00:58,468
para comentar
mais de uma linha.

18
00:00:58,468 --> 00:01:01,723
Para isso, eu utilizo 
"/*" no começo da linha

19
00:01:01,723 --> 00:01:06,034
que eu quero começar a comentar,
e o "*/" para finalizar.

20
00:01:06,034 --> 00:01:09,834
No exemplo aqui, eu vou
comentar o construtor de classe.

21
00:01:09,834 --> 00:01:14,464
Eu coloco "/*", coloco
o texto que eu quero,

22
00:01:14,464 --> 00:01:16,854
"Construtor de classe",

23
00:01:16,854 --> 00:01:18,864
e posso citar 
linhas abaixo.

24
00:01:18,864 --> 00:01:20,284
A partir do momento 
que eu dou o Enter,

25
00:01:20,284 --> 00:01:25,502
o Java já completa outros asteriscos
para poder fazer esse comentário.

26
00:01:25,502 --> 00:01:30,194
Construtor de classe, 
Classe Conta.

27
00:01:30,194 --> 00:01:33,304
Pronto. Eu fiz um comentário
de mais de uma linha.

28
00:01:33,304 --> 00:01:35,194
Esse comentário 
de mais de uma linha,

29
00:01:35,194 --> 00:01:38,024
eu também posso fazer
para comentar um código Java.

30
00:01:38,024 --> 00:01:42,084
Coloco /<i> no começo,
</i>/ no final,

31
00:01:42,084 --> 00:01:45,734
e ele comenta, ou seja,
ele ignora aquele código Java

32
00:01:45,734 --> 00:01:47,444
de compilação
e execução.

33
00:01:47,444 --> 00:01:48,574
Mas você pode
se perguntar:

34
00:01:48,574 --> 00:01:51,184
"Mas por que eu vou comentar
um código em Java?".

35
00:01:51,184 --> 00:01:52,824
Código em Java é 
normalmente comentado

36
00:01:52,824 --> 00:01:56,154
quando eu quero deixar o registro 
que aquele código já existiu

37
00:01:56,154 --> 00:02:00,214
ou simplesmente quando eu quero
testar sem aquele código Java.

38
00:02:00,214 --> 00:02:03,294
Então, eu comento e depois 
descomento novamente.

39
00:02:03,294 --> 00:02:04,404
Um detalhe interessante:

40
00:02:04,404 --> 00:02:07,104
para quem gosta de programar
de forma otimizada,

41
00:02:07,104 --> 00:02:10,937
eu também tenho atalhos para fazer 
comentários de mais de uma linha.

42
00:02:10,937 --> 00:02:14,404
Basta você selecionar o trecho 
no qual você quer realizar o comentário,

43
00:02:14,404 --> 00:02:19,041
ir à opção Ctrl + Shift + /,
e ele vai realizar o comentário,

44
00:02:19,041 --> 00:02:22,898
e Ctrl + Shift + \, ele 
retira aquele comentário.

45
00:02:22,898 --> 00:02:24,581
E o terceiro tipo
de comentário

46
00:02:24,581 --> 00:02:26,901
é o comentário
de documentação,

47
00:02:26,901 --> 00:02:30,411
onde eu posso fazer toda
uma documentação do meu código

48
00:02:30,411 --> 00:02:32,071
e gerar isso
para a web.

49
00:02:32,071 --> 00:02:33,208
Como eu faço isso?

50
00:02:33,208 --> 00:02:36,998
Basta eu colocar /** 
e dar um Enter.

51
00:02:36,998 --> 00:02:39,532
Tudo que eu escrever
dentro desse trecho então,

52
00:02:39,532 --> 00:02:42,998
poderá ser passível 
de geração de documentação.

53
00:02:42,998 --> 00:02:45,962
Vou colocar aqui em cima
do método depositar,

54
00:02:45,962 --> 00:02:50,509
vou informar que o método
chama-se "Depositar da classe Conta",

55
00:02:50,509 --> 00:02:52,869
vou falar que ele recebe
o parâmetro valor,

56
00:02:52,869 --> 00:02:55,554
que é o valor
a ser depositado.

57
00:02:55,554 --> 00:02:58,489
Pronto. Eu fiz 
um comentário documental,

58
00:02:58,489 --> 00:03:02,489
onde eu posso gerar toda uma documentação 
para outros programadores

59
00:03:02,489 --> 00:03:05,314
e também para que o registro 
fique dentro da empresa.

60
00:03:05,314 --> 00:03:09,680
Note que, ao colocar o comentário,
ele faz a verificação ortográfica.

61
00:03:09,680 --> 00:03:13,284
Então, ficam alguns erros,
fica um vermelhinho ali na tela.

62
00:03:13,284 --> 00:03:16,540
Se você se incomoda com essas 
verificações ortográficas

63
00:03:16,540 --> 00:03:19,664
assim como eu me incomodo,
tenho a dica certa.

64
00:03:19,664 --> 00:03:23,210
Basta ir à opção Window,
Preferences,

65
00:03:23,210 --> 00:03:27,103
digitar 
a palavra "spelling",

66
00:03:27,103 --> 00:03:29,293
e aí, dentro 
de Dictionaries,

67
00:03:29,293 --> 00:03:32,443
você vai verificar que está
em inglês americano.

68
00:03:32,443 --> 00:03:37,341
Basta você selecionar none ou colocar 
a definição da linguagem que você quer.

69
00:03:37,341 --> 00:03:40,381
Ao selecionar none, 
eu dou um ok.

70
00:03:40,381 --> 00:03:41,731
Quando eu retornar 
ao meu código

71
00:03:41,731 --> 00:03:44,061
e fizer a primeira alteração
e salvar o código,

72
00:03:44,061 --> 00:03:47,716
a revisão ortográfica
é automaticamente desabilitada.