Солидбук

Read the description in English. The translation is on the way. Hold tight and stay tuned!

Книга о принципах SOLID и объектно-ориентированном дизайне программ.

О чём это и для кого

Программировать — сложно.

Хороший код адекватно отражает систему, которую описывает, он устойчив к изменениям в этой системе. Плохой код запутанный, хрупкий и непонятный — он замедляет разработку.

Код становится плохим, когда он перестаёт соответствовать реальности — бизнес-требованиям, правилам поведения частей системы, их отношениям друг с другом. Бизнес-правила — это территория, код — карта этой территории. Чем точнее карта, тем проще справляться с изменениями в требованиях и даже предвидеть их.

В этой книге мы хотим рассказать и показать на примерах, как принципы объектно-ориентированного программирования могут помочь спроектировать устойчивую систему.

О каких принципах пойдёт речь?

Мы рассмотрим 5 принципов SOLID, а именно:

Каждый из принципов — это лишь рекомендация, все они имеют область и границы применения. Но чтобы увидеть эти границы, необходимо понять, в чём польза и издержки каждого. Многие принципы вам покажутся чрезмерно абстрактными, неконкретными или вовсе надуманными. Отнеситесь к таким принципам, как к дзену Python — держите в голове, но проверяйте, насколько они полезны в конкретной ситуации.

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

Об авторах

Эту книжку написали:

Саша Беспоясов — разработчик в 0+X, соавтор Тяжеловато, бывший преподаватель в Нетологии;
Артём Самофалов — ведущий фронтенд-разработчик в Social Discovery Ventures, бывший преподаватель в LoftSchool.

...И контрибьюторы проекта ❤️

Лицензии

Текст и иллюстрации книги распространяются под лицензией CC BY-NC-SA 4.0. Вы можете дополнять, менять и использовать их в проектах на некоммерческой основе при сохранении лицензии и указании авторов.

Исходный код проекта распространяется под лицензией MIT.

Wrong code example on "srp/in-ideal-world" page

Вопрос к примеру из главы https://ota-solid.now.sh/srp/in-ideal-world

В первом блоке кода следующий пример:

// класс, который занимается экспортом данных
class ReportExporter {
  name: string
  data: ReportData

  constructor(name: string, data: ReportData) {
    this.name = name
    this.data = data
  }

  export(reportType: ReportTypes): string {
    const formatter: Formatter = new FormatSelector(reportType, this.data)
    return formatter.format()
  }
}

У FormatSelector мы вызываем конструктор с двумя переменными reportType и this.data
Затем вызывает formatter.format() без аргументов

Но конструктор FormatSelector принимает только одну переменную:

class FormatSelector {
  formatters = {
    [ReportTypes.Html]: HtmlFormatter,
    [ReportTypes.Txt]: TxtFormatter,
  }

  constructor(reportType: ReportTypes) {
    const FormatterFactory = this.formatters[reportType]
    return new FormatterFactory()
  }
}

const dynamicFormatter = new FormatSelector(ReportTypes.Html)
dynamicFormatter.format(/*...*/)

А метод format принимает data:

interface Formatter {
  format(data: ReportData): string;
}

bespoyasov / solidbook Goto Github PK

solidbook's Introduction

Солидбук

О чём это и для кого

О каких принципах пойдёт речь?

Об авторах

Лицензии

solidbook's People

Contributors

Stargazers

Watchers

Forkers

solidbook's Issues

Recommend Projects

Recommend Topics

Recommend Org