LXF94:Команды и фабрики - История изменений

Lockal: Перенаправление на LXF94:Java EE

2008-03-22T08:32:22Z

Перенаправление на LXF94:Java EE

Внесённые изменения

Lodger: /* Фабрика команд */

2008-03-22T04:39:29Z

‎Фабрика команд

Lodger: /* Команды */

2008-03-22T04:31:34Z

‎Команды

Lodger: /* Команды */

2008-03-22T04:31:00Z

‎Команды

Lodger: /* Команды */

2008-03-22T04:30:29Z

‎Команды

Lodger: /* Команды */

2008-03-22T04:28:05Z

‎Команды

Lodger: /* Создание экземпляра класса по имени */

2008-03-22T04:27:33Z

‎Создание экземпляра класса по имени

Lodger: /* Что дальше? */

2008-03-22T04:25:58Z

‎Что дальше?

Lodger: /* Хранение настроек команд */

2008-03-22T04:24:51Z

‎Хранение настроек команд

Lodger: /* Команды */

2008-03-22T04:21:03Z

‎Команды

← Предыдущая		Версия 04:39, 22 марта 2008
Строка 205:		Строка 205:
	=== Фабрика команд ===		=== Фабрика команд ===

		+	Суть паттерна Factory Method заключается в том, что его реализация позволяет создавать экземпляры конкретных объектов, причем в этом случае сохраняется зависимость от абстрактных интерфейсов. Следовательно, данный шаблон в значительной мере может пригодиться в процессе активной разработки приложений, при которой конкретные классы обладают высоким уровнем изменчивости, что и требуется для решения последней задачи [2].

		+	Если мы применим идею паттерна Factory Method для создания фабрики команд к нашему web-приложению, оно приобретет свойство расширяемости за счет слабосвязанности классов (см. Рис. 2), т.е. класс AddressBookServlet напрямую не будет связан с конкретными командами, а будет взаимодействовать с ними посредством Command и CommandFactory.
		+
		+	[[Image:Java 6 2.jpg\|right\|thumb\|320px\|Рис. 2. Диаграмма классов, применение фабрики команд.]]
		+
		+	Ниже представлен ключевой метод getCommand() класса CommanFactory, в котором согласно параметру name извлекаются настройки из файла конфигурации web-приложения и создается экземпляр необходимой команды (метод реализован не оптимально):
		+
		+	public Command getCommand(String name, HttpServletRequest
		+	aRequest,
		+	HttpServletResponse aResponse) {
		+	if (name != null) {
		+	if (config.getInitParameter(name) != null) {
		+	try {
		+	String key = config.getInitParameter(name);
		+	Class cmd1 = Class.forName(config.getInitParameter(key + “Command”));
		+	try {
		+	Class[] parameterTypes = new Class[6];
		+	parameterTypes[0] = ServletContext.class;
		+	parameterTypes[1] = HttpServletRequest.class;
		+	parameterTypes[2] = HttpServletResponse.class;
		+	parameterTypes[3] = String.class;
		+	parameterTypes[4] = String.class;
		+	parameterTypes[5] = String.class;
		+	Constructor constructor = cmd1.getConstructor(parameterTypes);
		+	Object[] args = new Object[6];
		+	args[0] = sc;
		+	args[1] = aRequest;
		+	args[2] = aResponse;
		+	args[3] = config.getInitParameter(key + “View”);
		+	args[4] = config.getInitParameter(key + “Result”);
		+	args[5] = config.getInitParameter(key + “Error”);
		+	Command cmd = (Command) constructor.newInstance(args);
		+	return cmd;
		+	} catch (Exception e) {
		+	e.printStackTrace();
		+	return null;
		+	}
		+	} catch (ClassNotFoundException e) {
		+	e.printStackTrace();
		+	return null;
		+	}}}
		+	return null;}
		+
		+	Добавим последний штрих в web-приложение – изменим метод handle класса AddressBookServlet, чтобы он работал с созданной фабрикой:
		+
		+	Command cmd;
		+	CommandFactory cf = new CommandFactory(this.getServletConfig(),this.getServletContext());
		+	cmd = cf.getCommand(
		+	aRequest.getRequestURI().substring(aRequest.getContextPath().length()),
		+	aRequest, aResponse);
		+	if (cmd == null) {
		+	cmd = cf.getCommand(“/”, aRequest, aResponse);
		+	}
		+	try {
		+	cmd.execute();
		+	} catch (Exception e) {
		+	// oopst...
		+	e.printStackTrace();
		+	}
		+
		+	Предложенная реализация закрывает для пользователя вызов не описанных в конфигурации адресов.

	=== Что дальше? ===		=== Что дальше? ===

@@ Строка 24: / Строка 24: @@
 Выше представлен простой интерфейс Command всего с одним методом execute(), который и олицетворяет идею одноименного паттерна. Он будет нашим стандартым интерфейсом. Более сложная реализация интерфейса включает метод unexecute(). Класс, реализующий интерфейс Command, инкапсулирует в методе execute() обозначенные выше атомарные операции, а в методе unexecute() реализуется механизм отмены. Часто методы execute() и unexecute() называют do() и undo(), соответственно.
-[[Image:Java 6 1.jpg|left|thumb|280px|Рис. 1. Диаграмма классов.]]
+[[Image:Java 6 1.jpg|right|thumb|300px|Рис. 1. Диаграмма классов.]]
 Выделим команды, которые нам необходимо реализовать (отметим удачное разделение на методы): Add, Auth, Edit, View, Remove. Учитывая то, что у наших команд будут некоторые идентичные методы и атрибуты, предлагаю создать абстрактный класс AbstractHTTPCommand, в котором они будут собраны. Класс будет реализовывать интерфейс Command, и его наследование автоматически позволит обеспечить необходимый уровень интеграции. Итак, в основе каждой команды будет лежать абстрактный класс AbstractHTTPCommand, в котором реализован интерфейс для выполнения операций (на Рис. 1 вы можете видеть диаграмму классов команд нашего приложения).

@@ Строка 24: / Строка 24: @@
 Выше представлен простой интерфейс Command всего с одним методом execute(), который и олицетворяет идею одноименного паттерна. Он будет нашим стандартым интерфейсом. Более сложная реализация интерфейса включает метод unexecute(). Класс, реализующий интерфейс Command, инкапсулирует в методе execute() обозначенные выше атомарные операции, а в методе unexecute() реализуется механизм отмены. Часто методы execute() и unexecute() называют do() и undo(), соответственно.
-[[Image:Java 6 1.jpg|left|trumb|280px|Рис. 1. Диаграмма классов.]]
+[[Image:Java 6 1.jpg|left|thumb|280px|Рис. 1. Диаграмма классов.]]
 Выделим команды, которые нам необходимо реализовать (отметим удачное разделение на методы): Add, Auth, Edit, View, Remove. Учитывая то, что у наших команд будут некоторые идентичные методы и атрибуты, предлагаю создать абстрактный класс AbstractHTTPCommand, в котором они будут собраны. Класс будет реализовывать интерфейс Command, и его наследование автоматически позволит обеспечить необходимый уровень интеграции. Итак, в основе каждой команды будет лежать абстрактный класс AbstractHTTPCommand, в котором реализован интерфейс для выполнения операций (на Рис. 1 вы можете видеть диаграмму классов команд нашего приложения).

@@ Строка 24: / Строка 24: @@
 Выше представлен простой интерфейс Command всего с одним методом execute(), который и олицетворяет идею одноименного паттерна. Он будет нашим стандартым интерфейсом. Более сложная реализация интерфейса включает метод unexecute(). Класс, реализующий интерфейс Command, инкапсулирует в методе execute() обозначенные выше атомарные операции, а в методе unexecute() реализуется механизм отмены. Часто методы execute() и unexecute() называют do() и undo(), соответственно.
-[[Image:Java 6 1.jpg|left|280px|trumb|Рис. 1. Диаграмма классов.]]
+[[Image:Java 6 1.jpg|left|trumb|280px|Рис. 1. Диаграмма классов.]]
 Выделим команды, которые нам необходимо реализовать (отметим удачное разделение на методы): Add, Auth, Edit, View, Remove. Учитывая то, что у наших команд будут некоторые идентичные методы и атрибуты, предлагаю создать абстрактный класс AbstractHTTPCommand, в котором они будут собраны. Класс будет реализовывать интерфейс Command, и его наследование автоматически позволит обеспечить необходимый уровень интеграции. Итак, в основе каждой команды будет лежать абстрактный класс AbstractHTTPCommand, в котором реализован интерфейс для выполнения операций (на Рис. 1 вы можете видеть диаграмму классов команд нашего приложения).

@@ Строка 24: / Строка 24: @@
 Выше представлен простой интерфейс Command всего с одним методом execute(), который и олицетворяет идею одноименного паттерна. Он будет нашим стандартым интерфейсом. Более сложная реализация интерфейса включает метод unexecute(). Класс, реализующий интерфейс Command, инкапсулирует в методе execute() обозначенные выше атомарные операции, а в методе unexecute() реализуется механизм отмены. Часто методы execute() и unexecute() называют do() и undo(), соответственно.
-[[Image:Java 6 1.jpg|left|300px|trumb|Рис. 1. Диаграмма классов.]]
+[[Image:Java 6 1.jpg|left|280px|trumb|Рис. 1. Диаграмма классов.]]
 Выделим команды, которые нам необходимо реализовать (отметим удачное разделение на методы): Add, Auth, Edit, View, Remove. Учитывая то, что у наших команд будут некоторые идентичные методы и атрибуты, предлагаю создать абстрактный класс AbstractHTTPCommand, в котором они будут собраны. Класс будет реализовывать интерфейс Command, и его наследование автоматически позволит обеспечить необходимый уровень интеграции. Итак, в основе каждой команды будет лежать абстрактный класс AbstractHTTPCommand, в котором реализован интерфейс для выполнения операций (на Рис. 1 вы можете видеть диаграмму классов команд нашего приложения).

← Предыдущая		Версия 04:27, 22 марта 2008
Строка 184:		Строка 184:
	=== Создание экземпляра класса по имени ===		=== Создание экземпляра класса по имени ===

		+	Экземпляр класса можно создавать при наличии полного имени, записанного в строке, с помощью методов forName() и newInstance() класса Class (например, для класса Date: Object o = Class.forName(“java.util.Date”).newInstance()). Если при создании объекта на основе имени
		+	класса конструктору необходимо передать ряд параметров, то воспользоваться данным методом нельзя, но создать объект возможно с помощью класса java.lang.reflect.Constructor, например:

		+	Class c = Class.forName(key);
		+	Class[] parameterTypes = new Class[3];
		+	parameterTypes[0] = String.class;
		+	parameterTypes[1] = String.class;
		+	parameterTypes[2] = String.class;
		+	Constructor constructor = c.getConstructor(parameterTypes);
		+	Object[] args = new Object[3];
		+	args[0] = “par1”;
		+	args[1] = “par2”;
		+	args[2] = “par3”;
		+	Object o = constructor.newInstance(args);
		+
		+	Давайте разберем приведенный пример. Сначала мы создаем экземпляр класса Class по имени key, далее выделяем массив из типов параметров в том количестве и последовательности, как они идут в нужном нам конструкторе. Используя метод getConstructor(), в качестве параметра которому мы передаем наш массив, получаем экземпляр класса Conctructor. Если у Conctructor вызвать метод newInstance(args), то мы получим требуемый класс.
		+
		+	Осталось разобраться с последней проблемой, в решении которой нам поможет паттерн Factory Method.

	=== Фабрика команд ===		=== Фабрика команд ===

← Предыдущая		Версия 04:25, 22 марта 2008
Строка 192:		Строка 192:
	=== Что дальше? ===		=== Что дальше? ===

		+	Основной целью этой статьи было знакомство с паттернами Command и Factory Method, с чем мы неплохо справились, а заодно провели модернизацию web-приложения.
		+
		+	Создание экземпляров команд на основе файла конфигурации web-приложения, наверняка, не самая хорошая идея: более правильно выносить их настройку в отдельный файл (который кстати, можно будет менять из самого приложения, необходимо лишь реализовать соответствующие функции). Одно из улучшений, которое можно произвести – это изменить сами команды: сделать их stateless, то есть не хранящими внутри себя сведения о состоянии. Это улучшение позволило бы создать экземпляры команд один раз и использовать их и по мере необходимости.
		+
		+	Отметим, что применяя предложенные методы, можно создать приложение, модификация которого возможна без остановки его выполнения, так сказать, «на лету», но это уже тема тема отдельной статьи.

	----		----

← Предыдущая		Версия 04:24, 22 марта 2008
Строка 142:		Строка 142:
	=== Хранение настроек команд ===		=== Хранение настроек команд ===

		+	Для решения первой из поставленных задач мы не будем «изобретать велосипед» и воспользуемся средствами конфигурирования web-приложения. В файл web.xml введем параметры для нашего контроллера:

		+	<servlet>
		+	<display-name>AddressBook</display-name>
		+	<servlet-name>ABServlet</servlet-name>
		+	<servlet-class>AddressBookServlet</servlet-class>
		+	<init-param>
		+	<param-name>/</param-name>
		+	<param-value>root</param-value>
		+	</init-param>
		+	<init-param>
		+	<param-name>rootCommand</param-name>
		+	<param-value>ViewHTTPCommand</param-value>
		+	</init-param>
		+	<init-param>
		+	<param-name>rootView</param-name>
		+	<param-value>index.jsp</param-value>
		+	</init-param>
		+	<init-param>
		+	<param-name>rootResult</param-name>
		+	<param-value>null</param-value>
		+	</init-param>
		+	<init-param>
		+	<param-name>rootError</param-name>
		+	<param-value>null</param-value>
		+	</init-param>
		+	<load-on-startup>0</load-on-startup>
		+	</servlet>
		+
		+	Для каждого адреса вводится параметр, который мы будем называть ключом (для «/» это «root»). Ключ с добавлением суффикса (Command, View, Result, Error) обозначает конкретный параметр, значение которого мы будем извлекать прямо в приложении. Для получения необходимых данных можно воспользоваться следующим кодом (хотя мы в дальнейшем будем действовать по-другому):
		+
		+	ServletContext sc = this.getServletContext();
		+	String key = sc.getInitParameter(“/”);
		+	String commandName = sc.getInitParameter(key + “Command”);
		+	String commandView = sc.getInitParameter(key + “View”);
		+	String commandResult = sc.getInitParameter(key + “Result”);
		+	String commandError = sc.getInitParameter(key + “Error”);
		+
		+	Аналогичные настройки необходимо сделать для всех адресов, с которыми работает наше приложение («/», «/add», «/auth», «/edit», «/remove», «/view»). Включение в файл конфигурации этих значений позволит настраивать web-приложение без исправлений в коде.

	=== Создание экземпляра класса по имени ===		=== Создание экземпляра класса по имени ===

@@ Строка 22: / Строка 22: @@
+  }
-Выше представлен простой интерфейс Command всего с одним методом execute(), который и олицетворяет идею одноименного паттерна. [[Image:Java 6 1.jpg|left|300px|trumb|Рис. 1. Диаграмма классов.]] Он будет нашим стандартым интерфейсом. Более сложная реализация интерфейса включает метод unexecute(). Класс, реализующий интерфейс Command, инкапсулирует в методе execute() обозначенные выше атомарные операции, а в методе unexecute() реализуется механизм отмены. Часто методы execute() и unexecute() называют do() и undo(), соответственно.
+Выше представлен простой интерфейс Command всего с одним методом execute(), который и олицетворяет идею одноименного паттерна. Он будет нашим стандартым интерфейсом. Более сложная реализация интерфейса включает метод unexecute(). Класс, реализующий интерфейс Command, инкапсулирует в методе execute() обозначенные выше атомарные операции, а в методе unexecute() реализуется механизм отмены. Часто методы execute() и unexecute() называют do() и undo(), соответственно.
 Выделим команды, которые нам необходимо реализовать (отметим удачное разделение на методы): Add, Auth, Edit, View, Remove. Учитывая то, что у наших команд будут некоторые идентичные методы и атрибуты, предлагаю создать абстрактный класс AbstractHTTPCommand, в котором они будут собраны. Класс будет реализовывать интерфейс Command, и его наследование автоматически позволит обеспечить необходимый уровень интеграции. Итак, в основе каждой команды будет лежать абстрактный класс AbstractHTTPCommand, в котором реализован интерфейс для выполнения операций (на Рис. 1 вы можете видеть диаграмму классов команд нашего приложения).
@@ Строка 83: / Строка 85: @@
 Остальные команды реализуются аналогичным образом. Исключение из общего процесса рефакторинга кода составит команда ViewHTTPCommand, для которой уже реализована большая часть функционала:
 === Хранение настроек команд ===