No processo de desenvolvimento de softwares uma etapa fundam...

Próximas questões
Com base no mesmo assunto
Q2005914 Programação
No processo de desenvolvimento de softwares uma etapa fundamental é a documentação do código, independente do paradigma ou da plataforma de desenvolvimento utilizada. Essa documentação, quando bem organizada, auxilia um time de desenvolvimento no conhecimento sobre o funcionamento de uma classe, por exemplo. Na linguagem Java, há um recurso do próprio JDK que auxilia o desenvolvedor no processo de criação e manipulação desses comentários – o JavaDoc, que funciona inserindo textos explicativos em um formato de comentário especial com função de apresentar os recursos. Sobre o recurso em questão, marque V para as afirmativas verdadeiras e F para as falsas.
( ) Em um método a tag @param pode ser utilizada para apresentar a descrição do parâmetro; a tag @result pode ser utilizada para especificar seu retorno. ( ) A tag @deprecated pode ser utilizada para indicar que um método está obsoleto. ( ) A tag @since, utilizada para indicar desde quando o recurso está disponível na aplicação, pode ser aplicada apenas em classes e métodos. ( ) A tag @see pode ser utilizada em uma interface para adicionar um link ou entrada de texto que aponta para uma referência, podendo ser consultada para melhorar a compreensão do que está sendo comentado.
A sequência está correta em 
Alternativas

Gabarito comentado

Confira o gabarito comentado por um dos nossos professores

Gabarito comentado:

A alternativa correta é a C - F, V, F, V.

Justificativa:

  • O uso da tag @param é correto para descrever um parâmetro de um método. Entretanto, não existe a tag @result em Javadoc; o correto para descrever o valor de retorno de um método é @return. Portanto, essa afirmação é falsa (F).

  • A tag @deprecated é de fato utilizada para indicar que um método (ou qualquer outro elemento de API) está obsoleto e que existe uma alternativa preferível para uso futuro. Essa afirmação é verdadeira (V).

  • A tag @since pode ser utilizada não só em classes e métodos, mas também em campos, para indicar a versão em que o elemento foi adicionado. Portanto, a limitação para uso apenas em classes e métodos torna esta afirmação falsa (F).

  • Por fim, a tag @see permite adicionar um link ou texto referencial que pode ser usado para referenciar outras partes da documentação ou recursos externos, o que pode ser feito em interfaces, classes, métodos, entre outros. Isso torna esta afirmação verdadeira (V).

A documentação de código é uma prática essencial para o desenvolvimento e manutenção efetiva de softwares. Javadoc é uma ferramenta poderosa para criar essa documentação em Java, permitindo que os desenvolvedores anotem suas classes, interfaces, métodos e campos com comentários especiais que, em seguida, podem ser convertidos em uma forma legível de documentação HTML. Compreender essas tags e como utilizá-las corretamente é fundamental para a comunicação eficaz da funcionalidade e uso das partes do código entre os membros de uma equipe e para futuros mantenedores do código.

Clique para visualizar este gabarito

Visualize o gabarito desta questão clicando no botão abaixo

Comentários

Veja os comentários dos nossos alunos

Não entendi o erro da primeira a notação @param não é usada para especificar a descrição do parâmetro? integer, String, etc. Ou será que o erro está no português?

Clique para visualizar este comentário

Visualize os comentários desta questão clicando no botão abaixo