Откройте страницу ColdFusion в Dreamweaver.
Последнее обновление
25 апр. 2024 г.
Примечание
Поддержка ColdFusion удалена в Dreamweaver и более поздних версиях.
О компонентах ColdFusion
Файлы компонентов ColdFusion (CFC) позволяют инкапсулировать логику приложений и бизнес-логику в автономные, многократно используемые модули.CFC также обеспечивают быстрый и простой способ создания веб-служб.
CFC — это многократно используемый программный модуль, написанный на языке разметки ColdFusion (CFML), что упрощает повторное использование и сопровождение кода.
Для работы с CFC можно использовать Dreamweaver. Информацию о тегах и синтаксисе CFC см. в документации ColdFusion в Dreamweaver (Справка > Использование ColdFusion).
Примечание
CFC можно использовать вместе с ColdFusion MX или новее. CFC не поддерживаются в ColdFusion 5.
CFC предназначены для предоставления простого, но мощного способа инкапсуляции элементов веб-сайтов разработчиками. Как правило, компоненты следует использовать для логики приложений или бизнес-логики.Используйте пользовательские теги для элементов представления, таких как настраиваемые приветствия, динамические меню и т. д.
Как и многие другие типы конструкций, динамические сайты часто могут выиграть от взаимозаменяемых частей. Например, динамический сайт может выполнять один и тот же запрос многократно или вычислять общую стоимость страниц корзины покупок и пересчитывать ее каждый раз при добавлении товара. Такие задачи могут управляться компонентами. Вы можете исправлять, улучшать, расширять и даже заменять компонент с минимальным воздействием на остальную часть вашего приложения.
Предположим, интернет-магазин рассчитывает стоимость доставки на основе стоимости заказов. Для заказов менее $20 стоимость доставки составляет $4; для заказов от $20 до $40 стоимость доставки составляет $6 и так далее.Вы можете вставить логику для расчета стоимости доставки как на странице корзины покупок, так и на странице оформления заказа, но это привело бы к смешиванию кода представления HTML и логического кода CFML, что в целом усложнило бы сопровождение и повторное использование кода.
Вы решаете cоздать CFC под названием Pricing, который имеет, среди прочего, функцию ShippingCharge. Функция принимает цену в качестве аргумента и возвращает стоимость доставки. Например, если значение аргумента равно 32,80, функция возвращает 6.
На странице корзины покупок и на странице оформления заказа вы вставляете специальный тег для вызова функции ShippingCharge. При запросе страницы функция вызывается и стоимость доставки возвращается на страницу.
Позже магазин объявляет специальную акцию: бесплатная доставка для всех заказов свыше 100 $. Вы вносите изменение в тарифы доставки в одном месте — в функции ShippingCharge компонента Pricing — и все страницы, использующие функцию, автоматически получают точную стоимость доставки.
Обзор панели «Компоненты» (ColdFusion)
Используйте панель «Компоненты» (Окно > Компоненты) для просмотра и редактирования компонентов ColdFusion и добавления кода на странице, который вызывает функцию при запросе страницы CFM.
Примечание
Панель «Компоненты» доступна только при просмотре страницы ColdFusion в Dreamweaver.
Создание или удаление CFC в Dreamweaver
Dreamweaver можно использовать для визуального определения CFC и его функций. Dreamweaver создает файл .cfc и вставляет необходимые теги CFML за вас.
Примечание
В зависимости от компонента, возможно, придется ввести часть кода вручную.
На панели «Компоненты» (Окно > Компоненты) выберите CF Components из всплывающего меню.
Нажмите кнопку «Плюс» (+) и заполните диалоговое окно «Создать компоненты», затем нажмите «ОК».
А. В разделе «Компоненты» введите сведения о компоненте. Далее приводится частичный список данных.
Имя определяет имя файла компонента. Имя должно содержать только буквы или цифры и символы подчеркивания (_). При вводе имени не указывайте расширение файла .cfc.
Каталог компонента определяет, где компонент будет сохранен. Выберите корневую папку приложения (например, \Inetpub\wwwroot\myapp\) или любую вложенную папку.
b.Чтобы определить одну или несколько функций для компонента, выберите «Функции» из списка «Раздел», нажмите кнопку «Плюс» (+) и введите сведения о новой функции.
Убедитесь, что параметр «Возвращаемый тип» задает тип значения, возвращаемый функцией.
Примечание
Если в меню «Доступ» выбран удаленный доступ, функция становится доступной в виде веб-службы.
c.Чтобы определить один или несколько аргументов для функции, выберите «Аргументы» из списка «Раздел», выберите функцию из всплывающего меню, нажмите кнопку «Плюс» (+) и введите сведения о новом аргументе справа.
Если вы используете удаленный сервер разработки, загрузите файл CFC и любые зависимые файлы (например, те, которые используются для реализации функции или включаемые файлы) на удаленный сервер.
Загрузка файлов обеспечивает правильную работу функций Dreamweaver, таких как Live view и предварительный просмотр в браузере.
Dreamweaver записывает файл CFC и сохраняет его в указанной папке. Новый компонент также появляется на панели «Компоненты» (после нажатия «Обновить»).
Если вы используете удаленный сервер разработки, загрузите файл CFC и любые зависимые файлы (например, те, которые используются для реализации функции или включаемые файлы) на удаленный сервер.
Просмотр CFC в Dreamweaver
Dreamweaver позволяет визуально проверить компоненты ColdFusion (CFC), расположенные в папке сайта на сервере. Dreamweaver считывает файлы CFC и отображает информацию о них в удобном для навигации древовидном представлении на панели «Компоненты».
Dreamweaver ищет компоненты на вашем тестовом сервере (см. Подключение к базе данных в Dreamweaver). При создании CFC или изменении существующих CFC не забудьте загрузить CFC-файлы на тестовый сервер, чтобы они правильно отображались на панели «Компоненты».
Для просмотра компонентов, расположенных на другом сервере, измените настройки тестового сервера.
Можно просмотреть следующую информацию о компонентах CF.
Список всех определенных на сервере компонентов ColdFusion.
Если используется ColdFusion MX 7 или новее, можно отфильтровать список для отображения только компонентов CFC, расположенных в локальной папке.
Откройте в Проводнике функции и аргументы каждого компонента.
Просмотрите свойства функций, применяемых в качестве веб-служб.
Примечание
Чтобы в Dreamweaver просмотреть CFC, расположенные в корневой папке сервера, и обеспечить управление файлами сайта в корневой папке другого веб-сайта, можно определить два сайта Dreamweaver. Для первого сайта задайте корневую папку сервера, для второго — корневую папку веб-сайта. Для быстрого переключения между двумя сайтами служит всплывающее меню на панели «Файлы».
Для просмотра CFC в Dreamweaver выполните следующие действия.
Откройте любую страницу ColdFusion в Dreamweaver.
На панели «Компоненты» (Окно > Компоненты) выберите CF Components из всплывающего меню.
Нажмите кнопку «Обновить» на панели для получения
компонентов.
Пакет компонентов отображается на сервере. Пакет компонентов — это папка, содержащая файлы CFC.
Если существующие пакеты компонентов не отображаются, нажмите кнопку «Обновить» на панели инструментов.
Для отображения только CFC, расположенных в папке вашего сайта,
нажмите кнопку «Показать только CFC текущего сайта» на панели инструментов
панели «Компоненты».
Примечание
Эта функция доступна только если вы определили компьютер с ColdFusion MX 6 или новее как тестовый сервер для Dreamweaver.
Примечание
Если текущий сайт расположен в виртуальной папке на удаленном сервере, фильтрация не работает.
Нажмите кнопку «плюс» (+) рядом с названием пакета, чтобы
просмотреть компоненты, хранящиеся в пакете.
Для просмотра функций компонента нажмите кнопку «плюс» (+) рядом с названием компонента.
Для просмотра аргументов функции, а также их типа и того, являются ли они обязательными или необязательными, откройте ветвь функции в древовидном представлении.
Функции, которые не принимают аргументов, не имеют кнопки «плюс» (+) рядом с ними.
Для быстрого просмотра подробностей аргумента, функции, компонента или пакета выберите элемент в древовидном представлении и нажмите кнопку «Получить подробности» на панели инструментов панели.
Вы также можете щелкнуть правой кнопкой мыши (Windows) или щелкнуть, удерживая клавишу CONTROL (Macintosh), по элементу и выбрать «Получить подробности» из всплывающего меню.
Информация об элементе отображается в окне сообщения.
Редактирование CFC в Dreamweaver
Dreamweaver предоставляет усовершенствованный способ редактирования кода компонентов ColdFusion, определенных для вашего сайта. Например, вы можете добавлять, изменять или удалять любую функцию компонента, не покидая Dreamweaver.
Для использования этой функции ваша среда разработки должна быть настроена следующим образом:
ColdFusion должен выполняться локально.
В расширенном диалоговом окне определения сайта в Dreamweaver тип доступа, указанный в категории «Тестовый сервер», должен быть «Локальная/Сетевая».
В расширенном диалоговом окне определения сайта путь вашей локальной корневой папки должен совпадать с путем папки тестового сервера (например, c:\Inetpub\wwwroot\cf_projects\myNewApp\). Вы можете просмотреть и изменить эти пути, выбрав «Сайт» > «Редактировать сайты».
Компонент должен быть сохранен в папке локального сайта или в любой из ее подпапок на вашем жестком диске.
Откройте любую страницу ColdFusion в Dreamweaver и отобразите компоненты в панели «Компоненты». Чтобы отобразить компоненты, откройте панель «Компоненты» («Окно» > «Компоненты»), выберите «Компоненты CF» во всплывающем меню панели и нажмите кнопку «Обновить» на панели.
Поскольку ColdFusion работает локально, Dreamweaver отображает пакеты компонентов на вашем жестком диске.
Для редактирования компонентов применяется следующая процедура.
Откройте любую страницу ColdFusion в Dreamweaver и отобразите компоненты в
панели «Компоненты» («Окно» > «Компоненты»).
Выберите CF Components из всплывающего меню панели и нажмите кнопку «Обновить» на панели.
Поскольку ColdFusion работает локально, Dreamweaver отображает пакеты компонентов на вашем жестком диске.
Примечание
Для визуального редактирования набора записей CFC дважды щелкните его в панели «Привязки».
Для общего редактирования файла компонента откройте пакет
и дважды щелкните имя компонента в древовидном представлении.
Файл компонента открывается в представлении «Код».
Для редактирования конкретной функции, аргумента или свойства дважды щелкните
элемент в древовидном представлении.
Выполните изменения вручную в представлении кода.
Сохраните файл («Файл» > «Сохранить»).
Чтобы увидеть любую новую функцию на панели «Компоненты», обновите представление, нажав кнопку «Обновить» на панели инструментов.
Создание веб-страниц, использующих CFC
Один из способов использования функции компонента на веб-страницах заключается в создании на странице кода, вызывающего функцию при запросе страницы. Вы можете использовать Dreamweaver для написания этого кода.
Примечание
Другие способы использования компонентов см. в документации Adobe ColdFusion в Dreamweaver («Справка» > «Использование ColdFusion»).
В Dreamweaver откройте страницу ColdFusion, которая будет использовать функцию компонента.
Переключитесь на представление кода («Вид» > «Код»).
Откройте панель «Компоненты» («Окно» > «Компоненты»)
и выберите CF Components из всплывающего меню панели.
Найдите нужный компонент и вставьте его, используя один из
следующих способов:
Перетащите функцию из древовидного представления на страницу. На страницу вставляется код для вызова функции.
Выберите функцию на панели и нажмите кнопку «Вставить» на панели инструментов (вторая кнопка справа). Dreamweaver вставляет код на страницу в точке вставки.
Если вы вставляете функцию с аргументами, завершите код аргументов вручную.
Дополнительные сведения см. в документации ColdFusion из Dreamweaver (Справка > Использование ColdFusion).
Сохраните
страницу (Файл > Сохранить).
Определение набора записей в CFC
Dreamweaver упрощает определение набора записей (известного как запрос ColdFusion) в компоненте ColdFusion (CFC). Определение набора записей в CFC позволяет не определять набор записей для каждой страницы, использующей этот компонент. Определите набор записей в CFC один раз и применяйте этот компонент CFC к различным страницам.
Примечание
Данная функция доступна только при наличии доступа к компьютеру с выполняющимся приложением ColdFusion MX 7 или новее. Дополнительные сведения см. в разделе Включение расширений ColdFusion.
Создайте или откройте CFC-файл в Dreamweaver.
На панели «Привязки» (Окно > Привязки)
нажмите кнопку «Плюс» (+) и выберите «Набор записей (запрос)»
из всплывающего меню.
Открывается диалоговое окно «Набор записей». Вы можете работать в простом или расширенном диалоговом окне «Набор записей».
Чтобы использовать существующую функцию в CFC, выберите функцию
из всплывающего меню «Функция» и перейдите к шагу 5.
Набор записей определяется в функции.
Чтобы определить новую функцию в CFC, нажмите кнопку «Создать функцию»,
введите имя для функции в появившемся диалоговом окне,
а затем нажмите «ОК».
Имя должно содержать только буквенно-цифровые символы и подчеркивания (_).
Чтобы определить набор записей для функции, заполните
параметры диалогового окна «Набор записей».
Новая функция вставляется в CFC, который определяет набор записей.
Используйте набор записей CFC в качестве источника динамического контента
Если компонент ColdFusion (CFC) содержит функцию, определяющую набор записей, его можно использовать для страниц в качестве источника динамического содержимого.
Примечание
Данная функция доступна только при наличии доступа к компьютеру с выполняющимся приложением ColdFusion MX 7 или новее. Более подробную информацию см. в разделе «Включение расширений ColdFusion».
Откройте страницу ColdFusion в Dreamweaver.
На панели Bindings (Привязки) (Window > Bindings) нажмите кнопку Plus (+) и выберите Recordset (Query) (Набор записей (Запрос)) во всплывающем меню.
Открывается диалоговое окно «Набор записей». Можно работать как в простом, так и в расширенном диалоговом окне «Набор записей».
Нажмите кнопку «Запрос CFC».
Заполните диалоговое окно «Запрос CFC», нажмите «ОК», а затем
нажмите «ОК» снова, чтобы добавить набор записей CFC в список доступных
источников контента на панели «Привязки».
Используйте панель «Привязки», чтобы привязать набор записей к различным
элементам страницы.
Дополнительные сведения см. в разделе Добавление динамического контента на страницы.
Определение динамического контента с помощью CFC
Можно определить набор записей как источник динамического контента в Dreamweaver с помощью CFC, содержащего определение набора записей.
1.В поле «Имя» введите имя для набора записей CFC.
Обычно к именам наборов записей добавляют приставку rs, чтобы отличать их от других имен объектов в коде, например: rsPressRelease.
Имена наборов записей должны содержать только буквы или цифры и символы подчеркивания (_). Специальные символы или пробелы использовать нельзя.
2.Выберите пакет из уже определенных на сервере.
Если пакет не отображается во всплывающем меню, можно обновить список пакетов. Для этого нажмите кнопку «Обновить», расположенную рядом с всплывающим меню.
Убедитесь, что CFC уже загружены на тестовый сервер. В списке отображаются только CFC, расположенные на тестовом сервере.
3.Выберите компонент из определенных в выбранном пакете.
Если во всплывающем меню «Компоненты» нет компонентов или если в нем не отображаются ранее созданные компоненты, необходимо загрузить CFC-файлы на тестовый сервер.
4.(Необязательно) Чтобы создать компонент, нажмите кнопку «Создать новый компонент».
А. В поле «Имя» введите имя нового компонента CFC. Имя должно содержать только буквы или цифры и символы подчеркивания (_).
б.В поле «Папка компонента» введите расположение для вашего CFC или найдите папку с помощью обзора.
Примечание
Необходимо использовать путь к папке относительно корневой папки сайта.
5. В раскрывающемся меню «Function» выберите функцию, которая содержит определение набора записей.
Во всплывающем меню «Функция» представлены только функции, определенные для текущего выбранного компонента. Если в этом меню функции не отображаются или не представлены последние изменения в текущем списке функций, убедитесь, что изменения функций сохранены, а сами функции загружены на сервер.
Примечание
Поля «Подключение» и «SQL» доступны только для чтения.
6. Отредактируйте каждый параметр (тип, значение и значение по умолчанию), который должен быть передан в качестве аргумента функции, нажав кнопку «Edit».
А. Задайте значение для текущего параметра, выбрав тип значения во всплывающем меню «Значение» и введя само значение в поле справа. Тип значения может быть параметром URL-адреса, cookie, переменной сеанса, переменной приложения или заданным значением.
Б. Введите значение по умолчанию для параметра в поле «Значение по умолчанию». Значение по умолчанию используется, если не возвращается динамическое значение.
c. Нажмите «OK».
Для набора записей невозможно изменить подключение к базе данных и SQL-запрос. Эти поля недоступны. Подключение и SQL-запрос отображаются только в информационных целях.
7. Нажмите «Test», чтобы подключиться к базе данных и создать экземпляр набора записей.
Если SQL-оператор содержит параметры страницы, убедитесь, что в столбце «Значение по умолчанию» или «Параметры» содержатся допустимые значения.
Если запрос выполняется успешно, в таблице отображается набор записей. Каждая строка содержит запись, а каждый столбец представляет одно из полей этой записи.
Нажмите «ОК» для очистки запроса CFC.
8. Нажмите «OK».
Создание красивых веб-сайтов в Dreamweaver
Создавайте дизайн, пишите код и управляйте динамическими веб-сайтами с помощью многофункционального инструмента.
