Questão 316318

• Banca: FCC
• Órgão: TRE-RN
• Ano: 2011
• Provas: FCC - 2011 - TRE-RN - Programador de computador
• Disciplina: Programação
• Assuntos: Java; Linguagens de programação

Em relação ao Javadoc é correto afirmar:

• A. a declaração pode conter quantas linhas forem necessárias para fornecer uma descrição da classe para que qualquer programador possa utilizar.
• B. obriga-se o uso de aspas em cada linha entre /** e */.
• C. os comentários de documentação aceitam tags de HTML, quando eles são precedidos do símbolo @.
• D. import é a única instrução que pode estar entre um comentário de classe e a declaração de classe.
• E. os comentários de documentação podem ser colocados na linha antes de uma declaração de classe, uma declaração de interface e um construtor, apenas.

Gabarito: A

Comentários

• Javadoc é um gerador de documentação para documentar a API dos programas em Java, a partir do código-fonte. O resultado é expresso em HTML. É constituído, basicamente, por algumas marcações inseridas nos comentários do programa.

  Este sistema é o padrão de documentação de classes em Java, e muitas IDEs desta linguagem irão automaticamente gerar um Javadoc em HTML.
  
  Fonte: Wikipédia.

• a) Correto, o javadoc não limita a quantidade de linhas que você pode documentar algum elemento do código fonte.
  b) Errado, não há necessidade de colocar " " entre /** e */.
  c) Errado, comandos precedidos de @ são tags que o javadoc identifica para gerar uma html mais detalhada.
  d) Errado, acredito que possam conter outras instruções.
  e) Errado, os comentários de documentação podem ser colocados em praticamente todos os elementos do código fonte.
• b) Não é necessário o uso de aspas
  c) @ são anotações que ajudam a qualificar melhor a informação contida nos comentários. Por exemplo @author, @link, @version
  d) package também pode estar entre um comentário e uma declaração de uma classe.
  e) os comentários podem ser colocados em qualquer lugar do código.