http://www.guj.com.br/posts/list/2.java JForum - http://www.jforum.net Pessoal,

Vcs pegam códigos que te faz passar horas e horas tentando entender o q está sendo feito?
Valores que vc nem imagina de onde estão vindo?

Eu sou mto ruim ou isso é normal?

Abraço!]]> http://www.guj.com.br/posts/preList/78030/413023.java http://www.guj.com.br/posts/preList/78030/413023.java GMT
por exemplo, que tal dar uma olhada no diagrama de classes para ver como as classes estão interagindo ?! ]]> http://www.guj.com.br/posts/preList/78030/413024.java http://www.guj.com.br/posts/preList/78030/413024.java GMT

Eu acho isso normal, pois vc entender o que outra pessoa fez as vezes é muito mais complicado do que fazer do zero! isso tbm é questão de lógica, o jeito é procurar um livrinho de lógica... para acustumar sua cabeça!

"Bons programadores escrevem códigos para pessoas entenderem e nao para o computador!"


Mas é Normal isso ae....


Boa sorte! =D]]> http://www.guj.com.br/posts/preList/78030/413026.java http://www.guj.com.br/posts/preList/78030/413026.java GMT heuhua...

Nosso sistema não tem documentação, comentário...NADA...heueh...
Tem algumas coisas esquisitas que "vc" demora a encontrar.

O problema não é lógica. Todo código que escrevo, tento me colocar no lugar de alguém que estará trabalhando com ele.
Imagine, programação estruturada, alguns calculos que são feitos no init de um relatório, e dependendo de uma condição que está sendo verificada DENTRO DE UM CAMPO, ele mostra o valor. Então vc fica algum tempo seguindo o código e acompanhando os calculos que da um valor e na exibição mostra outro totalmente diferente. O problema é q isso poderia ser feito de uma maneira TÃO mais fácil.

isso é de mata!!!

]]> http://www.guj.com.br/posts/preList/78030/413033.java http://www.guj.com.br/posts/preList/78030/413033.java GMT http://www.guj.com.br/posts/preList/78030/413035.java http://www.guj.com.br/posts/preList/78030/413035.java GMT
isso é de mata!!!

[/quote]

conhece quem fez?
então, mete bronca meu caro...hahahhhahaa...brincadeira heim..]]> http://www.guj.com.br/posts/preList/78030/413037.java http://www.guj.com.br/posts/preList/78030/413037.java GMT
Agente passa o dia todo zuando aqui...rss

Costumamos dizer q temos um Sistema de Desinformação. heeu]]> http://www.guj.com.br/posts/preList/78030/413040.java http://www.guj.com.br/posts/preList/78030/413040.java GMT
E a letra de uma pessoa é a mesma coisa, eu qdo escrevo para minha compreensao é dificil terceiros entender, porem qdo vou escrever algo que vai ser transferivel ai tenho que escrever bonitinho para depois o cara nao me encher o saco ligando perguntando o que está escrito na parte X.

em um ambiente de desenvolvimento esse fato de nao entendimento é anormal, o normal é que vc entenda.. mais vai ai da politica da empresa de como cobra isso dos gerentes e os gerentes dos desenvolvedores. Ja empresa cobrar isso, como tarefa do desenvolvedor mesmo. Principalmente aquelas que ja sofreram com isso qdo o cara saiu..

hehe! ]]> http://www.guj.com.br/posts/preList/78030/413044.java http://www.guj.com.br/posts/preList/78030/413044.java GMT depende da sua capacidade
dependa da arquitetura
depende da documentacao bem detalhada

Entenda a merda feita

[code]

/** O metodo faz um monte de coisas para o usuario quando o programador precisa
* @param w
*/
public void metedoFaz(Object w) {

Alun x = new Alun();
Clace y = new Clace();
Prof z = new Prof();

x.setNom("Macelo");
y.setNum(145);
z.setNom("Marcelo");

z.setAlun(x);
y.setProf(z);

}

[/code]

entenda a merda "documenta"

[code]

/** O metodo faz o encapsulamento do Alun (Aluno) e Prof (Professor) na objeto Clace (Classe).
* @param w - Object
*/
public void metedoFaz(Object w) {

Alun x = new Alun(); // A e o tipo de Aluno
Clace y = new Clace(); // Clace é a Classe do aluno
Prof z = new Prof(); // Classe professor

x.setNom("Macelo"); // Nome do Aluno
y.setNum(206); // Numero da classe
z.setNom("Marcelo"); // Nome do professor

z.setAlun(x);
y.setProf(z);

}

[/code]

:wink: ]]> http://www.guj.com.br/posts/preList/78030/413064.java http://www.guj.com.br/posts/preList/78030/413064.java GMT Muitas vezes a correta nomeação das vareáveis, métodos e classes já torna o codigo muito mais
legivel. Pegando o exemplo do jjose veja a diferença:


[code]


public void criaClasseParaAluno(String nomeDoAluno) {

Aluno aluno = new Aluno();
Classe classe = new Classe ();
Professor professor = new Professor();

aluno.setNome(nomeDoAluno);
classe.setNumero(206);
professor.setNome("Marcelo");

classe.addAluno(aluno);
classe.setProfessor(professor);


}

[/code]

]]> http://www.guj.com.br/posts/preList/78030/413072.java http://www.guj.com.br/posts/preList/78030/413072.java GMT Muitas vezes a correta nomeação das vareáveis, métodos e classes já torna o codigo muito mais
legivel. Pegando o exemplo do jjose veja a diferença:


[code]


public void criaClasseParaAluno(String nomeDoAluno) {

Aluno aluno = new Aluno();
Classe classe = new Classe ();
Professor professor = new Professor();

aluno.setNome(nomeDoAluno);
classe.setNumero(206);
professor.setNome("Marcelo");

classe.addAluno(aluno);
classe.setProfessor(professor);


}

[/code]

[/quote]

eu tentei da um exemplo de um codigo ruim com documentacao e o mesmo sem
mostrar como o comentario pode salva ou ajudar no entendimento
se tem varios programadores "programando"
vai saber o nome que o lazarento vai por no metodo
todo metodo faz alguma coisa entao pq colocar o nome metodoFaz
a documentacao feita no primeiro naum ajuda em nada
nomes errados e sem padrao da sun

programador satan - o programador veio do inferno para condenar o projeto]]> http://www.guj.com.br/posts/preList/78030/413075.java http://www.guj.com.br/posts/preList/78030/413075.java GMT
se for para encher de comentários no codigo é melhor dar uma estudada em refatoração, pois está no momento de refatorar o código e deixá-lo legível...


]]> http://www.guj.com.br/posts/preList/78030/413080.java http://www.guj.com.br/posts/preList/78030/413080.java GMT Aqui na empresa, temos um erp que ao longo dos anos foi alterado unicamente por freelancers...

Então, o cara chegava, fazia do jeito que queria e ia embora...Não houve cobrança para documentação nem nada do tipo.
O complicado é q vc vê mta coisa errada e sabe que quem faz tbm sabia q estava errado, mas por falta de comprometimento deixou daquele jeito.]]> http://www.guj.com.br/posts/preList/78030/413095.java http://www.guj.com.br/posts/preList/78030/413095.java GMT
Eu penso que o código deve ter 2 requisitos importantes, além de funcionar (óbeveo): nomes de variáveis auto-explicativas e javadoc.]]> http://www.guj.com.br/posts/preList/78030/413101.java http://www.guj.com.br/posts/preList/78030/413101.java GMT Aqui na empresa, temos um erp que ao longo dos anos foi alterado unicamente por freelancers...

Então, o cara chegava, fazia do jeito que queria e ia embora...Não houve cobrança para documentação nem nada do tipo.
O complicado é q vc vê mta coisa errada e sabe que quem faz tbm sabia q estava errado, mas por falta de comprometimento deixou daquele jeito.[/quote]

Se a empresa não mantém um padrão de desenvolvedores da nisso mesmo, o negocio dele é ganhar e se mandar

[color=red] Segundo pensamento POG [/color] [i] Do meu jeito é mais fácil e rápido! [/i]

[i]Preciso de um programador, quem cobra menos???[/i]

[]'s


]]> http://www.guj.com.br/posts/preList/78030/413103.java http://www.guj.com.br/posts/preList/78030/413103.java GMT
Eu penso que o código deve ter 2 requisitos importantes, além de funcionar (óbeveo): nomes de variáveis auto-explicativas e javadoc.[/quote]

Eu troco o javadoc por testes. Se o programador realmente escreveu bem o seu código, este não só será legível como existirão testes pra demonstrar na prática onde o programador queria chegar quando escreveu aquilo.

Em todos os meus últimos projetos a facilidade de entender o código era diretamente proporcional a quantidade e qualidade dos testes existentes...]]> http://www.guj.com.br/posts/preList/78030/413202.java http://www.guj.com.br/posts/preList/78030/413202.java GMT
Em todos os meus últimos projetos a facilidade de entender o código era diretamente proporcional a quantidade e qualidade dos testes existentes...[/quote]
Totalmente de acordo. E acho que lendo documentação vc não aprende exatamente a ler código. Ler e escrever código é que ensinam a... erhm... ler e escrever código.

valeuz...]]> http://www.guj.com.br/posts/preList/78030/413209.java http://www.guj.com.br/posts/preList/78030/413209.java GMT http://www.guj.com.br/posts/preList/78030/413212.java http://www.guj.com.br/posts/preList/78030/413212.java GMT
Eu discordo, imaginem se o pessoal da sun seguisse esta linha de raciocínio.. acho que documentação com javadoc é extremamente importante, porém o que ocorre é que tem gente que escreve uma monografia sobre o método.

A documentação do Método deve ser simples e rápida.]]> http://www.guj.com.br/posts/preList/78030/413316.java http://www.guj.com.br/posts/preList/78030/413316.java GMT http://www.guj.com.br/posts/preList/78030/413318.java http://www.guj.com.br/posts/preList/78030/413318.java GMT
Em todos os meus últimos projetos a facilidade de entender o código era diretamente proporcional a quantidade e qualidade dos testes existentes...[/quote]
Totalmente de acordo. E acho que lendo documentação vc não aprende exatamente a ler código. Ler e escrever código é que ensinam a... erhm... ler e escrever código.

valeuz...[/quote]

Como funciona, vocês perguntam [i]"O que você prefere, documentado ou bem escrito?"[/i] ?

Não pode existir os dois?
Eu sempre vejo as pessoas trocarem uma qualidade pela outra nessa forum ao invez de somar

Marck, o problema pode não ser você, já viu os programadores [url=http://desciclo.pedia.ws/wiki/M%C3%A9todo_MacGyver]MacGyver[/url] que tentam programar em 500 linguagens/scripts e detonam tudo?



]]> http://www.guj.com.br/posts/preList/78030/413332.java http://www.guj.com.br/posts/preList/78030/413332.java GMT
Eu discordo, imaginem se o pessoal da sun seguisse esta linha de raciocínio.. acho que documentação com javadoc é extremamente importante, porém o que ocorre é que tem gente que escreve uma monografia sobre o método.

A documentação do Método deve ser simples e rápida.[/quote]

Javadoc é extremamente importante para API Java, onde quem a usa tem que saber o que o método faz, sem necessariamente entender o código dele.

Agora, num projeto onde os desenvolvedores têm que saber como cada método está implementado, o cenário é outro. E neste caso me desculpe mas eu continuo preferindo testes.

Na minha opinião, para uma pessoa entender um código existente, as melhores práticas são (em ordem de eficiência):
1) Sentar com quem fez e programar em dupla
2) Executar os testes e ver como o código está sendo utilizado
3) Ler qualquer documentação em texto (javadoc, diagramas etc)]]> http://www.guj.com.br/posts/preList/78030/413345.java http://www.guj.com.br/posts/preList/78030/413345.java GMT ]]> http://www.guj.com.br/posts/preList/78030/413364.java http://www.guj.com.br/posts/preList/78030/413364.java GMT Não é sempre sobre somar, mas escrever e manter tralha desnecessária. Eu fico extremamente feliz quando posso deletar código ao invés de escrever mais. Se o seu código é claro o suficiente, faz sentido escrever documentação que precisa ser atualizada quando houver mudanças? No fim das contas ainda se trata de bom senso, ou você documenta gets/sets?

valeuz...]]> http://www.guj.com.br/posts/preList/78030/413375.java http://www.guj.com.br/posts/preList/78030/413375.java GMT Não é sempre sobre somar, mas escrever e manter tralha desnecessária. Eu fico extremamente feliz quando posso deletar código ao invés de escrever mais. Se o seu código é claro o suficiente, faz sentido escrever documentação que precisa ser atualizada quando houver mudanças? No fim das contas ainda se trata de bom senso, ou você documenta gets/sets?

valeuz...[/quote]

Se houver alguma validação eu coloco no javadoc sim... Se um outro programador precisar usar, nem precisa olhar meu código pois vai estar detalhado.
Quando alguém pergunta dos meus códigos eu respondo [i]"Olhe pelo nome da classe,o método e javadoc que é isso que vai ser feito!"[/i].

[code]
/** Este método persiste uma Venda. Lazy para ItemVenda e Produto.
* @param venda VendaVO
* @return boolean
* @throws Exception
*/
public boolean insertInLazy(VendaVO venda) throws Exception{
[/code]

* Isso atrapalha no que?

]]> http://www.guj.com.br/posts/preList/78030/413422.java http://www.guj.com.br/posts/preList/78030/413422.java GMT
Marck, o problema pode não ser você, já viu os programadores [url=http://desciclo.pedia.ws/wiki/M%C3%A9todo_MacGyver]MacGyver[/url] que tentam programar em 500 linguagens/scripts e detonam tudo?

[/quote]

Complicado qd vc vê no meio do código uma chamada para um metodo q é executado no banco de dados...rs...500 linguagens em um bloco de código..rsss
Bom, tomara q eu não seja "tão ruim assim"...rs...

Sobre o problema q falei, as vezes encontro código com 100 linhas para fazer algo muito simples e outros q fazer coisas super complexas com 10 linhas...
Outra coisa q me incomoda é qd o cara faz uma alteração e o código antigo ele deixa comentado...fica uma tralha gigante...dá pra encontrar coisa de 5 anos atrás...rs
e os comentáros: "alterei pq o usuario X pediu..." ehehe

[edit]
Sobre javadoc não tenho q falar pois nossa linguagem é totalmente ultrapassada, mas a documentação é independente de linguagem....
[\edit]]]> http://www.guj.com.br/posts/preList/78030/413432.java http://www.guj.com.br/posts/preList/78030/413432.java GMT Pessoal,

Vcs pegam códigos que te faz passar horas e horas tentando entender o q está sendo feito?
Valores que vc nem imagina de onde estão vindo?

Eu sou mto ruim ou isso é normal?

Abraço![/quote]

Tem uma boa solução (ao menos a melhor que encontrei) para isso, refatorar...
de faz entender o código mais rapidamente... além de deixar a apossibilidade de dar mais flexibilidade ao atual sistema.

refatora um pouquinho testa, refatora um pouquinho e testa.
]]> http://www.guj.com.br/posts/preList/78030/414043.java http://www.guj.com.br/posts/preList/78030/414043.java GMT Pessoal,

Vcs pegam códigos que te faz passar horas e horas tentando entender o q está sendo feito?
Valores que vc nem imagina de onde estão vindo?

Eu sou mto ruim ou isso é normal?

Abraço![/quote]

Tem uma boa solução (ao menos a melhor que encontrei) para isso, refatorar...
de faz entender o código mais rapidamente... além de deixar a apossibilidade de dar mais flexibilidade ao atual sistema.

refatora um pouquinho testa, refatora um pouquinho e testa.
[/quote]

citei em um dos posts acima sobre refatoracao...

mas para usar refatoracao nao eh assim tao trivial nao...é bastante aconselhavel q se tenha um conjunto de testes automatizados...nao é simplesmente "refatora um pokim, testa, refatora outro pokim e testa " ...é mais do que isso..

abraços]]> http://www.guj.com.br/posts/preList/78030/414049.java http://www.guj.com.br/posts/preList/78030/414049.java GMT
mas para usar refatoracao nao eh assim tao trivial nao...é bastante aconselhavel q se tenha um conjunto de testes automatizados...nao é simplesmente "refatora um pokim, testa, refatora outro pokim e testa " ...é mais do que isso..
abraços[/quote]

Bem eu acredito que essa "trivialidade" se dá para quem conhece o processo de refatoração...
Quando disse:
"Refatora um pouquinho, testa, refatora ...." estava resumindo (muito mesmo) o processo, ora quem quiser saber que leia.]]> http://www.guj.com.br/posts/preList/78030/414055.java http://www.guj.com.br/posts/preList/78030/414055.java GMT ]]> http://www.guj.com.br/posts/preList/78030/414057.java http://www.guj.com.br/posts/preList/78030/414057.java GMT