7

Qual é a diferença entre @Deprecated como anotação na classe e @deprecated na documentação da mesma? Quando usar uma e quando usar a outra?

/**
 * Combo box that shows the status of playlist items.
 *
 * @deprecated Use CustomComboBox from Custom-UI.
 */
@Deprecated
public class CustomComboBox extends JComboBox {}

Obrigado.

1

1 Resposta 1

9

@Deprecated é uma anotação interpretada em tempo de compilação, para indicar que o método/classe esta depreciado. Isso irá gerar warnings e marcações na IDE quando você utilizar algum recurso depreciado.

@deprecated é uma tag de javadoc, para documentar algum detalhe sobre a depreciação do método/classe. Normalmente nessa documentação é explicado o porque da depreciação e o que utilizar como substituição. Só faz sentido utilizar esta documentação se você de fato possui o elemento sendo documentado marcado como @Deprecated

Por exemplo:

/**
 * Método que faz alguma coisa
 * @deprecated Esse método possui uma falha muito grave e não deve ser utilizado, agora deve-se utilizar {@link #metodoFazAlgoMelhorado()}.
 */
@Deprecated
public void metodoFazAlgo() {
    // ...
}

public void metodoFazAlgoMelhorado() {
    // ...
}
1
  • ótimo! muito obrigado Commented 28/05/2019 às 20:36

Você deve fazer log-in para responder a esta pergunta.

Esta não é a resposta que você está procurando? Pesquise outras perguntas com a tag .