J'ai une classe Person
et une méthode retournant Collection<Person>
. Existe-t-il une convention de nommage pour cela en Java? Dois-je le nommer findPersons
ou plutôt findPeople
? Quelle version est préférable quand nous avons un nom avec un nom pluriel irrégulier en anglais?Qu'est-ce qu'une convention de dénomination correcte pour la méthode Java renvoyant la collection d'éléments?
Répondre
Nommez ce que fait par le code.
findPersons // since it would find a collection of Person
Tant qu'il est lisible et logique de se rapporter au code existant, c'est bon.
Ferez-vous la même chose avec 'Child'? 'findChilds'? Ou plutôt «findChildren»? –
@PiotrPradzynski même là, si vous voulez être correct grammaticalement, vous pouvez penser à renommer 'findCollectionOfChild' – nullpointer
Gardez-le simple à tout moment. Je tend vers une approche plus «fonctionnelle» en ce qui concerne ceci pour éviter tout :) J'emploierais juste "find()", et peut-être pas dans le cadre de cette classe mais plus comme une fonction générique car elle le fait plus encombrant et moins réutilisable. Quelque chose dans les lignes de ceci: "Collection find (args ...)"
La collection de résultats elle-même est révélatrice assez zéro ou plus est à prévoir. (ou Optionnel si zéro ou un est à prévoir) Je veux dire, c'est la programmation orientée objet, mais pas la programmation orientée objet;)
Je pense que cela dépend du nom et de la fonction de la classe.
Si la fonction de classe est de gérer une collection d'objets (par exemple Person
, PersonManager
ou PersonList
), la méthode devrait juste être appelé find
, parce que le type de retour est implicite.
Sinon, je suivrais @nullpointer's advice en nommant la méthode findPersons
, car elle explique ce que fait le code.
Notez que les deux formes sont acceptables en anglais: «peuple» est plus familier, mais «personnes» apparaît dans le libellé traditionnel des vœux de mariage anglais: «J'appelle toutes les personnes présentes ici ...»; Ou dans le signalement d'un crime "perpétré par une personne ou des personnes inconnues". –