Perguntas com a marcação «naming»

Costumava haver muito boas razões para manter a instrução / registrar nomes curtos. Esses motivos não se aplicam mais, mas nomes curtos e criptografados ainda são muito comuns na programação de baixo nível. Por que é isso? É apenas porque os velhos hábitos são difíceis de quebrar, ou existem melhores …

64 naming  coding-standards  low-level 

É sempre difícil para mim escolher entre formas singular e plural para nomes de classes: CustomerRepository vs. CustomersRepository CustomerService vs. CustomersService CustomerController vs. CustomersController E para nomes compostos é ainda mais difícil: OrderCustomerRepository vs. OrderCustomersRepository vs. OrdersCustomersRepository Qual abordagem você prefere e por quê?

58 naming  source-code 

Qual é o melhor nome para um método que retorna um booleano? IsSupportContentType ou CanSupportContentType

51 naming  naming-standards 

O consenso parece ser que se deve seguir a convenção da plataforma para a qual eles estão desenvolvendo. Vejo: Sublinhado ou camelcase? Convenções de nomenclatura: camelCase versus underscore_case? No entanto, o PHP parece não seguir estritamente nenhuma convenção internamente (sem surpresas), mesmo para métodos e funções (por exemplo mysqli::set_local_infile_default, PDOStatement::debugDumpParams); …

51 php  naming  readability  camelcase 

Devo sempre usar iscomo prefixo para variáveis ​​booleanas? E os booleanos que indicam algo no passado? Devo escrever isInitializedou wasInitialized? Devo escrever para propriedades IsManyMembersou HasManyMembers? Existe alguma prática recomendada? Ou devo escrever de acordo com as regras em inglês?

50 coding-style  naming  boolean 

Encontrei um problema de esquina com a orientação geral de: substantivos para variáveis verbos para funções Especificamente, tenho um caso em que a palavra é ambígua - pode ser um verbo ou um substantivo. E, em alguns casos, quando estamos discutindo o aplicativo, ele será usado nos dois sentidos na …

48 naming  variables 

Eu sempre tenho problemas para descobrir se devo nomear um determinado método começando com getSomethingversus findSomething. O problema reside na criação de auxiliares para APIs mal projetadas. Isso geralmente ocorre ao obter dados de um objeto, o que requer o objeto como parâmetro. Aqui está um exemplo simples: public String …

48 naming  methods 

Frequentemente, vejo códigos que incluem erros ortográficos intencionais de palavras comuns que, para o bem ou para o mal, se tornaram palavras reservadas: klassou clazzpara aula :Class clazz = ThisClass.class kountpara contagem no SQL:count(*) AS kount Pessoalmente, acho que isso diminui a legibilidade. Na minha própria prática, não encontrei muitos …

45 coding-style  variables  readability  naming 

Freqüentemente, quando a sintaxe do idioma exigir que eu cite uma variável que nunca é usada, eu o nomeei _. Na minha opinião, isso reduz a desordem e me permite focar nas variáveis ​​significativas no código. Acho que é discreto e produz um efeito "fora da vista, fora da mente". …

44 language-agnostic  naming  readability  variables 

É uma boa prática chamar a variável que um método retorna com um nome de variável result? Por exemplo: public Zorglub calculate() { Zorglub result = [...] [...] return result; } Ou devo nomeá-lo por seu tipo? public Zorglub calculate() { Zorglub zorglub = [...] [...] return zorglub; } Eu …

44 programming-practices  naming  variables 

Os métodos booleanos sempre devem assumir a forma afirmativa, mesmo quando serão usados ​​apenas na forma negativa? Digamos que eu queira verificar se existe uma entidade antes de criar uma, meu argumento é que a primeira forma abaixo é melhor que a segunda, se o método é ou não usado …

44 naming  functions 

Não tenho certeza do que fazer com o seguinte: Nós coletamos dados de uma ferramenta externa dentro de nossa própria ferramenta. Estes dados são escritos em holandês. Estamos escrevendo nosso código Java em inglês. Devemos então traduzir esse holandês para o inglês ou mantê-lo em holandês? Por exemplo, temos 2 …

39 naming  translate 

Peguei o termo smurf nomeando daqui (número 21). Para salvar alguém que não conhece o problema, a nomeação Smurf é o ato de prefixar um monte de classes, variáveis ​​etc. relacionadas com um prefixo comum, para que você acabe com "a SmurfAccountViewpassa a SmurfAccountDTOpara SmurfAccountController", etc. A solução que geralmente …

39 naming  coding-standards 

É suficiente distinguir métodos apenas pelo nome do argumento (não pelo tipo) ou é melhor nomeá-lo mais explicitamente? Por exemplo T Find<T>(int id)vs T FindById<T>(int id). Existe alguma boa razão para nomeá-lo de forma mais explícita (por exemplo, adicionar ById) vs manter apenas o nome do argumento? Uma razão pela …

36 c#  naming  coding-standards  conventions  method-overloading 

Existem alguns nomes em que, se você os encontrar, sabe que já estragou algo. Por exemplo: XxxManager Isso é ruim porque uma classe deve descrever o que a classe faz. Se a palavra mais específica que você pode apresentar para o que a classe faz é "gerenciar", então a classe …

35 naming  anti-patterns