Паттерн "Декоратор (Decorator)", реализации на java, количество: 4 - CodeLAB.YOURS # Лаборатория кода # релиз 3.0

Главная >> Каталог задач >> Паттерны >> Структурные >> Декоратор (Decorator)

<< назад

распечатать обсудить >>

Декоратор (Decorator)
реализации: java, количество: 4

Aвтор: this
Дата: 18.08.2007
Просмотров: 18520
Рейтинг: 0/0,0(0)
+

реализации(исходники) +добавить

Имя
Условия
- Мотивация
- Признаки применения
Решение
Результаты
Пример
История
"Коллеги"

Имя

«Паттерн Decorator» codelab.ru codelab.ru источник оригинал

Декоратор - паттерн, структурирующий объекты, расширяя их функциональность. Также фигурирует под именем Wrapper. codelab.ru codelab.ru оригинал источник

Условия, Задача, Назначение

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

Мотивация

Иногда бывает нужно возложить дополнительные обязанности на отдельный объект, а не на класс в целом. Так, библиотека для построения графических интерфейсов пользователя должна «уметь» добавлять новое свойство, скажем, рамку или новое поведение (например, возможность прокрутки к любому элементу интерфейса). codelab.ru источник codelab.ru оригинал

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

Более гибким является другой подход: поместить компонент в другой объект, называемый декоратором, который как раз и добавляет рамку. Декоратор реализует интерфейс декорируемого объекта, поэтому его присутствие прозрачно для клиентов компонента, им, по сути, не важно с каким объектом они в данный момент имеют дело. источник оригинал codelab.ru codelab.ru

Декоратор переадресует запросы внутреннему компоненту, но может выполнять и дополнительные действия (например, рисовать рамку) до или после переадресации. Поскольку декораторы прозрачны, они могут вкладываться друг в друга, добавляя тем самым какое-угодно число новых возможностей. codelab.ru codelab.ru источник оригинал

codelab.ru оригинал источник codelab.ru

Предположим, что имеется объект класса TextView, который отображает текст в окне. По умолчанию TextView не имеет полос прокрутки, поскольку они не всегда нужны. Но при необходимости их удастся добавить с помощью декоратора ScrollDecorator. Допустим, что еще мы хотим добавить жирную сплошную рамку вокруг объекта TextView. Здесь может помочь декоратор BorderDecorator. источник codelab.ru оригинал codelab.ru

Мы просто передаем сначала объект TextView в декоратор ScrollDecorator, и затем полученный результирующий объект передаем далее в BorderDecorator – получаем искомый результат. codelab.ru оригинал codelab.ru источник

Ниже на диаграмме показано, как композиция объекта TextView с объектами BorderDecorator и ScrollDecorator порождает элемент для ввода текста, окруженный рамкой и снабженный полосой прокрутки. codelab.ru источник codelab.ru оригинал

источник оригинал codelab.ru codelab.ru

Классы ScrollDecorator и BorderDecorator являются подклассами Decorator - абстрактного класса, который представляет визуальные компоненты, применяемые для оформления других визуальных компонентов. оригинал codelab.ru источник codelab.ru

VisualComponent – это абстрактный класс для представления визуальных объектов. В нем определен интерфейс для рисования и обработки событий. Отметим, что класс Decorator просто переадресует запросы на рисование своему компоненту, а его подклассы могут расширять эту операцию. оригинал codelab.ru codelab.ru источник

codelab.ru оригинал codelab.ru источник

Подклассы Decorator могут добавлять любые операции для обеспечения необходимой функциональности. Так, операция ScrollTo объекта ScrollDecorator позволяет другим объектам выполнять прокрутку, если им известно о присутствии объекта ScrollDecorator. codelab.ru codelab.ru оригинал источник

Важная особенность этого паттерна состоит в том, что декораторы могут употребляться везде, где возможно появление самого объекта VisualComponent. Клиенту неважно с каким объектом работать: декорированным или недекорированным, он никоим образом не зависит от наличия или отсутствия оформлений. codelab.ru оригинал codelab.ru источник

Признаки применения, использования паттерна Декоратор (Decorator)

Используйте паттерн декоратор когда: оригинал источник codelab.ru codelab.ru

Для динамического и прозрачного для клиентов добавления новых возможностей, «фич» объектам; источник codelab.ru оригинал codelab.ru
Для реализации возможностей, которые нужны не всем объектам и не всегда, и потом можно было легко их исключить; codelab.ru codelab.ru оригинал источник
Когда расширение путем порождения подклассов по каким-то причинам неудобно или невозможно. Иногда приходится реализовывать много независимых расширений, так что порождение подклассов для поддержки всех возможных комбинаций приведет к комбинаторному росту их числа («комбинаторный взрыв»). В других случаях определение класса может быть скрыто или почему-либо еще недоступно, так что породить от него подкласс нельзя. источник codelab.ru оригинал codelab.ru

Решение

codelab.ru codelab.ru оригинал источник

оригинал codelab.ru codelab.ru источник

Участники паттерна Декоратор (Decorator)

codelab.ru оригинал источник codelab.ru

Component (VisualComponent) – компонент.
Класс, задает интерфейс для объектов, на которые могут быть динамически возложены дополнительные обязанности, ровно как задает его и для будущих декораторов. codelab.ru источник codelab.ru оригинал
ConcreteComponent (TextView) - конкретный компонент.
Определяет объект, на который возлагаются дополнительные обязанности, вешаются дополнительные возможности. оригинал источник codelab.ru codelab.ru
Decorator – декоратор.
Хранит ссылку на объект Component и наследует реализацию его интерфейса по-умалчанию; оригинал источник codelab.ru codelab.ru
ConcreteDecorator (BorderDecorator, ScrollDecorator) - конкретный декоратор.
Возлагает дополнительные обязанности на компонент. codelab.ru оригинал codelab.ru источник

Схема использования паттерна Декоратор (Decorator)

Клиенты работают только с интерфейсом Component. Когда нужно добавить функциональность в объект типа ConcreteComponent – берут соответствующий ConcreteDecorator, реализующий эту функциональность, конфигурируют, передают ему ссылку на первоначальный объект ConcreteComponent и прозрачно подсовывают клиенту. Клиент, вызывая те же методы, начинает вызывать их у ConcreteDecorator-а, тот, выполнив свою миссию, далее делегирует их первоначальному объекту ConcreteComponent. codelab.ru codelab.ru оригинал источник

источник codelab.ru codelab.ru оригинал

Вопросы, касающиеся реализации паттерна Декоратор (Decorator)

Применение паттерна декоратор требует рассмотрения следующих вопросов: codelab.ru источник codelab.ru оригинал

Соответствие интерфейсов.
Интерфейс декоратора должен соответствовать интерфейсу декорируемого компонента. Поэтому классы ConcreteDecorator должны наследоваться от общего класса; codelab.ru codelab.ru источник оригинал
Отсутствие абстрактного класса Decorator.
Нет необходимости определять класс Decorator абстрактным, если планируется добавить всего одну обязанность. Так часто происходит, когда вы работаете с уже существующей иерархией классов, а не проектируете новую. В таком случае ответственность за переадресацию запросов, которую обычно несет класс Decorator, можно возложить непосредственно на ConcreteDecorator, что конечно не помешает потом добавить новые декораторы, если потребуется: просто будет уже присутствовать некоторая реализация по-умалчанию. оригинал codelab.ru codelab.ru источник
Облегченные классы Component.
Чтобы можно было гарантировать соответствие интерфейсов, компоненты и декораторы должны наследовать общему классу Component. Важно, чтобы этот класс был настолько легким, насколько возможно. Иными словами, он должен определять интерфейс, а не хранить данные. В противном случае декораторы могут стать весьма тяжеловесными, и применять их в большом количестве будет накладно. Включение большого числа функций в класс Component также увеличивает вероятность, что конкретным подклассам придется платить за то, что им не нужно; оригинал источник codelab.ru codelab.ru
Изменение представления, а не внутреннего устройства объекта.
Декоратор можно рассматривать как появившуюся у объекта оболочку, которая изменяет его поведение. Противовес – изменение внутреннего устройства объекта, хорошим примером чего может служить паттерн стратегия.
Стратегии лучше подходят в ситуациях, когда класс Component уже достаточно тяжел, так что применение паттерна декоратор обходится слишком дорого. В паттерне стратегия компоненты передают часть своей функциональности отдельному объекту-стратегии, поэтому изменить или расширить поведение компонента можно, просто заменив этот объект.
Например, мы можем поддержать разные стили рамок, поручив рисование рамки специальному объекту Border. Объект Border является примером объекта-стратегии: в данном случае он инкапсулирует стратегию рисования рамки. Число стратегий может быть любым, поэтому эффект такой же, как от рекурсивной вложенности декораторов. источник codelab.ru codelab.ru оригинал

Рассмотрим дальше это интересное сравнение декораторов и стратегий.
Поскольку паттерн декоратор изменяет лишь внешний облик компонента-объекта, последнему ничего не надо «знать» о своих декораторах, то есть декораторы прозрачны для компонента. источник codelab.ru codelab.ru оригинал

оригинал codelab.ru codelab.ru источник

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

codelab.ru источник codelab.ru оригинал

источник codelab.ru codelab.ru оригинал

При использовании подхода, основанного на стратегиях, может возникнуть необходимость модифицировать компонент, чтобы он соответствовал новому расширению. В общем случае у стратегии может быть свой собственный специализированный интерфейс, тогда как интерфейс декоратора должен повторять интерфейс компонента. Например, стратегии рисования рамки необходимо определить всего лишь интерфейс для этой операции (DrawBorder, GetWidth и т.д.), то есть класс стратегии может быть легким, несмотря на тяжеловесность компонента.
Системы МасАрр и Bedrock применяют такой подход не только для оформления видов, но и для расширения особенностей поведения объектов, связанных с обработкой событий. В обеих системах вид ведет список объектов поведения, которые могут модифицировать и перехватывать события. Каждому зарегистрированному объекту поведения вид предоставляет возможность обработать событие до того, как оно будет передано незарегистрированным объектам такого рода, за счет чего достигается переопределение поведения. Можно, например, декорировать вид специальной поддержкой работы с клавиатурой, если зарегистрировать объект поведения, который перехватывает и обрабатывает события нажатия клавиш. codelab.ru codelab.ru источник оригинал

оригинал источник codelab.ru codelab.ru

Результаты

У паттерна декоратор есть, по крайней мере, 2 плюса и два минуса, плюсы: оригинал codelab.ru codelab.ru источник

Большая гибкость, нежели у статического наследования.
Паттерн декоратор позволяет более гибко добавлять объекту новые обязанности, чем это было бы возможно в случае статического (множественного) наследования. Декоратор может добавлять и удалять эту функциональность во время выполнения программы. При использовании же наследования требуется создавать новый класс для каждой дополнительной обязанности (например, Bor.deredScrollableTextView, BorderedTextView), что ведет к увеличению числа классов и, как следствие, к возрастанию сложности системы. Кроме того, применение нескольких декораторов к одному компоненту позволяет произвольным образом сочетать обязанности. Декораторы позволяют легко добавить одно и то же свойство дважды. Например, чтобы окружить объект TextView двойной рамкой, нужно просто добавить два декоратора BorderDecorators. Двойное наследование классу Border в лучшем случае чревато ошибками; источник codelab.ru codelab.ru оригинал
Позволяет избежать перегруженных функциями классов на верхних уровнях иерархии.
Декоратор разрешает добавлять новые обязанности по мере необходимости. Вместо того чтобы пытаться поддержать все мыслимые возможности в одном сложном, допускающем разностороннюю настройку классе, вы можете определить простой класс и постепенно наращивать его функциональность с помощью декораторов. В результате приложение уже не платит за неиспользуемые функции. Нетрудно также определять новые виды декораторов независимо от классов, которые они расширяют, даже если первоначально такие расширения не планировались. При расширении же сложного класса обычно приходится вникать в детали, не имеющие отношения к добавляемой функции; источник оригинал codelab.ru codelab.ru

источник codelab.ru codelab.ru оригинал

и минусы: оригинал codelab.ru источник codelab.ru

Декоратор и его компонент не идентичны.
Декоратор действует как прозрачное обрамление. Но декорированный компонент все же не идентичен исходному. При использовании декораторов это следует иметь в виду; источник codelab.ru codelab.ru оригинал
Множество мелких объектов.
При использовании в проекте паттерна декоратор нередко получается система, составленная из большого числа мелких объектов, которые похожи друг на друга и различаются только способом взаимосвязи, а не классом и не значениями своих внутренних переменных. Хотя проектировщик, разбирающийся в устройстве такой системы, может легко настроить ее, но изучать и отлаживать ее довольно обременительно. источник codelab.ru оригинал codelab.ru

оригинал codelab.ru источник codelab.ru

Пример

codelab.ru источник codelab.ru оригинал

Применение паттерна декоратор довольно распространено. Один из ближайших примеров – фреймворк автоматизированного тестирования JUnit. оригинал codelab.ru codelab.ru источник

Паттерн декоратор здесь используется для прозрачного добавления новых возможностей в процесс выполнения теста. codelab.ru источник оригинал codelab.ru

Интерфейс для теста выглядит просто: junit.framework.Test.java. источник codelab.ru оригинал codelab.ru

Декоратор к нему: junit.extensions.TestDecorator.java. codelab.ru codelab.ru источник оригинал

Конфигурирующийся соответственно объектом типа Test (JUnit4TestAdapter например). codelab.ru источник оригинал codelab.ru

Фрейворк добавляет такие конкретные виды декораторов, как: junit.extensions.RepeatedTest.java - позволяющий многократное выполнение теста, а также другой декоратор:
junit.extensions.TestSetup.java
- добавляющий возможность выполнять дополнительные действия до и после выполнения теста.

Соответственно, чтобы добавить эту функциональность, можно, например, создать объект типа TestSetup, передав ему имеющийся объект типа Test, далее чтобы добавить еще и многократное выполнение, создаем объект типа RepeatedTest, передавая туда созданный ранее объект типа TestSetup. codelab.ru codelab.ru оригинал источник

Известные применения паттерна Декоратор (Decorator)

Во многих библиотеках для построения объектно-ориентированных интерфейсов пользователя декораторы применяются для добавления к виджетам графических оформлений. В качестве примеров можно назвать Interviews, ЕТ++ и библиотеку классов Smalltalk. Другие варианты применения паттерна декоратор - это класс DebuggingGlyph из библиотеки Interviews и PassivityWrapper из ParcPlace Smalltalk. DebuggingGlyph печатает отладочную информацию до и после того, как переадресует запрос на размещение своему компоненту. Эта информация может быть полезна для анализа и отладки стратегии размещения объектов в сложном контейнере. Класс PassivityWrapper позволяет разрешить или запретить взаимодействие компонента с пользователем. оригинал codelab.ru источник codelab.ru

Но применение паттерна декоратор никоим образом не ограничивается графическими интерфейсами пользователя, как показывает следующий пример, основанный на потоковых классах из каркаса ЕТ++. оригинал источник codelab.ru codelab.ru

Поток - это фундаментальная абстракция в большинстве средств ввода/вывода. Он может предоставлять интерфейс для преобразования объектов в последовательность байтов или символов. Это позволяет записать объект в файл или буфер в памяти и впоследствии извлечь его оттуда. Самый очевидный способ сделать это - определить абстрактный класс Stream с подклассами MemoryStream и FileStream. Предположим, однако, что нам хотелось бы еще уметь: codelab.ru codelab.ru источник оригинал

компрессировать данные в потоке, применяя различные алгоритмы сжатия (кодирование повторяющихся серий, алгоритм Лемпеля-Зива и т.д.) источник codelab.ru codelab.ru оригинал
преобразовывать данные в 7-битные символы кода ASCII для передачи по каналу связи источник оригинал codelab.ru codelab.ru

Паттерн декоратор позволяет весьма элегантно добавить такие обязанности потокам. На диаграмме ниже показано одно из возможных решений задачи: оригинал источник codelab.ru codelab.ru

оригинал источник codelab.ru codelab.ru

Абстрактный класс Stream имеет внутренний буфер и предоставляет операции для помещения данных в поток (Putlnt, PutString). Как только буфер заполняется, Stream вызывает абстрактную операцию HandleBufferFull, которая выполняет реальное перемещение данных. В классе FileStream эта операция замещается так, что буфер записывается в файл. codelab.ru источник codelab.ru оригинал

Ключевым здесь является класс StreamDecorator. Именно в нем хранится ссылка на тот поток-компонент, которому переадресуются все запросы. Подклассы StreamDecorator замещают операцию HandleBufferFull и выполняют дополнительные действия, перед тем как вызвать реализацию этой операции в классе StreamDecorator. codelab.ru источник codelab.ru оригинал

Например, подкласс CompressingStream сжимает данные, a ASCII7Stream конвертирует их в 7-битный код ASCII. Теперь, для того чтобы создать объект FileStream, который одновременно сжимает данные и преобразует результат в 7-битный код, достаточно просто декорировать FileStream с использованием CompressingStream и ASCII7Stream: оригинал источник codelab.ru codelab.ru

декоратор на примере сжатия потока и преобразования в 7 битный код [C++] ссылка

Stream* aStream = new CompressingStream (
  new ASCII7Stream(
    new FileStream ( "aFileName")
  )
);
aStream->PutInt(12);
aStream->PutString("aString");

Stream* aStream = new CompressingStream (
  new ASCII7Stream(
    new FileStream ( "aFileName")
  )
);
aStream->PutInt(12);
aStream->PutString("aString");

источник оригинал codelab.ru codelab.ru

источник codelab.ru оригинал codelab.ru

Родственные паттерны

Адаптер: если декоратор изменяет только обязанности объекта, но не его интерфейс, то адаптер придает объекту совершенно новый интерфейс. источник codelab.ru оригинал codelab.ru

Компоновщик: декоратор можно считать вырожденным случаем составного объекта, у которого есть только один компонент. Однако декоратор добавляет новые обязанности, агрегирование объектов не является его целью. codelab.ru codelab.ru источник оригинал

Стратегия: декоратор позволяет изменить внешний облик объекта, стратегия - его внутреннее содержание. Это два взаимодополняющих способа изменения объекта. codelab.ru источник оригинал codelab.ru

codelab.ru оригинал источник codelab.ru

Реализации: java(4) +добавить реализацию

1) junit.framework.Test.java, code #459[автор:this]
2) junit.extensions.TestDecorator.java, code #460[автор:this]

обсудить >>

DecoratorTest, сущность Decorator, java, code #460 ссылка +
рейтинг: 7/3,5.03(540), управление:

package junit.extensions;
 
import junit.framework.Assert;
import junit.framework.Test;
import junit.framework.TestResult;
 
/**
 * A Decorator for Tests. Use TestDecorator as the base class for defining new
 * test decorators. Test decorator subclasses can be introduced to add behaviour
 * before or after a test is run.
 * 
 */
public class TestDecorator extends Assert implements Test {
	protected Test fTest;
 
	public TestDecorator(Test test) {
		fTest= test;
	}
 
	/**
	 * The basic run behaviour.
	 */
	public void basicRun(TestResult result) {
		fTest.run(result);
	}
 
	public int countTestCases() {
		return fTest.countTestCases();
	}
 
	public void run(TestResult result) {
		basicRun(result);
	}
 
	@Override
	public String toString() {
		return fTest.toString();
	}
 
	public Test getTest() {
		return fTest;
	}
}

package junit.extensions;

import junit.framework.Assert;
import junit.framework.Test;
import junit.framework.TestResult;

/**
 * A Decorator for Tests. Use TestDecorator as the base class for defining new
 * test decorators. Test decorator subclasses can be introduced to add behaviour
 * before or after a test is run.
 * 
 */
public class TestDecorator extends Assert implements Test {
	protected Test fTest;

	public TestDecorator(Test test) {
		fTest= test;
	}

	/**
	 * The basic run behaviour.
	 */
	public void basicRun(TestResult result) {
		fTest.run(result);
	}

	public int countTestCases() {
		return fTest.countTestCases();
	}

	public void run(TestResult result) {
		basicRun(result);
	}

	@Override
	public String toString() {
		return fTest.toString();
	}

	public Test getTest() {
		return fTest;
	}
}

Сущность Decorator

Декоратор вводящий функцию подсчета количества тестируемых случаев.

Тестировалось на: java 1.5.0_04

обсудить >>

3) junit.extensions.RepeatedTest.java, code #461[автор:this]
4) junit.extensions.TestSetup.java, code #462[автор:this]

обсудить >>

TestSetup, сущность ConcreteDecorator, java, code #462 ссылка +
рейтинг: 3/7,4.99(486), управление:

package junit.extensions;
 
import junit.framework.Protectable;
import junit.framework.Test;
import junit.framework.TestResult;
 
/**
 * A Decorator to set up and tear down additional fixture state. Subclass
 * TestSetup and insert it into your tests when you want to set up additional
 * state once before the tests are run.
 */
public class TestSetup extends TestDecorator {
 
	public TestSetup(Test test) {
		super(test);
	}
 
	@Override
	public void run(final TestResult result) {
		Protectable p= new Protectable() {
			public void protect() throws Exception {
				setUp();
				basicRun(result);
				tearDown();
			}
		};
		result.runProtected(this, p);
	}
 
	/**
	 * Sets up the fixture. Override to set up additional fixture state.
	 */
	protected void setUp() throws Exception {
	}
 
	/**
	 * Tears down the fixture. Override to tear down the additional fixture
	 * state.
	 */
	protected void tearDown() throws Exception {
	}
}

package junit.extensions;

import junit.framework.Protectable;
import junit.framework.Test;
import junit.framework.TestResult;

/**
 * A Decorator to set up and tear down additional fixture state. Subclass
 * TestSetup and insert it into your tests when you want to set up additional
 * state once before the tests are run.
 */
public class TestSetup extends TestDecorator {

	public TestSetup(Test test) {
		super(test);
	}

	@Override
	public void run(final TestResult result) {
		Protectable p= new Protectable() {
			public void protect() throws Exception {
				setUp();
				basicRun(result);
				tearDown();
			}
		};
		result.runProtected(this, p);
	}

	/**
	 * Sets up the fixture. Override to set up additional fixture state.
	 */
	protected void setUp() throws Exception {
	}

	/**
	 * Tears down the fixture. Override to tear down the additional fixture
	 * state.
	 */
	protected void tearDown() throws Exception {
	}
}

Сущность ConcreteDecorator

Декоратор добавляющий возможность выполнять дополнительные действия до и после выполнения теста.

Тестировалось на: java 1.5.0_04

обсудить >>

<< назад наверх

распечатать обсудить >>

Декоратор (Decorator)
реализации: java, количество: 4

Имя

Условия, Задача, Назначение

Мотивация

Признаки применения, использования паттерна Декоратор (Decorator)

Решение

Участники паттерна Декоратор (Decorator)

Схема использования паттерна Декоратор (Decorator)

Вопросы, касающиеся реализации паттерна Декоратор (Decorator)

Результаты

Пример

Известные применения паттерна Декоратор (Decorator)

Родственные паттерны

Свежие исходники:

Интересные задачи:

Популярные задачи:

*	можно кириллицей (недопустимые символы:?&+=\/%#)
**	только для зарегистрированных пользователей

Декоратор (Decorator) реализации: java, количество: 4

Имя

Условия, Задача, Назначение

Мотивация

Признаки применения, использования паттерна Декоратор (Decorator)

Решение

Участники паттерна Декоратор (Decorator)

Схема использования паттерна Декоратор (Decorator)

Вопросы, касающиеся реализации паттерна Декоратор (Decorator)

Результаты

Пример

Известные применения паттерна Декоратор (Decorator)

Родственные паттерны

Свежие исходники:

Интересные задачи:

Популярные задачи:

Декоратор (Decorator)
реализации: java, количество: 4