Крейн Д., Паскарелло Э., Джеймс Д,. AJAX в действии / Ajax в действии / ajinact / Ajax в действии
.pdf
Рис. 11.12. Портал Ajax с тремя открытыми на экране окнами
Кроме того, нам потребуется таблица стилей окон DHTML, чтобы мы могли определить стилевое оформление окна. Для этого загрузите файл AjaxWindow.css с Web-сайта www.manning.com (или www.dialektika.com) и присоедините его к нашему сценарию, используя дескриптор link и атрибут href.
<link rel="stylesheet" type="text/css" href="AjaxWindows. css"x/link>
Итак, мы присоединили к HTML-странице файлы JavaScript и CSS, поэтому теперь можно проверить, правильно ли мы это сделали. Кроме того, проверим, правильно ли код серверной части сценария вызывает библиотеку JavaScript. Если код присоединен правильно и мы надлежащим образом получаем данные с сервера, то после входа в систему с использованием имени пользователя и пароля из базы данных мы, согласно хранимой в базе информации, должны получить три окна, показанных на рис 11.12. Помните, что созданная нами библиотечная функция формирует окна и связывает с ними все требуемые функциональные возможности. Выглядит, как волшебство, поскольку мы вызываем одну функцию, и все работает.
Открыв окна портала, можно проверить функциональные возможности, встроенные в библиотеку DHTML (функциональные возможности Ajax мы пока не рассматриваем). Вообще, в портале можно реализовать следующие дополнительные возможности.
•Щелчок на кнопке с пометкой О максимизирует и минимизирует окно.
•Щелчком на кнопке со знаком х окно можно скрыть.
•Щелчком на кнопке с буквой w можно открыть окно DHTML в собственном раскрывающемся окне.
Рис. 11.13. Другое расположение окон портала Ajax
•Нажав левую кнопку мыши в то время, когда курсор наведен на заголовок окна, окно можно захватить и с помощью мыши переместить на другое место.
•Отпустив левую кнопку мыши, мы завершаем операцию перетаскивания.
Для изменения размера окна необходимо щелкнуть на зеленом квадратике в правом нижнем углу окна и перетащить его в требуемое положение.
В качестве иллюстрации к сказанному обратите внимание на то, что окна на рис. 11.13 располагаются не так, как на рис. 11.12.
Теперь мы можем с помощью библиотеки размещать окна и изменять их размеры; далее требуется внести изменения во внешний файл . j s. Данные изменения позволят вызывать функцию, с помощью Ajax отправляющую в базу данных новые значения свойств.
11.5. Возможность автоматического сохранения
Использование Ajax позволяет реализовать функцию автоматического сохранения, которая может вызываться любым событием (причем пользователь об этом знать не будет). Обычно пользователь инициирует отправку информации на сервер, щелкая на некоторой кнопке. В данном случае функция автоматического сохранения будет запускаться событием onmouseup, которое завершает процессы перетаскивания и изменения размеров. Если бы мы по событию onmouseup инициировали обычную отправку формы, мы бы нарушили взаимодействие пользователя с порталом и потеряли все, чего с таким трудом добивались. Используя Ajax, мы делаем процесс непрерывным.
Глава 11 Улучшенный Web-портал Ajax 463
11.5.1. Адаптация библиотеки
Как отмечалось ранее, код библиотек DHTML JavaScript обычно приемлем во всех основных браузерах, что позволяет нам использовать его, не задумываясь о вопросах совместимости. Изучая код внешнего JavaScript-файла AjaxWindow.js, вы обнаружите много интересных функциональных возможностей (поскольку соответствующий код довольно длинный, мы его рассматривать не будем). Существуют функции, отслеживающие движения мыши, имеется функция, отвечающая за создание окон. Вы можете использовать функции, устанавливающие положение окна, а также функцию, задающую его размер. Имея в своем распоряжении все эти функции, нам недостает лишь одного — возможности записи состояния окна в базу данных. Для реализации соответствующей функции нам потребуется Ajax.
Адаптация библиотеки DHTML под использование Ajax
Функции библиотеки DHTML, реализующие перетаскивание и изменение размеров окон, используют множество обработчиков событий и методов DOM для преодоления несогласованности браузеров. Перетаскивание и изменение размеров окон завершается при отпускании кнопки мыши. Следовательно, нам нужна функция, вызываемая обработчиком события onmouseup в файле AjaxWindow.js. Эта функция содержит приведенный ниже код, который выполняется после отпускания кнопки мыши.
document.onmouseup = function(){ bDrag = false;
bResize = false; intLastX = - 1 ;
document.body.style.cursor = "default"; elemWin="";
bHasMoved = false;
}
В данном коде множество булевых переменных получает значение false, что обозначает отмену соответствующих действий. Курсор возвращается к значению по умолчанию. Нам необходимо изменить строку, в которой отменяется ссылка elemWin. Сейчас нам требуется взять эту ссылку и передать ее другой функции, чтобы инициализировать объект XMLHttpRequest и передать информацию на сервер.
Хотя иногда адаптация библиотек под нужды текущего проекта требует длительного процесса проб и ошибок, в данном случае требуемые функциональные возможности достаточно очевидны. Просто добавьте в код обработчика события onmouseup строку, выделенную полужирным шрифтом.
document.onmouseup = function(){ bDrag = false;
bResize - false; intLastX * -1;
document.body.style.cursor - "default";
if(elemWm && bHasMoved)SaveWindowProperties(elemWin); bHasMoved = false;
}
Глава 11. Улучшенный Web-портал Ajax 465
Получив информацию, мы можем вызывать функцию Settings () (ее код приводится ниже) для отправки запроса на сервер О. Вызвав эту функцию, мы должны удалить из глобальной переменной elemWin объект, сопоставленный с элементом ©. Для этого переменной elemWin присваивается значение, равное пустой строке. Завершив работу над функцией SaveWindowProperties (), можно инициировать тихий запрос Ajax на сервер с помощью функции JavaScript Settings ().
11.5.2. Автоматическая запись информации в базе данных
Ajax позволяет так отправлять информацию на сервер, чтобы пользователь об этом и не подозревал. Такой подход реализован в двух проектах, рассмотренных в данной книге. Мы можем легко отправлять запросы на сервер, отслеживая нажатие клавиш, как в сценарии опережающего ввода (см. главу 10), и движение указателя мыши (как в данной главе). Подобная невидимая передача информации очень удобна для разработчиков, поскольку мы можем обновлять пользовательские настройки, не требуя от него никаких дополнительных действий. В большинстве случаев, чем меньше приходится делать пользователям, тем больше они довольны. В данном приложении все, что нам требуется для инициации запроса XMLHttpRequest, — чтобы пользователь отпустил кнопку мыши. Таким образом, сейчас самое время рассмотреть процесс отправки запроса на сервер.
Клиент: отправка незаметного запроса
В данном случае процесс XMLHttpRequest не требует ничего сложного. Пользователь, взаимодействующий с формой, сам незаметно передает нашей функции все свойства формы. Итак, вначале нам необходимо инициализировать объект XMLHttpRequest.
function Settings(xAction,xPararas){ var url e xAction + ".servlet"; var strParams = xParams;
var loader! - new net.ContentLoader(url,
BuildSettings,
ErrorBuildSettings,
"POST",
strParams);
}
Рассмотрим функцию Settings () подробнее. В качестве параметра ей передается активизированная строка, содержащая все свойства окна. В нее мы добавляем все параметры, отправляемые на сервер. Если обращение к серверу пройдет успешно, загрузчик вызовет функцию BuildSettings (). Если произойдет какой-то сбой, вызывается функция ErrorBuildSettings ().
function BuildSettings(){
strText = this.req.responseText; document.getElementById("divSettings").innerHTML = strText;
}
function ErrorBuildSettings(){
alert(tquoteThere was an error trying to connect
466 Часть IV Aiax в примерах
to the server.tquote); document.getElementByld("divSettings").style.display = "none";
}
Приведенная выше функция BuildSettings () является очень условной — мы просто завершаем объект XMLHttpRequest, полученный с сервера. Еще мы можем поместить сообщение в строку состояния портала, указывающее, что • информация на сервере была обновлена. Если в процессе обновления информации возникли проблемы, в строку состояния можно добавить сообщение об ошибке. Кроме того, генерируется предупреждение, сообщающее пользователю об ошибке, однако это нарушает процесс взаимодействия с порталом. Готовый механизм уведомления был рассмотрен в главе 6. его интеграцию в систему портала предлагаем вам выполнить в качестве самостоятельного упражнения. Посмотрим теперь, что происходит на сервере.
Сервер: сбор информации с клиента
Все, что нам осталось сделать, — извлечь значения, отправленные в форме. Эти значения были посланы объектом XMLHttpRequest, активизированным обработчиками событий onmouseup. Теперь нам необходимо создать запрос SQL, содержащий эту информацию, и обновить запись в базе данных, записав в нее новые данные. Для этого мы определим класс UpdateServlet, : показанный в листинге 11.11.
НЦПистинг 11.11. Класс Upda^erviet. З^ШШШШШШШШЩШЯЩ public class UpdateServlet extends HttpServlet {
protected void doPost{ HttpServletRequest request, HttpServletResponse response
)throws ServletException, IOExceptionf
String windowld*
// О Извлечь из запроса уникальный идентификатор
request . getParameter("ref"); HttpSession session=request.getSession(); PortalWindow window=(PortalWindow)
// © Извлечь из сеанса объект Window (session . getAttribute
{"window_"+windowld));
window.setXPos(getlntParamfrequest,"x")); window.setYPos(getlntParamfrequest,"y")); window,setWidth(getIntParam(request,"w")) ; window.setHeight(getIntParam(request,"h"));
// в Записать изменения
DBUtil.savePortalWindow(window); Writer writer=response.getWriter();
// Вернуть простой текстовый отклик writer . write("Save Complete"); w r i t e r . f l u s h ( ) ;
J
private i n t get!ntParam(HttpServletRequest request,
468 Часть IV. Ajax в примерах
Итак, мы сформировали все базовые функциональные возможности для рабочей системы портала, в том числе несколько элементов, которые классические Web-приложения просто не могли бы дать. Имеется еще несколько элементов, которые можно отнести к категории полезных, например, возможности добавления, удаления и переименования окон. Из-за ограниченного размера книги мы не будем их рассматривать. Впрочем, вы можете загрузить полный код приложения-портала, в котором можно добавлять, удалять, переименовывать и настраивать свойства окон, не покидая единственной страницы портала. Если у вас возникнут какие-либо вопросы, касающиеся приведенного кода, или вам потребуется более подробное его объяснение, вы всегда можете связаться с авторами через www.manning.com.
Разработанный код можно назвать грубым, однако он эффективен, так что мы можем демонстрировать работу его отдельных компонентов. Пожалуй, пришло время передать его группе, ответственной за реструктуризацию, и посмотреть, как связать все элементы воедино и облегчить повторное использование системы.
11.6. Реструктуризация
Как вы видели, концепция основанного на Ajax клиента портала, взаимо ] действующего с серверной частью портала, является довольно убедительной. ', В разделе, посвященном реструктуризации клиентской части кода мы рас- ] смотрим наш компонент как объект, выступающий в роли арбитра команд портала, отправляемых менеджеру портала на сервере. В процессе реструк- ] туризации мы постараемся выделить те части кода, которые могут со временем меняться, и максимально облегчить эти изменения. Поскольку портал ] представляет собой крулномодульный компонент, а мы в какой-то степени можем распоряжаться содержимым страницы, нас не ограничивает требо- ] вание не вмешиваться в HTML-разметку страницы (как в двух предыду- • щих проектах).
Однако, прежде чем рассматривать семантику клиентской части сценария, остановимся на контракте с сервером. Наша предыдущая реализация серверного кода была написана на Java, поэтому возможности аутентификации обеспечивал сервлетный фильтр(один сервлет возвращал конфигураЦИИ окна, второй — записывал конфигурации окна). Подобным образом, для добавления новых окон и удаления текущих мы создадим дополнительные автономные сервлеты. В Web-приложениях Java сервлеты можно достаточно гибко отобразить в URL; данная возможность определена в файле web.xml, содержащемся в загружаемом Web-архиве (.war). Например, функция Se- I lectServlet, возвращающая сценарий, определяющий исходные окна, была отображена в URL portalLogin.servlet.
Одним из достоинств инфраструктуры Ajax является слабая связь между клиентом и сервером. В нашем примере портала в качестве внутреннего интерфейса используется Java, но нам совсем не обязательно привязываться к таким особенностям Java, как сервлетные фильтры и гибкая перезапись URL. Альтернативная внутренняя архитектура может ис-
Глава 11. Улучшенный Web-портал Ajax |
469 |
пользовать диспетчер запросов, при которой единственный сервлет (страница РНР или ресурс ASP.NET) принимает все входящие запросы, а затем считывает параметр, задающий тип выполняемого действия (специфика передачи параметра определяется методом: GET или POST). Например, строка параметров для входа на портал может выглядеть как асtion=login&userid=userspassword=password. Используя Java, мы можем реализовать подход с помощью диспетчера запросов, присваивая определенный префикс URL, например .portal, сервлету диспетчера, что позволит записывать такие URL, как login.portal.
В реструктуризированном компоненте мы обобщим предположения относительно внутренней архитектуры, разрешив либо архитектуру диспетчера запросов, либо вариант с множественными адресами, использованный в реализации Java. Тем не менее от нас не требуется полная гибкость, поэтому мы предопределим набор команд, предположительно понятных для внутренней архитектуры портала и охватывающих регистрацию, отображение для пользователя окон портала, а также добавление и удаление окон из портала. Учитывая указанные изменения серверной части приложения, вернемся к реализации клиентской части.
Обсуждение реструктуризации портала начнем с переопределения контракта использования с точки зрения HTML-кода страницы, а затем приступим к реализации. Напомним, что введение HTML-страницы в сценарий портала происходит посредством регистрации, а точнее — с помощью кнопки входа в систему.
<input type="button" name="btnSub" value="login" onclick="LoginRequest(tquotelogintquote)">
Мы изменили обработчик события onclick, теперь это вызов функции, которая будет использовать наш компонент-портал. Предположим, что этот компонент обрабатывается с помощью сценария, выполняемого после загрузки. Характерный пример того, как это должно выглядеть, приведен в листинге 11.13.
Листинг 11.13. Создание портала и вход в систему
function createPortal() { myPortal = new Portal(
/ / О Основной URL портала tquoteportalManagertquote,
{
// © Необязательные параметры
messageSpanld: tquotespanprocessingtquote, urlSuffix: tquote.portaltquote }) ;
//© Вызвать для загрузки окон myPortal.loadPage(Portal-LOAD_SETTINGS_ACTION);
document.getElementById(tquoteusernametquote).focus{) ;
}
function login() { myPortal.login(document.getElementByld(tquoteusernametquote).value,
document.getElementById(tquotepasswordtquote).value);
470Часть IV. Ajax в примерах
Втакой семантике использования функция createportal (), которая должна вызываться сразу после загрузки страницы, создает экземпляр компонента портала. Первый ее аргумент — это основной URL серверного приложения портала О, второй предоставляет необязательные параметры, используемые для ее настройки под конкретный контекст 0. В данном случае мы сообщаем функции идентификатор элемента DOM, в который следует записывать сообщения о состоянии, и имя параметра запроса, который определит совершаемое действие. После создания на портале вызывается API loadPage, загружающий окна портала, если в сеансе сервера присутствует регистрационное имя пользователя ©. Если в систему никто не входил, сервер возвращает пустой сценарий, оставляя на экране только форму регистрации.
Функция login () представляет собой вспомогательную функцию, вызывающую метод login {) компонента портала, передающую в качестве аргументов имя пользователя и пароль. Согласно данному контракту обработчик событий onclick кнопки регистрации вызывает метод login () страницы.
<input type="button" name="btnSub" value="login" onclick="login()">
11.6.1. Определение конструктора
Разобравшись с использованием компонента с точки зрения страницы, займемся реализацией логики. Начнем с конструктора.
function Portal( baseUrl, options ) { this.basellrl = baseUrl;
this.options - options; this.initDocumentMouseHandler();
В качестве первого аргумента приведенный конструктор принимает URL средства управления порталом Ajax на сервере, а в качестве второго — объект опций, используемый при определении конфигураций. Напомним, что в первом варианте данного сценария использовался сервлетный фильтр и два сервлета, выполняющих внутреннюю обработку. Далее мы будем предполагать, что все запросы к внутренней части портала будет перехватывать один сервлет, или ресурс portalManager (см. листинг 11.13). Если нам требуется сконфигурировать портал с учетом внутренней архитектуры, не использующей единственный диспетчер запросов, мы можем передать конструктору различные аргументы, например:
myPortal = new Portal( tguotedatatquote,
{ messageSpanld: tquotespanProcessingtquote, urlSuffix: tquote.phptquote }
);
Таким образом, мы передадим основной URL "данных" и, поскольку в массиве опций определен параметр actionParam, добавим к пути URL команду с суффиксом .php, получая в результате URL, подобный data/login, php. Следовательно, мы получаем всю необходимую на данный момент гибкость. Вопрос превращения опций в URL будет рассмотрен в разделе 11.6.3. Сейчас же мы перейдем к следующему заданию. Итак, из по-