naming em Java
De a um numero um nome claro para usar a mesma grafia de novo. Em Yard.java, guarde int ticketCount = 4; e imprima ticketCount. Compile com javac Yard.java e rode java Yard. A tela deve mostrar 4. Uma segunda demo guarda 4 sob ticketCount e 9 sob TicketCount, depois imprime os dois nomes. A tela deve mostrar 4, depois 9, porque essas grafias sao nomes diferentes em Java. Deixe as regras de formatting para a pagina seguinte — esta licao e naming exato, nao estilo de espacamento.
Guarde um nome claro
A pagina de Javadoc rotulou o contrato de um metodo. Esta pagina escolhe nomes legiveis para valores que voce guarda. Abra Yard.java. Mantenha o nome da classe publica Yard. Apague demos sobrando de add se enterrarem a historia de naming, rotulos println de debug que so cacam uma soma errada, demos sobrando de equals, e qualquer Scanner de teclado. O programa nao deve esperar digitacao. Nenhuma linha import e necessaria.
Dentro de Yard.main, escreva um nome em camelCase — comece com letra minuscula, depois capitalize as palavras seguintes no mesmo nome:
int ticketCount = 4;
System.out.println(ticketCount);
A grafia ticketCount e o nome. O valor 4 fica sob essa grafia. Quando voce imprime o nome, Java procura essa grafia exata e escreve o numero guardado.
public class Yard {
public static void main(String[] args) {
int ticketCount = 4;
System.out.println(ticketCount);
}
}
Da pasta que guarda Yard.java, rode javac Yard.java. Quando parenteses, chaves e ponto e virgula baterem, javac nao escreve linha propria. Depois rode java Yard — nao java Yard.java. Tire o final .java do comando de execucao. Mantenha uma classe publica no arquivo para o nome bater com Yard.
A tela mostra 4. Percorra a execucao uma vez. Java comeca em Yard.main. A primeira linha guarda quatro sob ticketCount. A linha de print procura ticketCount e escreve 4. Nenhum segundo nome aparece nesta primeira demo. A busca e exata. TicketCount nao e o nome que voce guardou neste primeiro programa.
Diga a regra iniciante enquanto olha a tela: escolha uma grafia, guarde o valor, peca a mesma grafia. Nao invente aulas longas de formatting nesta pagina. Formatting espera a proxima licao.
Se ainda vir 12 de uma demo Javadoc de add, mude para o arquivo de ensino de naming e rode java Yard de novo. Se voce escrever ticket count = 4 com um espaco no meio, isso nao e um nome so. Mantenha a forma camelCase como uma unica palavra.
Uma letra maiuscula cria um segundo nome
Um segundo programa mantem ticketCount e adiciona outro nome que difere so por uma letra maiuscula. Java trata ticketCount e TicketCount como dois nomes. Guarde 4 sob a primeira grafia e 9 sob a segunda, depois imprima as duas.
public class Yard {
public static void main(String[] args) {
int ticketCount = 4;
int TicketCount = 9;
System.out.println(ticketCount);
System.out.println(TicketCount);
}
}
Compile com javac Yard.java, depois rode java Yard. A tela mostra 4, depois 9. O primeiro print le ticketCount. O segundo print le TicketCount. Nao e a mesma busca. Mudar o caso de uma letra cria um nome novo. Iniciantes muitas vezes esperam que a segunda grafia atualize a primeira. Nesta pagina isso nao acontece. Cada grafia guarda o proprio valor.
Leia as duas declaracoes mais uma vez. O nome da classe Yard continua PascalCase com a primeira letra maiuscula — isso bate com o nome do arquivo. Os nomes de valor em main mostram o contraste: camelCase ticketCount para uma variavel comum, e um TicketCount deliberadamente diferente so para provar sensibilidade a maiusculas. No codigo do dia a dia voce ainda prefere camelCase para variaveis; o segundo nome existe aqui como contraste de ensino, nao como estilo para copiar em todo lugar.
Se demos Javadoc sobrando ainda ficarem por perto, guarde-as como historia. Para esta licao rode o arquivo de ensino de naming para a tela mostrar contagens nomeadas, nao so um resultado add documentado. Se javac reclamar de classes publicas duplicadas, mantenha so Yard public.
Nomes que voce nao deve comecar
Um nome nao deve comecar com um digito. Uma linha como int 4tickets = 4; nao esta nestas demos de proposito. Essa forma e ilegal em Java, entao javac rejeita antes de o programa rodar. No trabalho real, mantenha o primeiro caractere uma letra ou um sublinhado. As demos que funcionam nesta pagina comecam com t ou T.
Um espaco dentro de um nome tambem falha. ticket count sao dois tokens, nao um nome. CamelCase une as palavras sem espacos: ticketCount. Mantenha esse habito quando nomear a proxima variavel por conta propria.
Voce nao precisa de uma tabela nesta pagina. As duas telas sao o mapa: um nome imprime 4; dois nomes com maiusculas diferentes imprimem 4 depois 9.
Comparado com rotulos Javadoc
Na pagina de Javadoc, @param e @return rotularam o contrato de um metodo. Nesta pagina, a grafia da variavel e o contrato para buscar o valor de novo. Voce ainda compila Yard.java e roda java Yard. O habito novo e escolher um nome camelCase claro e respeitar o caso exato quando ler de volta.
Comentarios Javadoc nao substituem bons nomes. Um nome claro e um comentario claro podem ficar juntos depois. Esta licao isola naming para a tela provar busca sensivel a maiusculas sem misturar tags de documentacao na demo.
Se um arquivo add sobrando ainda estiver aberto, voce pode ver so 12. Mude para o arquivo de naming para que main guarde e imprima ticketCount. Mantenha guias de estilo de formatting fora desta pagina. Mantenha entrada de teclado fora desta pagina.
Antes de formatting
Voce pode guardar ticketCount como 4 e ver 4 na tela. Voce pode adicionar TicketCount como 9 e ver 4 depois 9. Compile Yard.java e rode java Yard para cada demo mantida por vez. A grafia decidiu qual valor apareceu. A pagina seguinte e formatting, onde voce arruma como o codigo e espacado e organizado para leitores.
Mantenha a demo de um nome para um primeiro print claro. Mantenha a demo de dois nomes para um contraste de caso claro. Mantenha arquivos de formatting fora desta pagina ate aquela licao. Esses tres habitos sao o checkpoint antes de seguir. Quando a mesma grafia devolve o valor que voce guardou — e uma letra maiuscula diferente nao rouba esse valor — naming fez o trabalho desta licao e voce esta pronto para o proximo topico sobre formatting.
Uma ultima passagem pela pasta: um Yard public, nomes claros em main, sem espera de teclado, sem regras de formatting forcadas. Rode javac Yard.java e java Yard mais uma vez na demo que voce mantem aberta. Se a tela ainda bater com os nomes que voce digitou, a licao de naming esta solida e o curso pode ir para formatting na pagina seguinte. Prefira uma ideia de naming por execucao para que cada tela ensine um contraste.
🧠 Teste Seu Conhecimento
Teste Seu Conhecimento
Desafie-se com este questionário interativo e veja o quão bem você entende o tópico
📝 Instruções
- Leia cada pergunta cuidadosamente
- Selecione a melhor resposta para cada pergunta
- Você pode refazer o quiz quantas vezes quiser
- Seu progresso será mostrado no topo