http://www.guj.com.br/posts/list/5.java JForum - http://www.jforum.net
Quando quero declarar um método como deprecated tenho que fazer algo como:
[code]
/**
* @deprecated Faca outra coisa
*/
public void metodoDepreciado() { ... }
[/code]
Assim, para verificar se um determinado método está depreciado o compilador verifica se dentro do comentário javadoc existe a String "@deprecated". Ora, Comentários foram feitos justamente para serem ignorados pelo compilador :? ! Isso inclui os comentários javadocs.
Creio que isso foi uma bola fora dos criadores do Java. Na minha humilde opinião seria mais adequado se "deprecated" fosse uma palavra-chave, usada como abaixo:
[code]
public void metodoDepreciado() deprecated("Faça outa coisa") { ... }
[/code]
Será que não há algum expert do JCP que não tenha pensado nisso? Qual a opinião de vocês?

Grato,]]> http://www.guj.com.br/prepost/1772/8425/sobre-deprecated http://www.guj.com.br/prepost/1772/8425/sobre-deprecated GMT
1) Seria necessario fazer alteracao no codigo fonte, o que certamente nao eh a melhor coisa;
2) usar @deprecated faz com que isso tambem apareca na documentacao da classe. Se fosse da outra maneira, ou nao apareceria na documentacao, ou vc teria que adicionar o comentario MAIS a alteracao no codigo.. nao eh algo mto bom de fazer.

Como voce disse, comentarios sao ignorados, porem nesse caso ate eh uma solucao bem razoavel, e soh facilita a vida do programador.

Rafael]]> http://www.guj.com.br/prepost/1772/8440/ http://www.guj.com.br/prepost/1772/8440/ GMT Quando abro um código fonte e acrescento a tag @deprecated, estou alterando o código de qualquer forma. Se bem que não na parte "funcional".
[quote]2) usar @deprecated faz com que isso tambem apareca na documentacao da classe. Se fosse da outra maneira, ou nao apareceria na documentacao, ou vc teria que adicionar o comentario MAIS a alteracao no codigo.. nao eh algo mto bom de fazer. [/quote]
Basta alterara o programa gerador do Javadoc para que ele reconheça [i]deprecated[/i] e exiba o aviso de depreciação. Se o Javadoc é inteligente o suficiente para verificar se um determinado método está sobrepondo outro método de mesma assinatura de alguma super-classe, não deve ser difícil ele tratar de [i]deprecated[/i].
Reconheço que este assunto é um tanto acadêmico, e que provavelmente não vai resultar em nada. Apenas acho que se pudesse retornar no tempo e recriar o Java, este seria um aspecto que eu levaria em consideração.

Grato,]]> http://www.guj.com.br/prepost/1772/8442/ http://www.guj.com.br/prepost/1772/8442/ GMT A solucao que voce propoe eh muito mais sucetivel a erros. Depois, o programa que cria o Javadoc nao tem influencia alguma na hora de compilacao, logo ele nao pode "tratar deprecated".

Rafael]]> http://www.guj.com.br/prepost/1772/8444/ http://www.guj.com.br/prepost/1772/8444/ GMT Sim, o gerador do Javadoc não influencia a compilação. Mas se ele pode, digamos, dizer se um método é public, abstract, syncronized, etc. simplesmente procurando por estas palavras no cabeçalho deste método, a mesma coisa poderia ser feita com a depreciação.]]> http://www.guj.com.br/prepost/1772/8447/ http://www.guj.com.br/prepost/1772/8447/ GMT
eu diria que seria melhor algo como

public deprecated void theMethod...

[]'s]]> http://www.guj.com.br/prepost/1772/8524/ http://www.guj.com.br/prepost/1772/8524/ GMT Me perdoe a curiosidade....mas qual o motivo que leva vc a declarar um método como depreciado? pelo que sei, quando vc usa métodos de API's antigas do Java, ao compilar ele diz que existe metodos depreciados em sua classe, dai vc da -deprecated, algo assim, na hora de compilar e ele mostra, correto? então, pedindo desculpas novamente pela curiosidade, mas o que leva vc a querer declarar algo deste tipo??

Ate mais.....]]> http://www.guj.com.br/prepost/1772/8554/ http://www.guj.com.br/prepost/1772/8554/ GMT
Você fez seu método em uma classe, está todo mundo usando, e um certo dia você percebe que estava meio ruim daquele jeito, mas que se você simplesmente "consertar", o código de outras pessoas pode parar de agir como esperado. Então você marca o método como deprecated e faz um novo para substituí-lo, aí as pessoas que pegarem a nova versão da sua classe e estiverem usando esse método serão informadas sobre a mudança.]]> http://www.guj.com.br/prepost/1772/8556/ http://www.guj.com.br/prepost/1772/8556/ GMT
Acho que vc esta querendo falar em "versionamento de métodos" não eh? bom, se caso for isso, com certeza eh muito interessante, pois sempre vc faz um metodo e ele tem erros, dai vc vai la, faz uma atualização dele e marca a anterior como deprecated.....massa!!


Obrigado e ate mais....]]> http://www.guj.com.br/prepost/1772/8589/ http://www.guj.com.br/prepost/1772/8589/ GMT O deprecated é só para quando realmente a mudança é meio "radical" e aí precisa fazer um novo.]]> http://www.guj.com.br/prepost/1772/8602/ http://www.guj.com.br/prepost/1772/8602/ GMT
Quanto os motivo para declarar um metodo deprecated, a Bani respondeu por mim.

[quote="richardpeder"]Rafael:
Me perdoe a curiosidade....mas qual o motivo que leva vc a declarar um método como depreciado? pelo que sei, quando vc usa métodos de API's antigas do Java, ao compilar ele diz que existe metodos depreciados em sua classe, dai vc da -deprecated, algo assim, na hora de compilar e ele mostra, correto? então, pedindo desculpas novamente pela curiosidade, mas o que leva vc a querer declarar algo deste tipo??

Ate mais.....[/quote]]]> http://www.guj.com.br/prepost/1772/8618/ http://www.guj.com.br/prepost/1772/8618/ GMT
Você marca o método inteiro. E depois não tem mais volta, a menos que vc queira uma bagunça.
Um método é deprecated quando ele provavelmente será removido da API.

Quando vc faz código para outras pessoas usarem, às vezes vc se depara com essas coisas: erros graves em situações específicas, ou comportamentos que não existem mais.

Por exemplo:
[code]
Tag tag = new Tag();
tag.setType(Tag.TITLE_TYPE);
[/code]

Vc tem uma constante inteira que te permite setar o tipo da tag. Mas vc de repente percebe que essa abordagem é horrível e resolve criar uma classe [b]TagType[/b] que vai fazer a tarefa difícil para você:

[code]
Tag tag = new Tag();
TagType title = new TagType();
title.setBold(true);
title.setBig(true);
tag.setType(title);
[/code]

E agora?? Vc quer que todo mundo use o jeito novo, mas existe código de outros que chama seu método inteiro! Vc torna-o deprecado e faz uma gambiarra para que uma chamada ao método antigo ainda funcione. Mas ele eventualmente vai sumir.

Repare na classe [b]java.util.Date[/b], que é um caso clássico... :)

aquelão!!]]> http://www.guj.com.br/prepost/1772/8675/ http://www.guj.com.br/prepost/1772/8675/ GMT