Dreamweaver에서 ColdFusion 구성 요소 사용

마지막 업데이트 날짜 2024년 4월 25일
메모

Dreamweaver 이상 버전에서는 ColdFusion 지원이 제거되었습니다.

ColdFusion 구성 요소 정보

ColdFusion 구성 요소(CFC) 파일을 사용하면 애플리케이션과 비즈니스 로직을 독립적이고 재사용 가능한 단위로 캡슐화할 수 있습니다. CFC는 웹 서비스를 빠르고 간편하게 만드는 방법도 제공합니다.

CFC는 ColdFusion 마크업 언어(CFML)로 작성된 재사용 가능한 소프트웨어 단위로, 코드를 쉽게 재사용하고 유지 관리할 수 있습니다.

Dreamweaver에서는 CFC를 사용하여 작업할 수 있습니다. CFC 태그와 구문에 대한 정보는 Dreamweaver 내에서 ColdFusion 설명서를 확인하십시오([도움말] > ColdFusion 사용).

메모

CFC는 ColdFusion MX 이상에서만 사용할 수 있습니다. CFC는 ColdFusion 5에서 지원되지 않습니다.

CFC는 개발자가 웹 사이트의 요소를 캡슐화할 수 있는 간단하면서도 강력한 방법을 제공하기 위해 만들어졌습니다. 일반적으로 애플리케이션 또는 비즈니스 로직에는 구성 요소를 사용해야 합니다. 맞춤형 인사말, 동적 메뉴 등과 같은 프레젠테이션 요소에는 사용자 지정 태그를 사용하십시오.

다른 여러 구조 유형과 마찬가지로 동적 위치에서도 상호 교환 가능한 부품을 활용하는 것이 유용할 수 있습니다. 예를 들어, 동적 사이트에서는 동일한 쿼리를 반복적으로 실행하거나 장바구니 페이지의 총 가격을 계산하고 항목이 추가될 때마다 다시 계산할 수 있습니다.이러한 작업을 구성 요소로 처리할 수 있습니다. 구성 요소를 수정, 개선, 확장하거나 교체해도 나머지 애플리케이션에 미치는 영향을 최소화할 수 있습니다.

온라인 스토어가 주문 가격을 기준으로 배송비를 계산한다고 가정해 보겠습니다.$20 미만 주문하다의 경우 배송비는 $4이고, $20~$40 사이 주문하다의 경우 배송비는 $6입니다. 장바구니 페이지와 체크아웃 페이지 모두에 배송비 계산 로직을 삽입할 수도 있지만, 그렇게 하면 HTML 프레젠테이션 코드와 CFML 로직 코드가 혼재하여 일반적으로 코드를 유지 관리하고 재사용하기 어려워집니다.

Pricing이라는 CFC를 만들어서, 무엇보다도 ShippingCharge라는 기능을 포함시키기로 결정했습니다. 이 기능은 가격을 인수로 받아 배송비를 반환합니다. 예를 들어, 인수 값이 32.80이면 기능은 6을 반환합니다.

장바구니 페이지와 체크아웃 페이지 모두에서 ShippingCharge 기능을 호출하는 특수 태그를 삽입합니다. 페이지가 요청되면 기능이 호출되고 배송비가 페이지로 반환됩니다.

나중에 웹 스토어에서 특별 프로모션을 공지합니다. $100 이상 모든 주문하다에 대해 무료 배송을 제공하는 것입니다. Pricing 구성 요소의 ShippingCharge 기능이라는 한 곳에서만 배송비를 변경하면 이 기능을 사용하는 모든 페이지에서 자동으로 정확한 배송비를 확인할 수 있습니다.

구성 요소 패널 개요(ColdFusion)

구성 요소 패널([창] > 구성 요소)을 사용하여 ColdFusion 구성 요소를 보고 편집하며, CFM 페이지가 요청될 때 기능을 호출하는 코드를 페이지에 추가하십시오.

메모

구성 요소 패널은 Dreamweaver에서 ColdFusion 페이지를 볼 때만 사용할 수 있습니다.

Dreamweaver에서 CFC 만들기 또는 삭제

Dreamweaver에서는 CFC 및 관련 함수를 시각적으로 정의할 수 있습니다. 그러면 Dreamweaver에서 .cfc 파일을 만들고 필요한 CFML 태그를 자동으로 삽입합니다.

메모

구성 요소에 따라 일부 코드를 직접 작성해야 하는 경우도 있습니다.

Dreamweaver에서 ColdFusion 페이지를 엽니다.

[구성 요소] 패널([창] > [구성 요소])에서 팝업 메뉴의 CF Components를 선택합니다.

[+] 버튼을 클릭하고 [구성 요소 만들기] 대화 상자를 완성한 후 [확인]을 클릭합니다.

a. [구성 요소] 영역에서 구성 요소의 세부 정보를 입력합니다. 다음은 일부를 나타낸 것입니다.

이름  구성 요소의 파일 이름을 지정합니다. 이름에는 영숫자와 밑줄(_)만 사용할 수 있습니다. 이름을 입력할 때 .cfc 파일 확장명은 지정하지 마십시오.

구성 요소 디렉터리  구성 요소가 저장되는 위치를 지정합니다. 웹 응용 프로그램의 루트 폴더(예: \Inetpub\wwwroot\myapp\) 또는 이 폴더의 하위 폴더를 선택합니다.  

b.구성 요소에 대해 하나 이상의 기능을 정의하려면 [섹션] 목록에서 [기능]을 선택하고 [+] 버튼을 클릭한 후 새 기능의 세부 사항을 입력합니다.

[반환 유형] 옵션에는 함수가 반환하는 값의 유형을 지정해야 합니다.

메모

[액세스] 메뉴에서 [원격]을 선택하면 해당 함수를 웹 서비스로 사용할 수 있습니다.

c.기능에 대해 하나 이상의 인수를 정의하려면 [섹션] 목록에서 [인수]를 선택하고 팝업 메뉴에서 기능을 선택한 후 [+] 버튼을 클릭하여 오른쪽에 새 인수의 세부 사항을 입력합니다.

원격 개발 서버를 사용하는 경우 CFC 파일과 모든 종속 파일(기능 구현에 사용되는 파일 또는 포함 파일 등)을 원격 서버에 업로드합니다.

파일을 업로드하면 라이브 보기 및 브라우저에서 미리보기와 같은 Dreamweaver 기능이 제대로 작동합니다.

Dreamweaver가 CFC 파일을 작성하여 지정한 폴더에 저장합니다. 새 구성 요소는 [구성 요소] 패널에도 나타납니다 ([새로 고침]을 클릭한 후).

원격 개발 서버를 사용하는 경우 CFC 파일과 모든 종속 파일(기능 구현에 사용되는 파일 또는 포함 파일 등)을 원격 서버에 업로드합니다.

Dreamweaver에서 CFC 보기

Dreamweaver에서는 전체적으로 사이트 폴더 또는 서버에 있는 CFC(ColdFusion 구성 요소)를 시각적으로 검토할 수 있습니다. Dreamweaver가 CFC 파일을 읽고 [구성 요소] 패널에서 탐색하기 쉬운 트리 보기로 해당 정보를 표시합니다.

Dreamweaver는 테스트 서버에서 구성 요소를 찾습니다(Dreamweaver에서 데이터베이스에 연결 참조). CFC를 만들거나 기존 CFC를 변경할 경우 CFC 파일을 테스트 서버에 업로드하여 CFC 파일이 [구성 요소] 패널에 정확하게 반영되도록 합니다.

다른 서버에 있는 구성 요소를 보려면 테스트 서버 설정을 변경합니다.

확인할 수 있는 CF 구성 요소에 대한 정보는 다음과 같습니다.

  • 서버에 정의된 모든 ColdFusion 구성 요소 목록 표시

  • ColdFusion MX 7 이상을 실행 중인 경우 목록을 필터링하여 사이트 폴더에 있는 CFC만 표시

  • 각 구성 요소의 함수 및 인수 탐색

  • 웹 서비스로 제공되는 함수의 속성 검사

메모

Dreamweaver를 사용하여 서버 루트에 있는 CFC를 검사하면서 다른 웹 사이트의 루트에 있는 사이트 파일을 관리하기 위해 두 개의 Dreamweaver 사이트를 정의할 수 있습니다. 첫 번째 사이트는 서버 루트를 가리키도록 설정하고, 두 번째 사이트는 웹 사이트 루트를 가리키도록 설정합니다. [파일] 패널에 있는 사이트 팝업 메뉴를 사용하여 두 사이트 간을 빠르게 전환할 수 있습니다.

Dreamweaver에서 CFC를 보려면 다음 단계를 수행합니다.

Dreamweaver에서 ColdFusion 페이지를 엽니다.
[구성 요소] 패널([창] > [구성 요소])에서 팝업 메뉴로부터 CF Components를 선택합니다.
패널의 [새로 고침] 버튼을 클릭하여 구성 요소를 가져옵니다.

그러면 서버에 있는 구성 요소 패키지가 표시됩니다. 구성 요소 패키지는 CFC 파일이 포함된 폴더입니다.

기존 구성 요소 패키지가 나타나지 않으면 패널 도구 모음의 [새로 고침] 버튼을 클릭합니다.

사이트 폴더에 있는 CFC만 표시하려면 [구성 요소] 패널 도구 모음에서 [현재 사이트의 CFC만 표시] 버튼을 클릭합니다.
메모

이 기능은 ColdFusion MX 6 이상이 실행되는 컴퓨터를 Dreamweaver의 테스트 서버로 정의한 경우에만 사용할 수 있습니다.

메모

현재 사이트가 원격 서버의 가상 폴더에 나열된 경우 필터링이 작동하지 않습니다.

패키지 이름 옆의 더하기(+) 버튼을 클릭하여 패키지에 저장된 구성 요소를 확인합니다.
  • 구성 요소의 기능을 나열하려면 구성 요소 이름 옆의 [+] 버튼을 클릭합니다.

  • 기능이 가져오는 인수와 인수 유형, 필수인지 또는 선택 사항인지 확인하려면 트리 보기에서 기능의 분기를 엽니다.

    인수를 사용하지 않는 기능에는 옆에 [+] 버튼이 없습니다.

  • 인수, 기능, 구성 요소 또는 패키지의 세부 사항을 빠르게 확인하려면 트리 보기에서 항목을 선택하고 패널 도구 모음의 [세부 사항 가져오기] 버튼을 클릭합니다.

    항목을 마우스 오른쪽 버튼으로 클릭(Windows)하거나 Control 키를 누른 채 클릭(Macintosh)하여 팝업 메뉴에서 [세부 사항 가져오기]를 선택할 수도 있습니다.

    항목에 대한 세부 정보가 메시지 상자에 표시됩니다.

Dreamweaver에서 CFC 편집

Dreamweaver는 사이트에 정의된 ColdFusion 구성 요소의 코드를 편집하는 간소화된 방법을 제공합니다.예를 들어 Dreamweaver를 종료하지 않고도 구성 요소 함수를 추가, 변경 또는 삭제할 수 있습니다.

이 기능을 사용하려면 개발 환경이 다음과 같이 설정되어야 합니다.

  • ColdFusion은 로컬에서 실행되어야 합니다.

  • Dreamweaver의 고급 사이트 정의 대화 상자에서 테스트 서버 범주에 지정된 액세스 유형이 로컬/네트워크여야 합니다.

  • 고급 사이트 정의 대화 상자에서 로컬 루트 폴더의 경로가 테스트 서버 폴더의 경로와 동일해야 합니다 (예: c:\Inetpub\wwwroot\cf_projects\myNewApp\).[사이트] > [사이트 편집]을 선택하여 이러한 경로를 확인하고 변경할 수 있습니다.

  • 구성 요소는 로컬 사이트 폴더 또는 해당 폴더의 하위 폴더 중 하나에 저장되어야 합니다.

Dreamweaver에서 임의의 ColdFusion 페이지를 열고 구성 요소 패널에서 구성 요소를 표시하십시오.구성 요소를 표시하려면 구성 요소 패널([창] > [구성 요소])을 열고 패널의 팝업 메뉴에서 CF 구성 요소를 선택한 후 패널의 [새로고침] 버튼을 클릭합니다.

ColdFusion이 로컬에서 실행되고 있기 때문에 Dreamweaver는 하드 디스크의 구성 요소 패키지를 표시합니다.

구성 요소를 편집하려면 다음 절차를 수행합니다.

Dreamweaver에서 ColdFusion 페이지를 열고 구성 요소 패널([창] > [구성 요소])에서 구성 요소를 표시하십시오.
패널의 팝업 메뉴에서 [CF 구성 요소]를 선택하고 패널의 [새로 고침] 버튼을 클릭합니다.

ColdFusion이 로컬에서 실행되고 있기 때문에 Dreamweaver는 하드 디스크의 구성 요소 패키지를 표시합니다.

메모

CFC 레코드 집합을 시각적으로 편집하려면 바인딩 패널에서 해당 항목을 두 번 클릭합니다.

구성 요소 파일을 편집하려면 패키지를 열고 트리 보기에서 구성 요소 이름을 두 번 클릭하십시오.

그러면 코드 보기에서 구성 요소 파일이 열립니다.

특정 함수, 인수 또는 속성을 편집하려면 트리 보기에서 해당 항목을 두 번 클릭하십시오.
코드 보기에서 직접 필요한 변경을 수행합니다.
파일을 저장합니다([파일] > [저장]).
구성 요소 패널에서 새 함수를 보려면 패널 도구 모음의 [새로 고침] 버튼을 클릭하여 뷰를 새로 고침합니다.

CFC를 사용하는 웹 페이지 구성

웹 페이지에 구성 요소 함수를 사용하는 한 가지 방법은 페이지가 요청될 때 해당 함수를 호출하는 페이지 코드를 작성하는 것입니다. Dreamweaver를 사용하여 이 코드 작성에 도움을 받을 수 있습니다.

메모

구성 요소를 사용하는 다른 방법에 대해서는 Dreamweaver 내에서 ColdFusion 문서를 참조하십시오([도움말] > [ColdFusion 사용법]).

Dreamweaver에서 구성 요소 함수를 사용할 ColdFusion 페이지를 엽니다.
코드 보기로 전환합니다([보기] > [코드]).
구성 요소 패널([창] > [구성 요소])을 열고 패널의 팝업 메뉴에서 [CF 구성 요소]를 선택합니다.
원하는 구성 요소를 찾아 다음 방법 중 하나를 사용하여 삽입합니다:
  • 트리 뷰에서 함수를 페이지로 끌어다 놓습니다.그러면 함수를 호출하는 코드가 페이지에 삽입됩니다.

  • 패널에서 함수를 선택하고 패널 도구 모음의 [삽입] 버튼(오른쪽에서 두 번째 버튼)을 클릭합니다.Dreamweaver가 삽입 지점에서 페이지에 코드를 삽입합니다.

인수가 있는 함수를 삽입하는 경우 인수 코드를 직접 완성하십시오.

자세한 내용은 Dreamweaver 내에서 ColdFusion 설명서를 참조하십시오([도움말] > ColdFusion 사용).

페이지를 저장하세요([파일] > [저장]).

CFC에 레코드세트 정의

Dreamweaver를 사용하면 CFC(ColdFusion 구성 요소)에 레코드세트(ColdFusion 쿼리라고도 함)를 정의할 수 있습니다. CFC에 레코드세트를 정의하면 사용되는 페이지마다 레코드세트를 정의할 필요가 없습니다. CFC에 레코드세트를 한 번만 정의하면 다른 페이지에서도 CFC를 사용할 수 있습니다.

메모

이 기능은 ColdFusion MX 7 이상이 실행 중인 컴퓨터에 액세스할 수 있는 경우에만 사용할 수 있습니다. 자세한 내용은 ColdFusion 확장 기능 사용을 참조하십시오.

 

Dreamweaver에서 CFC 파일을 만들거나 기존 CFC 파일을 엽니다.
[바인딩] 패널([창] > [바인딩])에서 플러스(+) 버튼을 클릭하고 팝업 메뉴에서 [레코드셋](쿼리)을 선택합니다.

그러면 [레코드세트] 대화 상자가 나타납니다. 단순 또는 고급 [레코드셋] 대화 상자에서 작업할 수 있습니다.

CFC에서 기존 함수를 사용하려면 [함수] 팝업 메뉴에서 함수를 선택하고 5단계로 건너뜁니다.

레코드세트는 함수에 정의되어 있습니다.

CFC에서 새 함수를 정의하려면 [새 함수] 버튼을 클릭하고, 나타나는 대화 상자에서 함수 이름을 입력한 다음 [확인]을 클릭합니다.

이름에는 영숫자와 밑줄(_)만 포함되어야 합니다.

함수에 대한 레코드셋을 정의하려면 [레코드셋] 대화 상자 옵션을 완성합니다.

새 함수가 레코드셋을 정의하는 CFC에 삽입됩니다.

CFC 레코드셋을 다이내믹 콘텐츠의 소스로 사용

ColdFusion 구성 요소(CFC)에 레코드세트를 정의하는 함수가 포함되어 있을 경우 해당 구성 요소를 페이지 동적 내용의 소스로 사용할 수 있습니다.

메모

이 기능은 ColdFusion MX 7 이상이 실행 중인 컴퓨터에 액세스할 수 있는 경우에만 사용할 수 있습니다. 자세한 내용은 ColdFusion 확장 기능 사용을 참조하십시오.

Dreamweaver에서 ColdFusion 페이지를 엽니다.
[바인딩] 패널([창] > [바인딩])에서 [+] 버튼을 클릭하고 팝업 메뉴에서 [레코드셋(쿼리)]을 선택하십시오.

그러면 [레코드세트] 대화 상자가 나타납니다. 간단 또는 고급 레코드셋 대화 상자 중 하나에서 작업할 수 있습니다.

[CFC 쿼리] 버튼을 클릭합니다.
CFC 쿼리 대화 상자를 완료하고 [확인]을 클릭한 다음 다시 [확인]을 클릭하여 [바인딩] 패널의 사용 가능한 콘텐츠 소스 목록에 CFC 레코드셋을 추가하십시오.
바인딩 패널을 사용하여 레코드셋을 다양한 페이지 요소에 연결하십시오.

자세한 내용은 페이지에 다이내믹 콘텐츠 추가하기를 참조하십시오.

CFC를 사용하여 다이내믹 콘텐츠 정의하기

레코드셋 정의가 포함된 CFC를 사용하여 Dreamweaver에서 다이내믹 콘텐츠의 소스로 레코드셋을 정의할 수 있습니다.

1.[이름] 상자에 CFC 레코드셋의 이름을 입력하십시오.

코드에서 다른 객체 이름과 구별하기 위해 레코드셋 이름에 접두사 rs를 추가하는 것이 일반적인 방법입니다. 예: rsPressRelease.

레코드세트 이름에는 영숫자와 밑줄(_)만 사용할 수 있습니다. 특수 문자나 공백은 사용할 수 없습니다.

2.서버에서 이미 정의된 패키지 중 하나를 선택하십시오.

팝업 메뉴에 패키지가 표시되지 않을 경우에는 팝업 메뉴 옆에 있는 [새로 고침] 버튼을 클릭하여 패키지 목록을 새로 고칠 수 있습니다.

CFC를 먼저 테스트 서버에 업로드했는지 확인합니다. 테스트 서버에 있는 CFC만 표시됩니다.

3.현재 선택된 패키지에서 정의된 구성 요소 중 하나를 선택하십시오.

구성 요소 팝업 메뉴에 구성 요소가 없는 경우나 이전에 만든 구성 요소가 메뉴에 표시되지 않을 경우, CFC 파일을 테스트 서버에 업로드해야 합니다.

4.(선택 사항) 구성 요소를 만들려면 [새 구성 요소 만들기] 버튼을 클릭하십시오.

a. [이름] 상자에 새 CFC의 이름을 입력합니다. 이름에는 영숫자와 밑줄(_)만 사용할 수 있습니다.

b.[구성 요소 디렉터리] 상자에 CFC의 위치를 입력하거나 찾아보기를 통해 폴더를 찾으십시오.

메모

폴더는 사이트 루트 폴더에 대한 상대 경로여야 합니다.

5.[함수] 팝업 메뉴에서 레코드세트 정의가 포함된 함수를 선택합니다.

[함수] 팝업 메뉴에는 현재 선택한 구성 요소에 정의된 함수만 있습니다. 이 팝업 메뉴에 함수가 표시되지 않거나 마지막 변경 사항이 현재 나열된 함수에 적용되어 있지 않은 경우, 마지막 변경 사항을 저장하고 서버에 업로드했는지 확인합니다.

메모

[연결] 및 [SQL] 상자는 읽기 전용입니다.

6.[편집] 버튼을 클릭하여 함수 인수로 전달되어야 하는 각 매개변수(유형, 값, 기본값)를 편집합니다.

a. [값] 팝업 메뉴에서 값 유형을 선택하고 오른쪽에 있는 상자에 값을 입력하여 현재 매개 변수의 값을 입력합니다. 값 유형은 URL 매개 변수, 양식 변수, 쿠키, 세션 변수, 응용 프로그램 변수 또는 입력한 값이 될 수 있습니다.

b. [기본값] 상자에 매개 변수의 기본값을 입력합니다. 런타임 값이 반환되지 않을 경우 기본 매개 변수 값이 사용됩니다.

c.[확인]을 클릭하십시오. 

레코드세트에 대한 데이터베이스 연결과 SQL 쿼리는 수정할 수 없습니다. 이 필드는 항상 비활성화되어 있으며, 참조를 위해 연결 및 SQL 쿼리가 표시됩니다.

7. [테스트]를 클릭하여 데이터베이스에 연결하고 레코드세트의 인스턴스를 만드십시오.

SQL 문에 페이지 매개 변수가 포함된 경우 [테스트]를 클릭하기 전에 [매개 변수] 상자의 [기본값] 열에 올바른 테스트 값이 들어 있는지 확인합니다.

쿼리가 성공적으로 실행될 경우 표에 레코드세트가 표시됩니다. 각 행에는 레코드가 들어 있으며 각 열에는 이 레코드에 있는 필드가 표시됩니다.

[확인]을 클릭하여 CFC 쿼리를 지웁니다.

8.[확인]을 클릭하십시오.