Não entendo por que o Eclipse não mostra o nome das variáveis no auto complete, isso ajudaria muito…
Parece bem interessante mesmo. Uma mão na roda.
Parabéns.
como não? aqui mostra normal.
É mesmo, nem reparei que mudaram isso. Podia mostrar a documentação do parâmetro junto: https://bugs.eclipse.org/bugs/show_bug.cgi?id=233528
como não? aqui mostra normal.[/quote]
O Eclipse (ou IntelliJ, ou qqer outra IDE que nao faca milagre ou use o ParaNamer) so consegue mostrar os nomes de argumentos quando vc linka o JavaDoc da lib que esta usando no projeto.
Aqui mostrou o nome mesmo sem Javadoc
JSF Show de BOLA PAULO 
Parabéns, já começamos os testes aqui 8)
Provavelmente porque o fonte está visível para o Eclipse, se não ele mostraria os velhos arg0, arg1…
Ah! E parabéns para o pessoal da Caelum!
Só enxendo o saco (mas particularmente n gosto qdo vejo codigo assim):
“BoletoGenerator”, “withData”…
Nao seria melhor escolher 1 lingua, ao inves de mesclar as 2? algo como “GeradorDeBoleto” ou “withDate”?
No mais… parabéns pelo projeto… muito util.
[quote=fabiocsi]Só enxendo o saco (mas particularmente n gosto qdo vejo codigo assim):
“BoletoGenerator”, “withData”…
Nao seria melhor escolher 1 lingua, ao inves de mesclar as 2? algo como “GeradorDeBoleto” ou “withDate”?
[/quote]
++
É… fica a impressão que o autor não sabe inglês ou não sabe Portugues… fora que quem usa a API de memoria
tem um problema para saber quando é usando ingles e quando não. (withData ou comDate ?)
Olá
[quote=fabiocsi]Só enxendo o saco (mas particularmente n gosto qdo vejo codigo assim):
“BoletoGenerator”, “withData”…
Nao seria melhor escolher 1 lingua, ao inves de mesclar as 2? algo como “GeradorDeBoleto” ou “withDate”?[/quote]
Ficou meio esquisito mesmo. E agora, o que sugeriria depois que a API veio a público? Refatorar? Lançar nova versão com wrappers para os nomes?
[]s
Luca
Muito legal!
Certamente será muito util já to fazendo a propagando para meus amigos desenvolvedores.
Parabéns.
Oi gente,
A discussão sobre inglês vs português é sim muito relevante. Internamente, discutimos bastante mesmo sobre isso, e sempre há controvérsia. Cada um sempre tem uma opinião diferente a respeito.
Se fizermos totalmente em inglês, como ficariam os termos do domínio (que são específicos do Brasil)? Se fizermos tudo em português, como ficam os getters? E os termos técnicos que todo mundo conhece em inglês? Se escolhessemos pelo pt-BR puro, no mínimo misturamos, já que as próprias palavras reservadas do Java são em inglês. Não há como não misturar.
Dado tudo isso, infelizmente não é possível agradar a todos e tomamos uma decisão: tudo que tem a ver com o domínio vai em pt-BR, incluindo também toda a documentação (javadoc + site). Todo o resto em inglês.
Convenhamos que isso é importante mas não é o maior de todos os problemas. Foi apenas a convenção que adotamos. Mesmo se alguém não conseguir engolir de forma alguma os nomes, pode sem problemas criar uma camada a mais de adapters com todos os métodos em inglês ou português.
Nos comentários do post no blog, o Guilherme Chapiewski fez o mesmo comentário. Vale a pena dar uma olhada e comentar por lá.
Para não ter problemas de memória e não precisar lembrar se é withData ou comDate na hora que estiver usando a API, basta entender a convenção. Ou ainda usar o auto-complete da sua ide. Foi uma falha nossa não ter deixado isso claro na documentação. Obrigado Sérgio!
[quote=Fabio Kung]Oi gente,
A discussão sobre inglês vs português é sim muito relevante. Internamente, discutimos bastante mesmo sobre isso, e sempre há controvérsia. Cada um sempre tem uma opinião diferente a respeito.
Se fizermos totalmente em inglês, como ficariam os termos do domínio (que são específicos do Brasil)? Se fizermos tudo em português, como ficam os getters? E os termos técnicos que todo mundo conhece em inglês? Se escolhessemos pelo pt-BR puro, no mínimo misturamos, já que as próprias palavras reservadas do Java são em inglês. Não há como não misturar.
Dado tudo isso, infelizmente não é possível agradar a todos e tomamos uma decisão: tudo que tem a ver com o domínio vai em pt-BR, incluindo também toda a documentação (javadoc + site). Todo o resto em inglês.
Convenhamos que isso é importante mas não é o maior de todos os problemas. Foi apenas a convenção que adotamos. Mesmo se alguém não conseguir engolir de forma alguma os nomes, pode sem problemas criar uma camada a mais de adapters com todos os métodos em inglês ou português.
Nos comentários do post no blog, o Guilherme Chapiewski fez o mesmo comentário. Vale a pena dar uma olhada e comentar por lá.
Para não ter problemas de memória e não precisar lembrar se é withData ou comDate na hora que estiver usando a API, basta entender a convenção. Ou ainda usar o auto-complete da sua ide. Foi uma falha nossa não ter deixado isso claro na documentação. Obrigado Sérgio![/quote]
Pelo que vi nos projetos que passei, essa é a solução mais adotada mesmo.
Tentar traduzir tudo pra inglês fica tosco com algumas palavras. Ou alguém sabe como traduzir CARTEIRA para inglês? E colocar pegarXXX seria horrível.
PS: Carteira no sentido bancário e não carteira que você põe no bolso.
[quote=sergiotaborda]É… fica a impressão que o autor não sabe inglês ou não sabe Portugues… fora que quem usa a API de memoria
tem um problema para saber quando é usando ingles e quando não. (withData ou comDate ?)[/quote]
Opa! Parece que o autor nao sabe ingles nem portugues assim como parece que voce nao conhece alguns recursos magicos do Eclipse Sergio!!! Deixa eu apresenta-los:
Sergio, esse é o Control-Espaço
Control-Espaço, esse é o Sergio!
Esse tipo de API nao é aquela que a gente decora com é java.util e java.io… control espaco nela!
Brincadeiras a parte, foi realmente uma decisao dificil. Teriamos interface Bank e ai BancoDoBrasil implements Bank… E esse problema do with é o MESMO que temos com getters e setters… nao ficamos satisfeitos com nenhuma das abordagens, entao pegamos uma das duas. Se tiver uma sugestao melhor, eh só escrever!
Pessoal,
essa questão de dos termos da API, é de certa forma complicada.
Acredito que mistura do português com o inglês na API uniu o melhor dos dois mundos.
Não podemos deixar de tratar os termos do domínio na sua linguagem natural. Neste ponto acredito que todos concordamos.
Por outro lado, já estamos acostumados as termos em inglês get, set, with, assert, isValid, Message , etc…
Sinceramente eu não conheço ninguém que prefira utilizar estes termos em português quando está escrevendo código.
Após o reconhecimento inicial da convenção da API, provavelmente a maioria dos desenvolvedores não terá dificuldade nem para encontrar os termos específicos do dominio (como Carteira,CEP,CNPJ,etc…), nem para utilizar os termos em inglês.
Bem, essa é a minha opinião sobre a API. Apesar da estranheza inicial, a decisão de misturar os termos em português e em inglês foi acertada.
Valorizo muito as críticas, principalmente as construtivas.
É exagero dizer que o autor não sabe inglês ou não sabe português.
Para quem usa a API de forma intuitiva, não terá dificuldade em escolher “withData” ao invés de “comDate”, seguindo a convenção.
“Que ninguém se engane, só se consegue a simplicidade através de muito trabalho.” - Clarice Lispector
[quote=fabiocsi]Só enxendo o saco (mas particularmente n gosto qdo vejo codigo assim):
“BoletoGenerator”, “withData”…
Nao seria melhor escolher 1 lingua, ao inves de mesclar as 2? algo como “GeradorDeBoleto” ou “withDate”?
No mais… parabéns pelo projeto… muito util.[/quote]
É como se mesclasse o nome da entidade + nome do padrão.
Como Factory, Generator, Model, etc…
Mas concordo contigo que fica um pouco “chatinho” de observar assim.
Críticas devem ser aceitas da melhor maneira, porem não sei se é tão relevante a tal crítica feita sobre os dois idiomas mesclados no código, mas sei que é relevante o sucesso que o caelum stella está fazendo =]…
show de bola! :lol:
normlamente é Portfolio, mas pode ser Account dependendo do conceito do sistema