Java/Blocos e comentários de programação

Blocos de programação

Blocos de programação são aglomerados de instruções e declarações que têm escopo conjunto. Ou seja, as variáveis definidas como locais dentro de um bloco somente serão presentes dentro deste bloco assim como as instruções ali presentes. Os blocos de programação são delimitados por chaves e podem ser aninhados - colocados um dentro dos outros. Por exemplo:

{
   // este é um bloco de programação
   int a=10;
}

Outro exemplo:

{
   // este é um bloco de programação
   int a=10;
   int b=1;
   if (b==3) {
       // este é um bloco que é executado se b for igual a 3
       b=a*10;
   } else {
       // este é um bloco que é executado se b for diferente de 3
       int a=100;
       b=a*10;
   }
   System.out.println("O valor de b é " + b);
}

Comentários

Comentários, como o próprio nome instiga, são notas que podem ser incluídas no código fonte para descrever o que se quiser. Assim, não modificam o programa executado e servem somente para ajudar o programador a melhor organizar os seus códigos. Os comentários em Java seguem a mesma sintaxe da linguagem C++.

/* */

Comentários de uma ou mais linhas podem ser iniciados por /* e terminados por */ . Por exemplo:

{
   int a=10;
   int b;
   b=a*2;
   /* a partir deste ponto, deve-se começar a exibir 
   os resultados na tela do usuário */
}

//

Comentários que terminam no final da linha são indicados com // . Pode ser usados desde o ínicio da linha ou colocados depois do código funcional, desde que não haja um caractere de quebra de linha no comentário. Por exemplo:

{
   int a=10; // declaração de a como int e atribuição do valor 10
   int b; //declaração de b
   // a próxima linha calcula b como sendo duas vezes a
   b=a*2;
   // daqui em diante deve-se exibir os resultados na tela
}

Comentários para facilitar a documentação automática

/** */

Pode-se utilizar comentários de várias linhas em que a primeira linha se inicia com /** e a última termina com */. Ou seja, na seguinte sintaxe:

 //** Comentário
 * comentário
 * comentário
 * ...
 */

Observação: a documentação é gerada através do aplicativo javadoc.