Использование компонентов ColdFusion в Dreamweaver

Файлы компонентов ColdFusion (CFC) позволяют инкапсулировать логику приложений и бизнес-логику в автономные, многократно применяемые блоки. CFC также позволяют быстро и просто создавать веб-службы.

CFC представляет собой многократно используемый программный блок, написанный на языке разметки ColdFusion (CFML), упрощающий многократное использование и обслуживание кода.

Для работы с CFC можно использовать Dreamweaver. Более подробную информацию о тегах и синтаксисе CFC см. в документации по ColdFusion в Dreamweaver («Справка» > «Использование ColdFusion»).

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

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

Предположим, интернет-магазин вычисляет расходы по доставке на основе цены заказов. Для заказов менее 20 долларов США стоимость доставки составляет 4 доллара США, для заказов на сумму от 20 до 40 долларов США стоимость доставки составляет 6 долларов и т. д. Можно добавить логику вычисления стоимости доставки на страницу с корзиной и на страницу расчета стоимости покупок, но этот код смешивается в HTML-кодом представления и кодом логики CFML, что делает код трудным в обслуживании и непригодным для многократного использования.

Создайте CFC в именем Pricing, который среди прочего имеет функцию ShippingCharge. Функция использует в качестве аргумента цену и возвращает стоимость доставки. Например, если значение аргумента равно 32,80, функция возвращает 6.

На обеих страницах (корзины покупок и расчета стоимости покупок) добавьте специальный тег для вызова функции ShippingCharge. При запросе страницы вызывается функция, и на страницу возвращается стоимость доставки.

Затем в магазине объявлено о специальном предложении: бесплатная доставка для заказов на сумму свыше 100 долларов США. Необходимо изменить стоимость доставки в одном месте, в функции ShippingCharge компонента Pricing. Для всех страниц, вызывающих эту функцию, стоимость доставки будет определяться автоматически.

Обзор панели «Компоненты» (ColdFusion)

Панель «Компоненты» («Окно» > «Компоненты» ) используется для просмотра и редактирования компонентов ColdFusion и для добавления на страницу кода, вызывающего функции при запросе CFM-страницы.

Создание или удаление CFC в Dreamweaver

Dreamweaver можно использовать для визуального определения CFC и его функций. Dreamweaver создает файл .cfc и добавляет необходимые CFML-теги.

Просмотр CFC в Dreamweaver

Dreamweaver позволяет визуально проверить компоненты ColdFusion (CFC), расположенные в папке сайта на сервере. Dreamweaver считывает CFC-файлы и отображает информацию о них в удобном для навигации дереве на панели «Компоненты».

Dreamweaver ищет компоненты на тестовом сервере (см. раздел Подключение к базе данных в Dreamweaver). При создании или изменении CFC не забудьте загрузить CFC-файлы на тестовый сервер, чтобы они правильно отображались на панели «Компоненты».

Для просмотра компонентов, расположенных на другом сервере, измените настройки тестового сервера.

Для просмотра доступны следующие сведения о компонентах CF:

• список всех определенных на сервере компонентов ColdFusion;

• отфильтрованный список только тех CFC, которые расположены в папке сайта (при использовании ColdFusion MX 7 или более поздней версии);

• функции и аргументы каждого компонента;

• свойства функций, применяемых в качестве веб-служб.

Для просмотра CFC в Dreamweaver выполните нижеперечисленные действия.

Редактирование CFC в Dreamweaver

Dreamweaver предоставляет усовершенствованный способ редактирования кода заданных для сайта компонентов ColdFusion. Например, можно добавлять, изменять или удалять любую функцию компонента, не выходя из Dreamweaver.

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

• ColdFusion должен выполняться локально.

• В расширенном диалоговом окне «Определение веб-сайта» в Dreamweaver для типа доступа в категории «Тестовый сервер» необходимо выбрать значение «Локальный/сетевой».

• В расширенном диалоговом окне «Определение веб-сайта» путь к локальной корневой папке должен соответствовать пути к папке тестового сервера (например, c:\Inetpub\wwwroot\cf_projects\myNewApp\). Для проверки и изменения этих путей выберите меню «Сайт» > «Редактировать сайты».

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

Откройте любую страницу ColdFusion в Dreamweaver и просмотрите компоненты на панели «Компоненты». Для отображения компонентов откройте панель «Компоненты» («Окно» > «Компоненты»), выберите во всплывающем меню панели пункт «Компоненты CF» и нажмите кнопку «Обновить», также расположенную на панели.

Поскольку ColdFusion выполняется локально, Dreamweaver отображает пакеты компонентов, находящиеся на жестком диске компьютера.

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

Создание веб-страниц, использующих CFC

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

Определение набора записей в CFC

Dreamweaver упрощает определение набора записей (известного как запрос ColdFusion) в компоненте ColdFusion (CFC). Определение набора записей в CFC позволяет не определять набор записей для каждой страницы, использующей этот компонент. Определите набор записей в CFC один раз и применяйте этот компонент CFC к различным страницам.

Использование набора записей CFC в качестве источника динамического содержимого

Если компонент ColdFusion (CFC) содержит функцию, определяющую набор записей, его можно использовать в качестве источника динамического содержимого для страниц.

Определение динамического содержимого при помощи CFC

В Dreamweaver можно определить набор записей в качестве источника динамического содержимого при помощи CFC, содержащего определение набора записей.

1. Введите имя набора записей CFC в поле «Имя».

Обычно к именам наборов записей добавляется префикс rs для их отличия от других объектов в коде, например rsPressRelease.

Имена наборов записей должны содержать только буквы или цифры и символы подчеркивания (_). Специальные символы или пробелы использовать нельзя.

2. Выберите один из пакетов, уже определенных на сервере.

Если пакет не отображается во всплывающем меню, можно обновить список пакетов, нажав кнопку «Обновить», расположенную рядом со всплывающим меню.

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

3. Выберите один из компонентов, определенных в текущем пакете.

Если во всплывающем меню «Компоненты» нет компонентов или если в нем не отображаются ранее созданные компоненты, необходимо загрузить CFC-файлы на тестовый сервер.

4.Для создания компонента нажмите кнопку «Создать компонент» (необязательно).

А. В поле «Имя» введите имя нового компонента CFC. Имя должно содержать только буквы или цифры и символы подчеркивания (_).

Б. В поле «Каталог компонента» укажите путь к папке для CFC или выберите ее из списка локальных папок.

5. Во всплывающем меню «Функция» выберите функцию с определением набора записей.

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

6. Нажмите кнопку «Редактировать» и отредактируйте каждый параметр (тип, значение и значение по умолчанию), который требуется передать в качестве аргумента функции.

А. Задайте значение для текущего параметра, выбрав тип значения во всплывающем меню «Значение» и введя само значение в поле справа. Тип значения может быть параметром URL-адреса, cookie, переменной сеанса, переменной приложения или введенным значением.

Б. Введите значение по умолчанию для параметра в поле «Значение по умолчанию». Значение по умолчанию используется в случае, если динамическое значение не возвращается.

В. Нажмите кнопку «ОК».

Для набора записей невозможно изменить подключение к базе данных и SQL-запрос. Эти поля недоступны. Подключение и SQL-запрос отображаются только в информационных целях.

7. Нажмите кнопку «Тест» для подключения к базе данных и создания экземпляра набора записей.

Если SQL-оператор содержит параметры страницы, убедитесь, что в столбце «Значение по умолчанию» или «Параметры» содержатся допустимые значения.

Если запрос выполняется успешно, в таблице отображается набор записей. Каждая строка содержит запись, а каждый столбец представляет одно из полей этой записи.

Нажмите «ОК» для очистки запроса CFC.

8. Нажмите кнопку «ОК».