Создание Model-View-Controller компонента часть 1


Введение

Данное руководство посвящено разработке компонента в Joomla 1.5 с использованием технологии framework и схемы MVC. Вы пройдете через весь процесс его создания. В итоге будет разработан простой компонент Hello World! Он будет усложняться в следующих частях руководства, чтобы показать все мощь и гибкость схемы MVC.

Требования:
Joomla 1.5 или выше.

Введение в схему Model-View-Controller

Не смотря на то, что идея компонента может показаться слишком простой, код будет усложняться путем добавления новых свойств и разработкой пользовательского интерфейса. Схема MVC может быть использована для такой организации кода, при которой происходит отделение бизнес-логики от представления данных. Вся бизнес-логика размещена в одном месте, что позволяет легко изменять интерфейс или способ взаимодействия с пользователем без изменения самой бизнес-логики. MVC изначально был разработан для того чтобы производить ввод, обработку информации и получение результата в соответствии с логикой архитектуры GUI. Это являются основой схемы MVC в Joomla.

Модель

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

Представление

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

Контроллер

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

Связь MVC

Рисунок справа иллюстрирует использование основных компонентов в Joomla. Кроме модели, представления и контролера на рисунке изображены точка входа в виде маленького кружечка и шаблон. Эти пять компонентов дадут вам возможность понять, как создаются MVC компоненты в Joomla.

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


Реализация MVC

В Joomla модель MVC реализована с помощью трех классов: JModel, JView, Jcontroller.

Создание компонента

В начале для нашего компонента понадобиться все лишь пять файлов:

1. site/isbliss.ru – это точка входа компонента;
2. site/isbliss.ru – содержит контролер;
3. site/views/hello/isbliss.ru – этот файл получает необходимые данные и помещает их в шаблон;
4. site/views/hello/tmpl/isbliss.ru – шаблон;
5. isbliss.ru – это xml файл, который показывает Joomla как устанавливать наш компонент.

Запомните, что имя файла точки входа должно быть такое же как и у компонента. Например, вы назвали компонент "Very Intricate Name Component", во время установки (смотри ниже в файле isbliss.ru) Joomla создаст папку с именем «com_veryintricatenamecomponent» и файл точки входа должен быть назван isbliss.ru, а иначе компонент работать не будет. Обратите внимание, что надо избегать использования в названии компонентов и файлов специальных символов.

Создание точки входа

Доступ к компонентам в Joomla всегда происходит только через одну точку входа: isbliss.ru для сайта или administrator/isbliss.ru для административной части. Затем приложение загрузит нужный компонент, значение которого определено в параметре ‛option‛ в URL или передано методом POST. Для нашего компонента URL будет:

isbliss.ru?option=com_hello&view=hello

Эта ссылка загрузит наш основной файл, который является точкой входа для нашего компонента: components/com_hello/isbliss.ru Код этого файла стандартный для многих компонентов.

site/isbliss.ru:

<?php
/**
* @package isbliss.ru
* @subpackage Components
* components/com_hello/isbliss.ru
* @link isbliss.ru_a_Model-View-Controller_Component_-_Part_1
* @license GNU/GPL
*/


// No direct access
defined( "_JEXEC" ) or die( "Restricted access" );

// Require the base controller

require_once( JPATH_isbliss.ru"isbliss.ru" );

// Require specific controller if requested
if($controller = JRequest::getWord("controller"))
$path = JPATH_isbliss.ru"controllers".DS.$controller.".php";
if (file_exists($path))
require_once $path;
else
$controller = "";



// Create the controller
$classname = "HelloController".$controller;
$controller = new $classname( );

// Perform the Request task
$controller->execute( JRequest::getVar( "task" ) );

// Redirect if set by the controller
$controller->redirect();


Первая инструкция – это проверка безопасности.

JPATH_COMPONENT – это абсолютный путь к компоненту, в нашем случае components/com_hello. Можно также использовать JPATH_COMPONENT_isbliss.ru – путь к компоненту сайта, JPATH_COMPONENT_ADMINISTRATOR – путь к административной части.
DS является автоматическим выбором слеша:»» или «/». После загрузки основного контролера мы определяем, есть ли необходимость загружать какой-то дополнительный контролер. У нас будет только один контролер.
JRequest:getVar() находит в URL или в POST данных переменную, переданную ему в качестве параметра. Поскольку наш URL - isbliss.ru?option=com_hello&controller=controller_name, то наш контролер мы можем найти, используя echo JRequest::getVar("controller"). Теперь у нас есть наш основной контролер "HelloController" в файле com_hello/isbliss.ru и если необходимо дополнительный "HelloControllerController1" в com_hello/controllers/isbliss.ru Стандартная схема наименования контролера: Название компонентаControllerНазвание контролера

После того как контроллер создан, мы даем ему команду выполнить задачу, которая определена в URL: isbliss.ru?option=com_hello&task=sometask. Если задача не установлена, то по умолчанию будет ‛display‛. Когда используется задача ‛display‛ переменная ‛view‛ укажет, что должно быть отображено. Другими задачами являются save, edit, new и тд. Обычно, когда выполняется задача ‛save‛ контролер решает, что надо перенаправить страницу. Последняя инструкция осуществляет перенаправление.
Главная точка входа(isbliss.ru) по существу передает контроль контролеру, который обрабатывает задачи, определенные в запросе.
Заметьте, что мы не используем закрывающий тег ?>. Мы делаем это для того чтобы у нас не было никакого нежелательного пустого пространства в коде. Такая практика по умолчанию используется, начиная с Joomla 1.5 для файлов, содержащих только php код.

Создание контроллера

Наш компонент выполняет только одну задачу – приветствует мир. Поэтому контроллер будет очень простой. Нам не требуется никакая манипуляция данными. Все что надо уже есть в загруженном представлении. Большая часть необходимых функциональных возможностей встроена в класс JController, таким образом, все что мы должны сделать это вызвать метод JController::display().
Код нашего контролера(site/isbliss.ru)

<?php
/**
* @package isbliss.ru
* @subpackage Components
* @link isbliss.ru_a_Model-View-Controller_Component_-_Part_1
* @license GNU/GPL
*/


// No direct access

defined( "_JEXEC" ) or die( "Restricted access" );

jimport("isbliss.ru");

/**
* Hello World Component Controller
*
* @package isbliss.ru
* @subpackage Components
*/

class HelloController extends JController

/**
* Method to display the view
*
* @access public
*/

function display()

parent::display();


Конструктор Jcontroller всегда будет регистрировать задачу display() пока не будет определено что-нибудь другое. Эта задача будет устанавливаться по умолчанию. Когда вы создаете пункт меню для вашего компонента, менеджер меню позволит администратору выбрать представление, которое бы отображало либо конкретный данные, либо их схему. Обычно представление ссылается на определенный набор данных, например список машин, список событий, конкретная машина, конкретное событие. Схема это способ, с помощью которого организовано представление.
В нашем компоненте будет одно представление и одна схема (по умолчанию).

Создание представления

Задача представления очень простая: оно получает данные и помещает их в шаблон. Данные помещенные в шаблон используются методом JView::assignRef.

Наше представление находиться в файле: site/views/hello/isbliss.ru Вот его код:

<?php
/**
* @package isbliss.ru
* @subpackage Components
* @link isbliss.ru_a_Model-View-Controller_Component_-_Part_1
* @license GNU/GPL
*/


// no direct access

defined( "_JEXEC" ) or die( "Restricted access" );

jimport( "isbliss.ru");

/**
* HTML View class for the HelloWorld Component
*
* @package HelloWorld
*/


class HelloViewHello extends JView

function display($tpl = null)

$greeting = "Hello World!";
$this->assignRef( "greeting", $greeting );

parent::display($tpl);

Создание шаблона

Шаблоны Joomla это PHP файлы, которые используются, чтобы разместить данные полученные от представления в определенной манере. Переменные, определенные методом JView::assignRef могут быть доступны в шаблоне при использовании конструкции $this->имя свойства (смотри код шаблона в примере).

Наш шаблон очень прост: он всего лишь отображает приветствие, которое он получил от представления. Файл шаблона: site/views/hello/tmpl/isbliss.ru

<?php

// No direct access

defined("_JEXEC") or die("Restricted access"); ?>
<h1><?php echo $this->greeting; ?></h1>

Создание файла isbliss.ru

Есть возможность установить компонент в ручную, копируя файлы через FTP и создавая таблицы базы данных. Однако же легче создать пакетный файл, который позволит Joomla сделать все за нас. Этот пакетный файл содержит различную информацию:
1. описание деталей компонента (например, наименование), необязательно – описание, информация о правах и лицензии;
2. список файлов, которые необходимо скопировать;
3. необязательно, PHP файл, который выполняет дополнительные операции по инсталляции и деинсталляции компонента;
4. необязательно, SQL файл, содержащий запросы, которые должны быть выполнены при инсталляции/деинсталляции.

Формат файла isbliss.ru:

<?xml version="1.0" encoding="utf-8"?>
<install type="component" version="1.5.0">
<name>Hello</name>
<!-- The following elements are optional and free of formatting constraints -->
<creationDate></creationDate>
<author>John Doe</author>
<authorEmail>isbliss.ru@isbliss.ru</authorEmail>
<authorUrl>isbliss.ru</authorUrl>
<copyright>Copyright Info</copyright>
<license>License Info</license>
<!-- The version string is recorded in the components table -->
<version>1.01</version>
<!-- The description is optional and defaults to the name -->
<description>Description of the component ...</description>

<!-- Site Main File Copy Section -->
<!-- Note the folder attribute: This attribute describes the folder
to copy FROM in the package to install therefore files copied
in this section are copied from /site/ in the package -->

<files folder="site">
<filename>isbliss.ru</filename>
<filename>isbliss.ru</filename>
<filename>isbliss.ru</filename>
<filename>views/isbliss.ru</filename>
<filename>views/hello/isbliss.ru</filename>
<filename>views/hello/isbliss.ru</filename>
<filename>views/hello/tmpl/isbliss.ru</filename>
<filename>views/hello/tmpl/isbliss.ru</filename>
</files>

<administration>
<!-- Administration Menu Section -->
<menu>Hello World!</menu>

<!-- Administration Main File Copy Section -->
<files folder="admin">
<filename>isbliss.ru</filename>
<filename>isbliss.ru</filename>
</files>

</administration>
</install>

Если вы изучили xml код внимательно, то должны были заметить, что в нем содержаться описания файлов, которые мы еще не обсуждали. Это файл isbliss.ru Его надо поместить в каждую папку, чтобы любопытные пользователи не могли получить список файлов в директории. Если этого не сделать, то некоторые веб-сервера выдадут такой список. Не хотелось бы что бы это произошло. Этот файл содержит всего одну строку:

<html><body bgcolor="#FFFFFF"></body></html>

Он просто показывает пустую страницу.
Другой файл это isbliss.ru в секции ‛admin‛. Это точка входа для административной части нашего компонента. Поскольку наш компонент не имеет такой части этот файл будет точно такой же как и isbliss.ru


Статья здесь Часть 2
13:01 20.10.2017



Отзывы и комментарии
Ваше имя (псевдоним):
Проверка на спам:

Введите символы с картинки:



Популярное

Бурение артезианских источников доверяют только пр

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

Из чего состояло солдатское меню перед революцией?

Интересно, как кормили русских солдат «при царе»? Конечно, питание каждой конкретной час...

Как выделиться из толпы? Придумать свою моду!

В последние годы популярность фэшн-блогов достигла своего пика, что вызвало волну ажиотажа даже у те...

Как группа LOVE записала один из величайших альбом

Прошлый раз я оставил группу LOVE в преддверии записи одного из самых великих и одновременно самых п...

Разновидности тепловых пушек: плюсы и ключевые осо

Тепловые пушки – чрезвычайно надежные в эксплуатации устройства для прогрева как промышленных,...

Вкусные рецепты: Закуска из креветок и рыбы, Пирог

Закуска из креветок и рыбыРыбное филе (у меня сериола) нарезать кусочками (1,5-2 см.), посолить, пос...

Правильно выбираем комнатное растение

Вы решили, что вашему дому не хватает чего-то особенного, вы хотите добавить интерьеру вашей квартир...

Где произошло первое сражение Второй мировой войны

Совсем скоро исполнится 100 лет с начала Первой мировой войны. Война эта подвела черту под так назыв...

На остатках Атлантиды. О чем мечтают живущие там ф

Они говорят на языке древних викингов и верят, что живут на остатках затонувшей Атлантиды. Они до си...

Патрон .50 BMG (12.7x99 mm) обр. 1920 г. Как пулем

Так уж получилось. Можно сказать, случайно. Ведь никаких предпосылок к этому не было. У патрона этог...



О информационном портале:

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

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