Новый интерфейс, старая реализация

Представим, что нам нужно вызвать процедуру, но из-за программного интерфейса это оказывается слишком сложно, неочевидно или просто утомительно. Чтобы это исправить, реализуем новый, более удобный интерфейс и будем работать через него. При этом пока оставим внутри простой вызов старого интерфейса, а новую реализацию можно будет добавить позже

Создание удобного программного интерфейса очень важная часть программного дизайна. Изменения в системе должны вноситься просто и удобно. Если текущий интерфейс этого не позволяет, значит, его нужно менять

Подходы:
1. «Начать с конца» - начните с последней строки процедуры. У вас уже есть все промежуточные данные, и вы можете подготовить их так, как удобно.
Например, процедура возвращает документ, а нам нужны дополнительные реквизиты. Дополняем результат, оборачиваем его в структуру и возвращаем

2. «Сначала тесты» - перед изменениями добавьте тесты, которые должны проходить, а затем вносите изменения

3. Проектирование хелперов - представьте, что уже существует метод, который делает все необходимое. Тогда остальная логика становится простой. Начните с создания такого метода


Короче, необязательно все переделывать сразу, можно начать с создания удобной обертки для старой реализации