JavaDoc  XML
Índice dos Fóruns » Java Básico
Autor Mensagem
everson_z
Virtual Machine Man
[Avatar]

Membro desde: 05/07/2005 18:12:25
Mensagens: 590
Localização: SP - São Paulo
Offline

This message was edited 1 time. Last update was at 15/02/2008 15:25:56


Primeiro pensamento POG Existe casos e casos!
Segundo pensamento POG Do meu jeito é mais fácil e rápido!
Primeira merda POG Fazer as merdas que muitos fizeram por defender o primeiro pensamento POG.
Segunda merda POG Limitar o projeto ao escopo inicial.
Terceira merda POG Se basear em absurdos para defender seu desenvolvimento.
Quarta merda POG Não entender que padrão é beneficio e usar o primeiro pensamento POG.
Quinta merda POG Achar um absurdo eu escrever isso.
[WWW]
erickcellani
JavaEvangelist
[Avatar]

Membro desde: 13/05/2006 13:37:12
Mensagens: 425
Localização: São Paulo - SP
Offline

intaum cara... enquanto ao javadoc... está errado...

eu vi que vc está usando @param para qualquer coisa.. e naum é certo... vc deve usa-lá se vc tiver que passar um parametro mesmo...
exemplo:



e em metodos que naum tem parametro para passar... naum precisa colocar
/**
* @param
*/

a pior coisa que existe é documentação errada... cuidado com isso!

espero ter ajudado!

--
Érick F. Cellani
[MSN]
everson_z
Virtual Machine Man
[Avatar]

Membro desde: 05/07/2005 18:12:25
Mensagens: 590
Localização: SP - São Paulo
Offline

erickcellani wrote:intaum cara... enquanto ao javadoc... está errado...

eu vi que vc está usando @param para qualquer coisa.. e naum é certo... vc deve usa-lá se vc tiver que passar um parametro mesmo...
exemplo:

espero ter ajudado!


Vou tomar...
Só isso, eu deixo os @param apenas para as exigências da estrutura?
E sobre a duvida 1 ?

Primeiro pensamento POG Existe casos e casos!
Segundo pensamento POG Do meu jeito é mais fácil e rápido!
Primeira merda POG Fazer as merdas que muitos fizeram por defender o primeiro pensamento POG.
Segunda merda POG Limitar o projeto ao escopo inicial.
Terceira merda POG Se basear em absurdos para defender seu desenvolvimento.
Quarta merda POG Não entender que padrão é beneficio e usar o primeiro pensamento POG.
Quinta merda POG Achar um absurdo eu escrever isso.
[WWW]
erickcellani
JavaEvangelist
[Avatar]

Membro desde: 13/05/2006 13:37:12
Mensagens: 425
Localização: São Paulo - SP
Offline

bom naum sei quem te flw isso... mas é uma grande mentira...
o método pode ser void!

enquanto a sua outra duvida... vc se refere a qual varialvel ?

--
Érick F. Cellani
[MSN]
everson_z
Virtual Machine Man
[Avatar]

Membro desde: 05/07/2005 18:12:25
Mensagens: 590
Localização: SP - São Paulo
Offline

Essa

Primeiro pensamento POG Existe casos e casos!
Segundo pensamento POG Do meu jeito é mais fácil e rápido!
Primeira merda POG Fazer as merdas que muitos fizeram por defender o primeiro pensamento POG.
Segunda merda POG Limitar o projeto ao escopo inicial.
Terceira merda POG Se basear em absurdos para defender seu desenvolvimento.
Quarta merda POG Não entender que padrão é beneficio e usar o primeiro pensamento POG.
Quinta merda POG Achar um absurdo eu escrever isso.
[WWW]
erickcellani
JavaEvangelist
[Avatar]

Membro desde: 13/05/2006 13:37:12
Mensagens: 425
Localização: São Paulo - SP
Offline

pode deixar... está certo!
ficou até bunito... usa-lá como constante... nos meus codigos eu uso assim tbm!

Obs.: qnd vc kiser usar o javadoc e naum tiver nenhum parametro ou retorno ou qualquer outra coisa vc pode fazer assim:
(vou usar sua variável como exemplo)



pq ai sai na documentação corretamente!

--
Érick F. Cellani
[MSN]
everson_z
Virtual Machine Man
[Avatar]

Membro desde: 05/07/2005 18:12:25
Mensagens: 590
Localização: SP - São Paulo
Offline

O javabean fica assim?


Primeiro pensamento POG Existe casos e casos!
Segundo pensamento POG Do meu jeito é mais fácil e rápido!
Primeira merda POG Fazer as merdas que muitos fizeram por defender o primeiro pensamento POG.
Segunda merda POG Limitar o projeto ao escopo inicial.
Terceira merda POG Se basear em absurdos para defender seu desenvolvimento.
Quarta merda POG Não entender que padrão é beneficio e usar o primeiro pensamento POG.
Quinta merda POG Achar um absurdo eu escrever isso.
[WWW]
leandroqbs
JavaTeenager

Membro desde: 21/03/2007 08:53:41
Mensagens: 181
Localização: São Paulo
Offline

Everson, você utiliza Eclipse certo? Então procure um plugin chamado ChekStyle ele controla sua aplicação no padrão SunCodeConventions ira te ajudar bastante com os JD's

Abraço

Att,
Leandro Souza
[Email] [MSN]
erickcellani
JavaEvangelist
[Avatar]

Membro desde: 13/05/2006 13:37:12
Mensagens: 425
Localização: São Paulo - SP
Offline

everson_z wrote:O javabean fica assim?



isso mesmo!

--
Érick F. Cellani
[MSN]
cassioso
JavaBaby
[Avatar]

Membro desde: 23/08/2006 16:22:47
Mensagens: 93
Localização: Salvador, Bahia, Brasil
Offline

eu faço um pouco diferente...



alguém sabe como fazer o javadoc para atributos??

como eu documento um



??

[]'s
Ótimo
http://www.cassiooliveira.com
[Email] [WWW] [MSN]
cvinicius
JavaEvangelist

Membro desde: 18/04/2008 16:35:05
Mensagens: 433
Localização: SP
Offline

Boa Tarde

Na minha aplicação para atributos eu uso a seguite sintaxe do javadoc:

/**
* Array com os digitos hexadecimais
*/
private static String[] hexDigits = {"0","1","2","3","4","5","6","7","8","9","a","b","c","d","e","f"};


Agora com relação ao javadoc para métodos ou uso assim:

/**
* Método de Envio de E-Mails em formato HTML - emailHtml
*
* @since 05/05/2008
*
* @param String destinatario - Destinatario do E-Mail
* @param String assunto - Assunto do E-Mail
* @param String mensagem - Mensagem do E-Mail
* @return boolean
* @throws EmailException
* @throws FactoryException
*/

Falou.....

Sun Certified Java Programmer 5
Oracle Certified Associate, Java SE
Oracle Certified Professional Java EE 5 Web Component Developer
 
Índice dos Fóruns » Java Básico
Ir para:   
Powered by JForum 2.1.8 © JForum Team