Как корректнее называть методы в Java?

Question

[4ex0V]

Здравствуйте!

Выскажите, пожалуйста, мнение относительно следующего наименования методов в Java.

Допустим, у меня есть некоторый DAO класс:

public class DAO
{
   public Collection<Event> getEvents() { . . . }

   public Collection<Event> getEventsByTimerange(DateTime from, DateTime until) { . . . } 

   public Collection<Event> getEventsByPlace(String place) { . . . }
}

Согласно документации Oracle сигнатурой метода является его название и параметры.

Я считаю, что нужно воспользоваться перегрузкой и называть методы следующим образом, чтобы сигнатура говорила сама за себя, т.е.:

public class DAO
{
   public Collection<Event> getEvents() { . . . }

   public Collection<Event> getEvents(DateTime from, DateTime until) { . . . } 

   public Collection<Event> getEvents(String place) { . . . }
}

Такое наименование методов более логичное, а так же позволяет быстро находить необходимое.

Может быть кто-то встречал рассуждения на эту тему или готов высказать свое компетентное мнение?

Буду рад любому ответу. Большое спасибо!

Answer 1

[Виталий Витренко]

Joshua Bloch - Effective Java, Item 41.

Comments

[4ex0V]

Т.е. в моем случае overloading можно использовать?

[Виталий Витренко]

4ex0V: ну те три метода выглядят вполне однозначно, но если придется сделать еще один с одним аргументом, то могут быть проблемы. Мне кажется в вашем случае напрашивается решение с одним методом который принимает критерий выбора.

[4ex0V]

Не могли бы раскрыть подробнее что имеете ввиду под " решение с одним методом который принимает критерий выбора"?

[Виталий Витренко]

4ex0V: что то типа getEvents(Specification specification). А в Specification уже указана информация по каким критериям вы хотите сделать выборку. Можете посмотреть в сторону Spring Data JPA Specification или QueryDSL. Все, конечно, зависит от того насколько flexible должен быть репозиторий. Возможно в вашем случае этих трех методов достаточно.