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
- A)V, V, F, F.
Errada, porque a primeira afirmativa é falsa e a terceira também é falsa, então a sequência não pode ser V, V, F, F.
- B)V, F, V, F.
Errada, porque a segunda afirmativa é verdadeira e a quarta também é verdadeira, logo não é V, F, V, F.
- C)F, V, F, V.
Certa, pois a sequência correta é F, V, F, V: @param e @return foram confundidos, @deprecated está correta, @since não se limita a classes e métodos, e @see realmente cria referência.
- D)F, F, V, V.
Errada, porque a segunda afirmativa não é falsa e a primeira também não é verdadeira, então a sequência F, F, V, V não confere.
Gabarito: C
O JavaDoc é o jeito padrão do Java de documentar código com comentários especiais, geralmente começando com /** ... */. Ele ajuda muito quando você quer entender rapidamente o que uma classe, método ou atributo faz sem precisar abrir o código inteiro e caçar contexto como se fosse uma investigação policial. Nesta questão, o ponto principal é conhecer as tags mais cobradas. Para parâmetros de método, a tag correta é @param. Já para o valor de retorno, a tag usada é @return, e não @result. Então a primeira afirmativa fica falsa porque trocou a tag de retorno. A segunda está certa: @deprecated serve exatamente para avisar que aquele recurso está obsoleto e não deve mais ser usado, embora ainda exista por compatibilidade. A terceira também está falsa, porque @since não é restrita só a classes e métodos; ela pode aparecer em vários elementos documentáveis, como classes, interfaces, campos, métodos e até pacotes. Por fim, a quarta é verdadeira: @see é usada para criar referência cruzada, apontando para outro elemento, link ou texto de apoio. Assim, a sequência correta é F, V, F, V, que corresponde à alternativa C.