Занимаясь парным программированием с разработчиками, я заметил, что некоторые из них не решаются вводить объясняющую переменную. Они больше беспокоятся о том, что другие разработчики думают об этой дополнительной переменной.
Не будет ли лишним иметь дополнительную переменную? Что ж, посмотрим:
До
В приведенном выше фрагменте кода (…даже несмотря на то, что он простой) сравнение размера файла с произвольным числом не дает четкого представления о каком-либо бизнес-правиле. Вы не можете легко предсказать значение «10000000» или размер, будь то биты, байты, КБ, МБ или что-то еще. Тот, кто посещает этот фрагмент, должен потратить некоторое время, чтобы выяснить намерение.
Что ж, давайте введем объясняющую переменную и посмотрим, поможет ли это.
Лучший способ:
Я знаю, я увеличил строку кода здесь. Однако вам не кажется, что введение объясняющей переменной сделало его выразительным и понятным. Теперь это читается так:
Когда размер файла превышает максимально допустимый размер (10000000 байт!), просто выйдите!
Другой пример:
До
Мне очень тяжело, когда я читаю это в первый раз.
Лучший способ:
По крайней мере, теперь вы знаете, что существует регулярное выражение для допустимого шаблона номера телефона. Он используется, чтобы определить, является ли номер телефона действительным или нет, и принять соответствующие меры.
Введите объясняющую переменную, чтобы передать свое намерение. Это один из способов выразить себя через код.
Первоначально опубликовано на https://beingcraftsman.com 9 марта 2018 г.