Руководство пользователя Отмена

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

 

 

Примечание.

В Dreamweaver CC и более поздних версиях поддержка ColdFusion отсутствует.

О компонентах ColdFusion

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

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

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

Примечание.

CFC можно использовать вместе с ColdFusion MX или новее. В ColdFusion 5 файлы CFC не поддерживаются.

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

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

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

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

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

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

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

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

Примечание.

Панель «Компоненты» доступна только при просмотре страницы ColdFusion в Dreamweaver.

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

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

Примечание.

В зависимости от компонента может понадобиться ввести часть кода вручную.

  1. Откройте страницу ColdFusion в Dreamweaver.

  2. На панели «Компоненты» («Окно» > «Компоненты») во всплывающем меню выберите «Компоненты CF».

  3. Нажмите кнопку (+), задайте параметры в диалоговом окне «Создать компонент» и нажмите кнопку «ОК».

    А. В разделе «Компоненты» введите сведения о компоненте. Ниже приведен неполный список:

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

    Каталог компонента определяет, где компонент будет сохранен. Выберите корневую папку приложения (например, \Inetpub\wwwroot\myapp\) или любую вложенную папку.

    Б. Чтобы задать одну или несколько функций для компонента, в списке «Раздел» выберите элемент «Функции», нажмите кнопку (+) и введите сведения о новой функции.

    Убедитесь, что в параметре «Возвращаемый тип» указан тип значения, возвращаемый функцией.

    Примечание.

    Если в меню «Доступ» выбран удаленный доступ, функция становится доступной в виде веб-службы.

    В. Чтобы задать один или несколько аргументов функции, в списке «Раздел» выберите элемент «Аргументы», во всплывающем меню выберите функцию, нажмите кнопку (+) и введите сведения о новом аргументе.

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

    Загрузка файлов обеспечивает правильную работу таких функций Dreamweaver, как «Интерактивный просмотр» и «Просмотреть в браузере».

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

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

Просмотр CFC в Dreamweaver

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

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

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

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

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

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

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

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

Примечание.

Чтобы в Dreamweaver просмотреть CFC, расположенные в корневой папке сервера, и обеспечить управление файлами сайта в корневой папке другого веб-сайта, можно определить два сайта Dreamweaver. Для первого сайта задайте корневую папку сервера, для второго — корневую папку веб-сайта. Для быстрого переключения между двумя сайтами служит всплывающее меню на панели «Файлы».

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

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

    Пакет компонентов отображается на сервере. Пакет компонентов представляет собой папку, содержащую CFC-файлы.

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

  4. Для отображения только CFC, расположенных в папке сайта, нажмите на панели инструментов «Компоненты» кнопку «Показывать CFC только текущего веб-сайта».
    Примечание.

    Данная функция доступна только в том случае, если в качестве тестового сервера для Dreamweaver определен компьютер, на котором установлен ColdFusion MX 6 или более поздней версии.

    Примечание.

    Если текущий сайт указан в списке виртуальной папки удаленного сервера, фильтр не работает.

  5. Нажмите кнопку (+) рядом с именем пакета для просмотра компонентов пакета.
    • Для просмотра списка функций компонента нажмите кнопку (+) рядом с именем компонента.

    • Для просмотра аргументов функции, а также типа аргументов и их характера (обязательного или необязательного), разверните в дереве ветвь функции.

      Рядом с функциями без аргументов нет кнопки (+).

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

      Можно также щелкнуть элемент правой кнопкой мыши (Windows) или щелкнуть его, удерживая нажатой клавишу Control (Macintosh), и выбрать во всплывающем меню «Получить подробные сведения».

      Сведения об элементе отображаются в поле сообщений.

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

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

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

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

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

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

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

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

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

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

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

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

    Примечание.

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

  3. Для общего редактирования файла компонента откройте пакет и дважды щелкните имя компонента в дереве.

    Файл компонента открывается в представлении «Код».

  4. Для редактирования определенной функции, аргумента или свойства дважды щелкните соответствующий элемент в дереве.
  5. Выполните изменения вручную в представлении кода.
  6. Сохраните файл («Файл» > «Сохранить»).
  7. Для просмотра новой функции на панели «Компоненты» обновите вид панели, нажав кнопку панели «Обновить».

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

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

Примечание.

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

  1. Откройте в Dreamweaver страницу ColdFusion, которая должна использовать функцию компонента.
  2. Переключитесь на представление кода («Вид» > «Код»).
  3. Откройте панель «Компоненты» («Окно» > «Компоненты») и выберите во всплывающем меню панели «Компоненты CF».
  4. Найдите нужный компонент и вставьте его на страницу при помощи одного из следующих способов.
    • Перетащите на страницу функцию из дерева. На страницу вставляется код для вызова функции.

    • Выберите функцию на панели и нажмите кнопку «Вставить» на панели инструментов (вторая кнопка справа). Dreamweaver вставляет в страницу код в то место, где находится курсор вставки.

  5. При вставке функции с аргументами добавьте код аргументов вручную.

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

  6. Сохраните страницу («Файл» > «Сохранить»).

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

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

Примечание.

Данная функция доступна только при наличии доступа к компьютеру, на котором установлен ColdFusion MX 7 или более поздней версии. Дополнительные сведения см. в разделе Дополнительные возможности ColdFusion.

 

  1. Создайте или откройте CFC-файл в Dreamweaver.
  2. На панели «Привязки» («Окно» > «Привязки») нажмите кнопку (+) и выберите во всплывающем меню «Набор записей (Запрос)».

    Открывается диалоговое окно «Набор записей». Можно работать в простом или расширенном диалоговом окне «Набор записей».

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

    Набор записей определяется в функции.

  4. Для определения в CFC новой функции нажмите кнопку «Создать функцию», введите в открывшемся диалоговом окне имя функции и нажмите кнопку «ОК».

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

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

    Новая функция вставляется в CFC, определяющий набор записей.

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

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

Примечание.

Данная функция доступна только при наличии доступа к компьютеру, на котором установлен ColdFusion MX 7 или более поздней версии. Более подробную информацию см. в разделе «Включение расширений ColdFusion».

  1. Откройте страницу ColdFusion в Dreamweaver.
  2. На панели «Привязки» («Окно» > «Привязки») нажмите кнопку (+) и выберите во всплывающем меню «Набор записей (Запрос)».

    Открывается диалоговое окно «Набор записей». Можно работать в простом или расширенном диалоговом окне «Набор записей».

  3. Нажмите кнопку «Запрос CFC».
  4. Задайте параметры в диалоговом окне «Запрос CFC», затем нажмите кнопку «ОК» для добавления набора записей CFC к списку доступных источников содержимого на панели «Привязки».
  5. Панель «Привязки» позволяет привязать набор записей к различным элементам страницы.

    Дополнительные сведения см. в разделе Добавление динамического содержимого на страницы.

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

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

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

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

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

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

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

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

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

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

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

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

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

Примечание.

Необходимо использовать путь к папке относительно корневой папки сайта.

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

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

Примечание.

Поля «Подключение» и SQL доступны только для чтения.

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

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

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

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

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

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

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

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

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

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

Получайте помощь быстрее и проще

Новый пользователь?