Em JavaDoc a tag @since

Próximas questões
Com base no mesmo assunto
Ano: 2011 Banca: FCC Órgão: TRE-AP Prova: FCC - 2011 - TRE-AP - Programador de computador |
Q125864 Programação
Em JavaDoc a tag @since
Alternativas

Gabarito comentado

Confira o gabarito comentado por um dos nossos professores

A alternativa correta é a A, que afirma que a tag @since do JavaDoc especifica que o componente sendo comentado é válido a partir de uma determinada versão.

Para contextualizar, JavaDoc é uma ferramenta de documentação automática para o código-fonte Java. Ele é usado para gerar uma documentação em formato HTML a partir de comentários escritos no próprio código. Os desenvolvedores usam uma série de tags especiais que são interpretadas pelo JavaDoc para compor essa documentação.

A tag @since é usada especificamente para indicar desde qual versão do software ou da API (biblioteca, framework, etc.) um determinado elemento (como uma classe, método ou campo) está disponível. Isso é útil tanto para os usuários da API, que podem saber se um recurso é novo ou não, quanto para desenvolvedores, que podem rastrear a evolução do código.

Um exemplo prático seria:

/**
 * Calcula a soma de dois inteiros.
 * 
 * @param x o primeiro inteiro.
 * @param y o segundo inteiro.
 * @return a soma de x e y.
 * @since 1.0
 */
public int somar(int x, int y) {
    return x + y;
}

As demais alternativas não descrevem corretamente o propósito da tag @since no JavaDoc:

  • A alternativa B pode ser confundida com a tag @deprecated, que indica que um método ou atributo não é mais suportado.
  • A alternativa C se relaciona mais com a tag @param, que descreve os parâmetros de um método.
  • A alternativa D se confundiria com a tag @see, utilizada para indicar uma referência ou associação a outro elemento da documentação.
  • A alternativa E seria a tag @throws ou @exception, que documenta as exceções que podem ser lançadas por um método.

Compreender as tags do JavaDoc é essencial para a manutenção de uma documentação clara e eficaz, que facilita a compreensão e o uso de código por outros desenvolvedores ou por você mesmo no futuro.

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

Javadoc: http://pt.wikipedia.org/wiki/Javadoc

Tags:
Tag Descrição @author Nome do desenvolvedor @deprecated Marca o método como deprecated. Algumas IDEs exibirão um alerta de compilação se o método for chamado. @exception Documenta uma exceção lançada por um método — veja também @throws. @param Define um parâmetro do método. Requerido para cada parâmetro. @return Documenta o valor de retorno. Essa tag não deve ser usada para construtores ou métodos definidos com o tipo de retorno void. @see Documenta uma associação a outro método ou classe. @since Documenta quando o método foi adicionado a a classe. @throws Documenta uma exceção lançada por um método. É um sinônimo para a @exception introduzida no Javadoc 1.2. @version Exibe o número da versão de uma classe ou um método.

Clique para visualizar este comentário

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