homyrouz.ru — Банкетный зал Хоми Роуз

Борис Акунин

Особые поручения: Декоратор

Скверное начало

Эраста Петровича Фандорина, чиновника особых поручений при московском генерал-губернаторе, особу 6 класса, кавалера российских и иностранных орденов, выворачивало наизнанку.

Тонкое, бледное до голубизны лицо коллежского советника страдальчески кривилось, одна рука, в белой лайковой с серебряными кнопочками перчатке была прижата к груди, другая судорожно рассекала воздух – этой неубедительной жестикуляцией Эраст Петрович хотел успокоить своего помощника: ничего, мол, ерунда, сейчас пройдет. Однако судя по продолжительности и мучительности спазмов это была очень даже не ерунда.

Помощнику Фандорина, губернскому секретарю Анисию Питиримовичу Тюльпанову, тощему, невзрачному молодому человеку 23 лет, никогда еще не доводилось видеть шефа в столь жалком состоянии. Тюльпанов и сам, впрочем, был несколько зелен лицом, но перед рвотным соблазном устоял и теперь втайне этим гордился. Впрочем, недостойное чувство было мимолетным и потому внимания не заслуживающим, а вот нежданная чувствительность обожаемого шефа, всегда такого хладнокровного и к сантиментам не расположенного, встревожила Анисия не на шутку.

– П-подите…, – морщась и вытирая перчаткой лиловые губы, выдавил Эраст Петрович. Всегдашнее легкое заикание, память о давней контузии, от нервного расстройства заметно усилилось. – Т-туда подите… Пусть п-протокол, п-подробный… Фотографические с-снимки во всех ракурсах. И следы чтоб не за…за…затоптали…

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

Идти назад, в серый полумрак, где вязко пахло кровью и требухой, Анисию не хотелось. Но служба есть служба.

Набрал в грудь побольше сырого апрельского воздуху (эх, самого бы не замутило), перекрестился и – как головой в омут.

В лачуге, использовавшейся для хранения дров, а ныне по случаю скорого окончания холодов почти опустевшей, собралось изрядное количество народу: следователь, агенты из сыскной, частный пристав, квартальный надзиратель, судебный врач, фотограф, городовые и еще дворник Климук, обнаруживший место чудовищного злодеяния – утром сунулся за дровишками, узрел, поорал сколько положено, да и побежал за полицией.

Горело два масляных фонаря, по низкому потолку колыхались неспешные тени. Было тихо, только в углу тонко всхлипывал и шмыгал носом молоденький городовой.

– Ну-с, а это у нас что? – с любопытством промурлыкал судебно-медицинский эксперт Егор Виллемович Захаров, поднимая с пола рукой в каучуковой перчатке нечто ноздреватое, иссиня-багровое. – Никак селезеночка. Вот и она, родимая. Отлично-с. В пакетик ее, в пакетик. Еще утроба, левая почка, и будет полный комплект, не считая всякой мелочи… Что это у вас, мсье Тюльпанов, под сапогом? Не брыжейка?

Анисий глянул вниз, в ужасе шарахнулся в сторону и чуть не споткнулся о распростертое тело девицы Андреичкиной, Степаниды Ивановны, 39 лет. Эти сведения, равно как и дефиниция ремесла покойной, были почерпнуты из желтого билета, аккуратно лежавшего на вспоротой груди. Более ничего аккуратного в посмертном обличье девицы Андреичкиной не наблюдалось.

Лицо у ней, надо полагать, и при жизни собой не видное, в смерти стало кошмарным: синюшное, в пятнах слипшейся пудры, глаза вылезли из орбит, рот застыл в беззвучном вопле. Ниже смотреть было еще страшней. Кто-то располосовал бедное тело гулящей вдоль и поперек, вынул из него всю начинку и разложил на земле причудливым узором. Правда, Егор Виллемович успел уже почти всю эту выставку собрать и по нумерованным пакетам разложить. Осталось только черное пятно привольно растекшейся крови, да мелкие лоскуты не то искромсанного, не то изорванного платья.

Леонтий Андреевич Ижицын, следователь по важнейшим делам при окружном прокуроре, присел на корточки подле врача, деловито спросил:

– Следы соития?

– Это я вам, голуба, после обрисую. Отчетец составлю, и все как есть отображу. Тут, сами видите, тьма египетская и стон кромешный.

Как всякий инородец, в совершенстве овладевший русским языком, Егор Виллемович любил вставлять в свою речь разные заковыристые обороты. Несмотря на вполне обычную фамилию, был эксперт британских кровей. В царствие покойного государя приехал докторов батюшка, тоже лекарь, в Россию, прижился, а трудную для русского уха фамилию Зэкарайэс приспособил к местным условиям – Егор Виллемович по дороге, как в пролетке ехали, сам рассказывал. По нему и видно, что не свой брат русак: долговязый, мосластый, волоса песочные, рот широкий, безгубый, подвижный, беспрестанно перегоняющий из угла в угол дрянную пеньковую трубку.

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

– Что, господин Тюльпанов, ваш начальник все воздухом дышит? А я говорил, преотлично обошлись бы и без губернаторского надзора. Не для утонченных глаз картинка, а мы люди ко всему привычные.

Понятное дело – недоволен Леонтий Андреевич, ревнует. Шутка ли – самого Фандорина за расследованием глядеть приставили. Какому ж следователю такое понравится.

– Да что ты, Линьков, как девка! – рыкнул Ижицын на всхлипывающего полицейского. – Привыкай. Ты не для «особых поручений», стало быть, всякого еще насмотришься.

– Не приведи Господь к такому привыкнуть, – вполголоса пробурчал старший городовой Приблудько, служака старый и опытный, Анисию известный по одному третьегоднишному делу.

Так ведь и с Леонтием Андреевичем не в первый раз вместе работать приходилось. Неприятный господин – дерганый весь, беспрестанно посмеивается, а глаза колючие. Одет с иголочки, воротнички будто из алебастра, манжеты и того белее, сам всё по плечам щелкает, соринки сбивает. Честолюбец, большую карьеру делает. Только вот на минувшее Крещение у него с расследованием по духовной купца Ситникова заминка вышла. Дело было шумное, отчасти даже затрагивающее интересы влиятельных особ и потому проволочки не терпящее, ну его сиятельство князь Долгорукой и попросил Эраста Петровича помочь прокуратуре. А из шефа известно какой помощник – взял да все дело в один день распутал. Не зря Ижицын бесится. Предчувствует, что сызнова ему без лавров оставаться.

– Вроде всё, – объявил следователь. – Стало быть, так. Труп в полицейский морг, на Божедомку. Сарай опечатать и городового поставить. Агентам опросить всех окрестных жителей, да построже. Не слыхали ли, не видали ли чего подозрительного. Ты, Климук, в последний раз за дровами в одиннадцатом часу заходил, так? – спросил Леонтий Андреевич дворника. – А смерть наступила не позднее двух ночи? (Это уже эксперту Захарову). Стало быть, интересоваться промежутком с начала одиннадцатого часа до двух пополуночи. – И снова Климуку. – Ты, может, с кем говорил уже из тутошних? Не рассказывали чего?

Дворник (пегая борода веником, кустистые брови, шишковатый череп, рост два аршина четыре вершка, особая примета – бородавка посередь лба, упражнялся в составлении словесного портрета Анисий) стоял, комкал и без того до невозможности мятый картуз.

– Никак нет, ваше высокоблагородие. Нешто мы не понимаем. Дверь сарая подпер и побег к господину Приблудько. А из околотка меня уж не пущали, пока начальники не прибудут. Обыватели, они и знать ничего не знают. То есть, конечно, видеть-то видют, что полиции понаехало… Что господа полицейские прибыть изволили. А про страсть эту (дворник боязливо покосился в сторону трупа) жителям неведомо.

– Вот это мы и проверим, – усмехнулся Ижицын. – Стало быть, агенты – за работу. А вы, господин Захаров, увозите свои сокровища. И чтоб к полудню полное заключение, по всей форме.

– Господ агентов п-прошу оставаться на месте, – раздался сзади негромкий голос Эраста Петровича. Все обернулись.

Как вошел коллежский советник, когда? И дверь-то не скрипнула. Даже в полумраке было видно, что шеф бледен и расстроен, однако голос ровный и манера говорить всегдашняя – сдержанная, учтивая, но такая, что возражать не захочешь.

– Господин Ижицын, даже дворник понял, что б-болтать о происшествии не следует, – сухо сказал Эраст Петрович следователю. – Я, собственно, для того и прислан, чтобы обеспечить строжайшую секретность. Никаких опросов. Более того, всех присутствующих прошу и даже обязываю хранить об обстоятельствах дела полное молчание. Жителям объяснить, что… п-повесилась гулящая, наложила на себя руки, обычное дело. Если по Москве поползут слухи о произошедшем, каждый из вас попадет под служебное расследование, и тот, кто окажется виновен в разглашении, понесет суровое наказание. Извините, господа, но т-таковы полученные мною инструкции, и на то есть свои причины.

Как это использовать и почему?

Декораторы в Python

Python имеет интересную функцию под названием декораторы для добавления функциональности в существующий код.

Это также называется метапрограммированием , потому что одна часть программы пытается изменить другую часть программы во время компиляции.

Необходимые условия для обучения декораторов

Чтобы понять, что такое декораторы, мы должны сначала знать несколько основных вещей в Python.

Мы должны быть довольны тем фактом, что все в Python (да! Даже классы) являются объектами. Имена, которые мы определяем, являются просто идентификаторами, связанными с этими объектами. Функции не являются исключением, они тоже объекты (с атрибутами). Различные разные имена могут быть связаны с одним и тем же функциональным объектом.

Вот пример.

  def первым (msg):
    печать (MSG)


первый ( "Hello")

второй = первый
второй («Привет»)  

Выход

  Привет
Привет  

Когда вы запускаете код, обе функции сначала и секунды дают одинаковый вывод.Здесь имена первых и вторых относятся к одному и тому же функциональному объекту.

Теперь все становится страннее.

Функции могут быть переданы в качестве аргументов другой функции.

Если вы использовали такие функции, как , карта , , фильтр и , уменьшающие в Python, то вы уже знаете об этом.

Такие функции, которые принимают другие функции в качестве аргументов, также называются функциями более высокого порядка . Вот пример такой функции.

  def inc (x):
    возврат х + 1


def dec (x):
    возврат х - 1


def работать (func, x):
    результат = func (x)
    возвращаемый результат  

Мы вызываем функцию следующим образом.

  >>> работаем (вкл., 3)
4
>>> работать (дек, 3)
2  

Кроме того, функция может возвращать другую функцию.

  def is_called ():
    def is_returned ():
        печать ( "Hello")
    возврат is_returned


new = is_called ()

# Выводит "Привет"
новый ()  

Выход

  Привет  

Здесь is_returned () — это вложенная функция, которая определяется и возвращается каждый раз, когда мы вызываем is_called () .

Наконец, мы должны знать о замыканиях в Python.

Возвращаясь к декораторам

Функции и методы называются , которые могут быть вызваны как , так как они могут быть вызваны.

Фактически, любой объект, который реализует специальный метод __call __ () , называется вызываемым. Таким образом, в самом простом смысле декоратор — это вызываемое, которое возвращает вызываемое.

По сути, декоратор принимает функцию, добавляет некоторую функциональность и возвращает ее.

  def make_pretty (func):
    def inner ():
        печать («Я получил украшен»)
        FUNC ()
    вернуться внутрь


def обычный ():
    печать («Я обычный»)  

При запуске следующих кодов в оболочке,

  >>> обычный ()
Я обычный

>>> # украсим эту обычную функцию
>>> pretty = make_pretty (обычный)
>>> довольно ()
Я украсилась
Я обычный  

В приведенном выше примере make_pretty () является декоратором.На шаге назначения:

  довольно = make_pretty (обычный)  

Функция normal () была декорирована, а возвращенная функция получила имя довольно .

Мы можем видеть, что функция декоратора добавила некоторые новые функциональные возможности к исходной функции. Это похоже на упаковку подарка. Декоратор действует как обертка. Характер предмета, который был украшен (фактический подарок внутри), не меняется. Но теперь, это выглядит симпатично (так как это было украшено).

Как правило, мы украшаем функцию и переназначаем ее как,

  обычный = make_pretty (обычный).  

Это обычная конструкция, и по этой причине в Python есть синтаксис, упрощающий это.

Мы можем использовать символ @ вместе с именем функции декоратора и поместить его над определением функции, которую нужно декорировать. Например,

  @make_pretty
def обычный ():
    печать («Я обычный»)  

эквивалентно

  def, обычный ():
    печать («Я обычный»)
обычный = make_pretty (обычный)  

Это просто синтаксический сахар для реализации декораторов.

Декорирование функций с параметрами

Вышеуказанный декоратор был прост и работал только с функциями, которые не имели никаких параметров. Что если бы у нас были функции, которые принимали параметры вроде:

  def делить (а, б):
    возврат а / б  

Эта функция имеет два параметра: a и b . Мы знаем, что это даст ошибку, если мы передадим b как 0.

  >>> делить (2,5)
0,4
>>> разделить (2,0)
Traceback (последний вызов последний):
,..
ZeroDivisionError: деление на ноль  

Теперь давайте создадим декоратор для проверки этого случая, который вызовет ошибку.

  def smart_divide (func):
    def inner (a, b):
        печать («Я собираюсь разделить», а, «и», б)
        если b == 0:
            печать ("Упс! не может разделить")
            возвращение

        возвратный функционал (а, б)
    вернуться внутрь


@smart_divide
делим деление (а, б):
    печать (а / б)  

Эта новая реализация вернет Нет , если возникнет условие ошибки.

  >>> делить (2,5)
Я собираюсь разделить 2 и 5
0,4

>>> разделить (2,0)
Я собираюсь разделить 2 и 0
Упс! не может разделить  

Таким образом, мы можем декорировать функции, которые принимают параметры.

Зоркий наблюдатель заметит, что параметры вложенной функции inner () внутри декоратора такие же, как параметры функций, которые он декорирует. Учитывая это, теперь мы можем создавать общие декораторы, которые работают с любым количеством параметров.

В Python эта магия выполняется как функция (* args, ** kwargs) . Таким образом, аргументов, будут кортежем позиционных аргументов, а кваргов, — словарём аргументов ключевых слов. Примером такого декоратора будет:

  def works_for_all (func):
    def inner (* args, ** kwargs):
        печать («Я могу украсить любую функцию»)
        return func (* args, ** kwargs)
    возврат внутренний  

Декораторы цепочки в Python

В Python могут быть объединены несколько декораторов.

То есть, функция может быть оформлена несколько раз разными (или одинаковыми) декораторами. Мы просто размещаем декораторы над желаемой функцией.

  def star (func):
    def inner (* args, ** kwargs):
        печать ("*" * 30)
        func (* args, ** kwargs)
        печать ("*" * 30)
    вернуться внутрь


def процентов (фунц):
    def inner (* args, ** kwargs):
        печать ("%" * 30)
        func (* args, ** kwargs)
        печать ("%" * 30)
    вернуться внутрь


@star
@процентов
Принтер по умолчанию (MSG):
    печать (MSG)


принтер («Привет»)  

Выход

  ******************************
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
Привет
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
******************************  

Вышеуказанный синтаксис,

  @star
@процентов
Принтер по умолчанию (MSG):
    Печать (MSG)  

эквивалентно

  def принтер (мсг):
    печать (MSG)
принтер = звезда (проценты (принтер))  

Порядок, в котором мы цепляем декораторов, имеет значение.Если бы мы изменили заказ как,

  @percent
@star
Принтер по умолчанию (MSG):
    Печать (MSG)  

Выход будет:

  %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
******************************
Привет
******************************
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%  

Учебник по шаблонам для декораторов

Это руководство предназначено для определения и применения шаблона проектирования Gang of Four (GoF). Прочитав этот учебник, вы узнаете, как разработать модель для шаблона декоратора и как применять его на практике.

• 8 октября 2009 г.
• просмотров: 14,876
• PDF

Модель проектирования с помощью диаграммы классов

1. Создайте новый проект Design Patterns .
2. Создайте диаграмму классов Декоратор .
   
3. Выберите Class на панели инструментов диаграммы. Нажмите на диаграмму, чтобы создать класс. Назовите его как Компонент .
   
4. Щелкните правой кнопкой мыши по компоненту и выберите Свойства элемента модели > Абстрактный , чтобы установить его как абстрактный.
   
5. Щелкните правой кнопкой мыши класс Компонент и выберите Добавить > Операция из всплывающего меню.
   
6. Назовите операцию Операция () .
7. Щелкните правой кнопкой мыши Операция и выберите Свойства элемента модели > Абстрактный , чтобы установить его как абстрактный.
   
8. Наведите курсор мыши на класс Компонент и перетащите Обобщение > Класс , чтобы создать подкласс ConcreteComponent . Повторите этот шаг для создания другого подкласса Decorator .
   
9. ConcreteComponent должен наследовать операции от компонента .Выберите ConcreteComponent , щелкните правой кнопкой мыши и выберите Связанные элементы > Реализовать все интерфейсы из всплывающего меню.
   
10. Декоратор — это абстрактный класс. Щелкните правой кнопкой мыши класс Decorator и выберите Свойства элемента модели > Абстрактный , чтобы установить его как абстрактный.
    
Декоратор
11. также должен наследовать операции от компонента . Выберите Декоратор , щелкните правой кнопкой мыши и выберите Связанные элементы > Реализовать все интерфейсы из всплывающего меню.
    
12. Наведите курсор мыши на Decorator class и перетащите Aggregation > Class на Component . Назовите роль компонента как компонент .
    
13. Наведите курсор мыши на класс Decorator и перетащите Обобщение > Класс , чтобы создать подкласс ConcreteDecorator .
14. Сделаем Конкретный декоратор реализует работу декоратора.Выберите Операция в Декоратор .
    
15. Нажмите клавишу Ctrl и перетащите ее на ConcreteDecorator .
    
16. На практике могут быть добавлены поведения в конкретных декораторов. Для представления этого стереотипируйте класс ConcreteDecorator как PTN Members Creatable . Щелкните правой кнопкой мыши ConcreteDecorator и выберите Стереотипы > Стереотипы … из всплывающего меню.
    
17. На вкладке Стереотипы диалогового окна Спецификация класса выберите PTN Members Creatable и нажмите>, чтобы назначить его Классу компонента .Нажмите ОК для подтверждения.
    
    До сих пор диаграмма должна выглядеть так:
    

Определяющий образец

1. Выберите все классы на диаграмме классов.
   
2. Щелкните правой кнопкой мыши по выбору и выберите Определить шаблон дизайна … во всплывающем меню.
   
3. В диалоговом окне Определить шаблон дизайна укажите имя шаблона Декоратор . Сохраните имя файла как есть. Нажмите ОК , чтобы продолжить.
   

Применение шаблона проектирования на диаграмме классов

В этом разделе мы собираемся применить шаблон декоратора для моделирования доменной модели редактора диаграмм.

1. Создайте новый проект Редактор диаграмм .
2. Создайте диаграмму классов Доменная модель .
3. Щелкните правой кнопкой мыши диаграмму классов и выберите Утилиты > Применить шаблон проектирования … во всплывающем меню.
   
4. В диалоговом окне Design Pattern выберите Decorator из списка шаблонов.
   
5. Нажмите на Компонент в обзоре.
   
6. Переименуйте Компонент от до Форма на нижней панели и операция Операция от до Рисование .
   
7. Выберите ConcreteComponent в обзоре и переименуйте его в LineShape и его действие Эксплуатация с по Нарисуйте на нижней панели.
   
8. Выберите Декоратор в обзоре и переименуйте его в ShapeDecorator и его работу Эксплуатация с по Нарисуйте на нижней панели.
   
9. Выберите ConcreteDecorator в обзоре и переименуйте его в BorderedShape и его действие Эксплуатация с по Нарисуйте на нижней панели.
   
10. Нам нужно несколько операций для дополнительного поведения в BorderDecorator . Нажмите кнопку + на нижней панели и выберите Новая операция … во всплывающем меню.
    
11. В диалоговом окне Спецификация операций введите RenderBorder в качестве имени операции.Нажмите ОК для подтверждения.
    
12. Нажмите ОК , чтобы применить шаблон к диаграмме. Это окончательная диаграмма:
    

Читатели этого урока также прочитали

— Итальянский язык WordReference