Руководство по проектированию чистого интерфейса - PullRequest
Новая
       23

Руководство по проектированию чистого интерфейса

7 голосов
/ 26 февраля 2010

Когда я читал статьи о разработке программного обеспечения, я часто слышал фразу «чистый интерфейс». Люди говорили о чистом интерфейсе для API и классов.

Как вы определяете «чистый интерфейс»? Есть ли рекомендации по проектированию системы с чистым интерфейсом?

Ответы [ 3 ]

4 голосов
/ 26 февраля 2010

Об этом написано целых книг, и Руководство по разработке фреймворка (.NET-centric) является одним из моих любимых. Там много чего, и нет простого ответа, но если бы я нажал для простого ответа, я бы сказал, спроектировать API так, чтобы простые вещи могли быть выполнены без необходимости для разработчика читать какие-либо расширенные документация. Это подразумевает простой, последовательный интерфейс с понятными, описательными именами. Не усложняйте основные вещи.

3 голосов
/ 26 февраля 2010

«Чистый интерфейс» - это тот, который не пропускает детали реализации. Его легко понять, он не раскрывает его приватные части и не приводит к чрезмерной связи между вами и кодом, с которым вы взаимодействуете. Это скорее запах кода, чем строгое определение ...

1 голос
/ 26 февраля 2010

Сохраняйте это простым и напишите простой и быстрый, не требующий пояснений код. Тот, который легко читать и поддерживать.

...