JSP 라이브러리 정의 구성

JSP 라이브러리 정의에는 컴포넌트 라이브러리에 필요한 프로젝트 자원과 JSP 태그 해석을 위해 필요한 메타데이터를 포함합니다. JSP 라이브러리 정의는 이 제품으로 사용자 정의 JSP 태그 라이브러리 통합을 사용자 정의하는 데 도움이 됩니다.

시작하기 전에

기존 컴포넌트 라이브러리에 대한 지원 추가.

프로시저

  1. 편집기에서 라이브러리 정의 파일을 열려면 JSP 라이브러리 정의를 두 번 클릭하십시오. 라이브러리 정의 파일은 CLD 확장자를 갖습니다.
  2. 필요에 따라 라이브러리 정의를 변경하십시오. 라이브러리 정의 파일에는 다음 섹션이 있습니다.
  3. 라이브러리 정의를 구성한 후에 파일을 저장하십시오. 정의가 업데이트됩니다.
  4. 파일을 업데이트하려면 라이브러리 정의 업데이트를 클릭한 다음 업데이트 수행을 클릭하십시오. 업데이트 프로세스가 태그 라이브러리에서 새 태그와 속성을 찾아 라이브러리 정의에 추가합니다.
    알아두기: 업데이트가 완료되면 라이브러리 정의 버전이 증가합니다.

JSP 라이브러리 정의

JSP 라이브러리 정의 편집기는 새 JSP 라이브러리를 프로젝트에 통합하는 방법에 대한 세부사항을 구성하는 데 사용됩니다.

task_context

라이브러리 이름
라이브러리의 이름입니다.
설명
라이브러리에 대한 설명입니다.
Taglib URI
컴포넌트 라이브러리의 taglib URI입니다.
접두부
태그에 제공되는 접두부입니다.
버전
버전 번호는 라이브러리 정의의 구성 레벨을 나타냅니다. 버전은 기존 웹 애플리케이션에 대해 최신 자원이 사용 가능해지면 신호를 보냅니다. 라이브러리 정의가 처음 작성되면 선택한 태그 라이브러리에 의미있는 버전을 선택합니다. 예를 들어, 공개적으로 사용 가능한 태그 라이브러리의 릴리스 번호로 시작합니다. 버전 번호의 일반적인 양식은 1.2.3.4와 같이 마침표로 구분되는 문자열입니다. 라이브러리 정의가 사용 중이고 태그 라이브러리에 대한 자원이 하나 이상의 애플리케이션에 설치된 후에 정의를 추가로 변경하면 버전 업데이트가 필요할 수 있습니다. 배치된 라이브러리 정의의 애플리케이션 구성 섹션에서 변경사항이 작성되면 버전 번호를 증가시키십시오. 증가된 버전 번호는 최신 자원 또는 구성 변경사항이 사용 가능함을 워크벤치에 표시합니다. 태그 라이브러리를 사용하는 웹 프로젝트는 오류로 표시됩니다. 이 오류와 연관된 빠른 수정사항은 현재 구성으로 웹 프로젝트를 업데이트할 수 있습니다.
RememberColonSymbol 태그 라이브러리가 웹 프로젝트에 추가되지 않으면 버전 번호를 증가시키는 것은 불필요합니다.
애플리케이션 구성 섹션이 아닌 라이브러리 정의의 영역에 대한 변경사항은 동적으로 읽기 때문에 버전을 변경하지 않아도 됩니다.

애플리케이션 구성

다음은 새 컴포넌트 라이브러리를 사용하기 위해 웹 프로젝트를 설정하는 방법을 자세히 설명합니다. 이 구성은 웹 프로젝트로 파일을 복사하는 방법 및 컴포넌트가 올바르게 작동하도록 작성해야 하는 구성 변경사항을 선언합니다.

task_context

자원
자원 영역은 라이브러리가 처음으로 사용될 때 웹 프로젝트로 복사할 파일을 정의하는 데 사용됩니다. 소스 경로는 JSP 정의 프로젝트 내에 있는 파일에 대해 상대적인 경로입니다. 대상 경로는 라이브러리가 사용되는 프로젝트 내에 있는 경로입니다. 예를 들어, 소스 경로가 /mystylesheet.css인 파일에는 대상으로 /theme가 제공될 수 있습니다. 이 대상 경로로 인해 웹 프로젝트의 /theme 폴더로 배치되는 CSS 파일의 사본이 발생합니다.
web.xml 업데이트
라이브러리가 사용되는 웹 프로젝트의 배치 디스크립터에 대해 작성되는 여러 유형의 수정사항이 있습니다. 편집기의 해당 하위 섹션에 새 서블릿, 컨텍스트 매개변수 및 필터를 구성할 수 있습니다.
서블릿, 컨텍스트 매개변수 또는 필터를 추가하려면 다음을 수행하십시오.
  1. web.xml을 선택하십시오.
  2. 추가를 클릭하고 대화 상자에서 항목을 선택하십시오.
서블릿
web.xml에 추가되는 새 서블릿의 매개변수를 정의합니다.
컨텍스트 매개변수
웹 배치 디스크립터에서 컨텍스트 매개변수를 추가하는 데 대한 세부사항을 기록합니다. 라이브러리가 웹 프로젝트에서 처음으로 사용될 때 web.xml 파일은 이 정보를 포함하도록 수정됩니다.
필터
web.xml 파일에 추가되는 새 필터를 정의합니다. 이 필터의 초기화 매개변수는 편집기에서 추가를 클릭하면 추가됩니다.
초기화 매개변수
web.xml 필터 정의의 초기화 매개변수에 대한 데이터를 수집합니다.
URL 맵핑
필터의 URL 기반 맵핑을 수집합니다.
서블릿 맵핑
web.xml에서 정의되는 서블릿 이름을 기반으로 하는 필터 맵핑을 수집합니다.

태그 라이브러리

태그 라이브러리에는 라이브러리를 구성하고 도구 동작의 구성을 사용하는 모든 사용자 정의 태그가 나열됩니다. 예를 들어 팔레트에서의 태그 모양, 편집기에 태그를 놓을 때 동작, 웹 페이지 소스에서 컴포넌트의 시각적 모양 및 태그 속성과 데이터 바인딩에 대한 여러 세부사항을 지정할 수 있습니다.

task_context

컴포넌트 라이브러리에서 태그에 대한 세부사항을 구성할 수 있습니다. 라이브러리 정의가 생성될 때 여기에는 컴포넌트 라이브러리의 모든 태그가 포함됩니다. 위로아래로 단추를 사용하여 태그 순서를 변경할 수 있습니다. . 지정한 태그 순서는 팔레트의 라이브러리 모양에서 표시됩니다.

라이브러리 팔레트 카테고리에 대한 일부 시각적 정보를 구성할 수 있습니다. 스타일시트 링크를 구성하거나 이 라이브러리에 있는 모든 태그에 적용되는 JavaScript 참조를 구성하십시오. 팔레트에서 태그가 추가되면 해당하는 <link><script> 태그가 웹 페이지에 추가됩니다.

태그
아이콘 및 레이블 정보를 포함하여 팔레트에 있는 컴포넌트 태그의 모양을 구성합니다. 태그는 기본적으로 숨기거나 팔레트 선택사항에서 제거할 수도 있습니다.
놓기 특성
팔레트에서 새 태그를 삽입하는 동작은 이 페이지의 매개변수로 수정됩니다. 컴포넌트가 컨테이너와 유사한 제어이고 다른 컴포넌트가 하위로 허용되는 경우에는 하위 허용을 선택합니다. 스타일 시트 링크, JavaScript 참조는 이 페이지에서 태그별 기준으로 지정할 수 있습니다. 스타일 시트와 JavaScript 스펙도 태그 페이지에서 전체 라이브러리에 대해 작성할 수 있습니다.
기본 태그 속성
태그의 기본 속성 값을 설정하려면 속성의 이름과 값을 지정하십시오. 팔레트에서 컴포넌트 태그를 추가하는 경우 이 속성 값은 자동으로 설정됩니다.
시각화
컴포넌트가 많은 경우 비주얼 페이지 편집기의 태그 디스플레이는 올바르게 렌더링됩니다. 일부 경우에 태그 렌더링이 완전히 실패하거나 적절하게 렌더링되지 않습니다. 렌더링이 실패하면 태그가 태그 이름이 있는 회색 상자로 표시됩니다. 이 문제가 발생하면 기본 HTML 태그를 여러 변수 수정자로 지정하여 태그의 모양을 사용자 정의할 수 있습니다. 이 태그는 페이지 편집기에서 대체 시각화로 사용됩니다.
샘플 시각화 템플리트를 사용할 수 있으며 변수 수정자 사용 방법의 예가 포함됩니다. 템플리트를 보려면 세부사항 섹션에서 편집을 클릭하십시오.
시각화 패턴 변수에 대한 자세한 정보ColonSymbol

시각화 패턴은 페이지 편집기의 디자인 분할창에서 컴포넌트의 모양을 제어하는 데 사용합니다. 이 패턴은 시각화 컨텐츠를 동적으로 변경하기 위한 일부 선택적 대체 변수와 HTML 마크업으로 구성됩니다. 컴포넌트를 페이지로 끌어오면 해당 패턴이 평가됩니다. 페이지 편집기는 유용한 디자인 시간 표시를 작성하기 위해 결과로 생기는 HTML을 사용합니다. 사용 가능한 패턴 변수의 세부사항은 표 1에 표시됩니다.

Table 1. 시각화 패턴 변수. 설명과 예는 변수에 대한 정보를 제공합니다.
변수 설명 예제
${children} ${children} 변수는 시각화되는 태그의 모든 하위 태그를(하위 태그가 있는 경우) 패턴의 ${children} 변수 위치에서 생성합니다. 원래 페이지에 표시되는 순서대로 하위 태그가 삽입됩니다. 패턴을 사용할 수도 있기 때문에 페이지 편집기는 하위 태그의 시각화를 계산합니다. 모든 하위 태그가 동일한 위치에 삽입되기 때문에 패턴은 단지 하나의 ${children} 변수만 사용할 수 있습니다.
<div>
  ${children}
</div>
${children:row} ${children} 변수의 row 수정자가 HTML 테이블 셀 <td> 요소의 순서대로 하위 태그를 생성합니다. 이 변수는 여러 컴포넌트를 가로로 배열할 때 사용합니다.
<table>
  					<tr>
    ${children:row}
  					</tr>
			</table>
${children:grid(param[,param]*)}

grid 수정자는 태그의 하위가 포함된 HTML 테이블 행 및 셀 세트를 작성합니다. 하위는 왼쪽에서 오른쪽으로 추가되며 지정된 수의 열에 도달하면 다음 행으로 줄을 바꿉니다. 기본 열 개수는 2입니다. 쉼표로 구분되는 선택적 매개변수 목록은 눈금의 열 수를 대체합니다.

매개변수 옵션은 다음과 같습니다.
attr.attrName
이름이 attrName인 태그 속성의 값입니다. 이 매개변수는 정수로 분석해야 합니다.
N
양의 정수 상수입니다.

올바른 값을 찾을 때까지 매개변수를 순차적으로 검사합니다. 예를 들어 ${children:grid(attr.size, attr.numcols, 3)} 패턴은 태그의 size 속성이 정의된 경우 이 속성을 사용합니다. 그렇지 않은 경우 numcols 속성이 정의되어 있으면 이 속성을 사용합니다. 두 속성이 모두 정의되지 않은 경우에는 상수 3이 사용됩니다.

<table>
  ${children:grid(attr.columns, 2)}
			</table>
${children:stack(param)} stack 수정자는 스택된 셀 시각화를 채우기 위한 테이블 행과 셀을 작성하기 위해 탭 패널에서 사용됩니다. 각 하위 태그에 대해 클릭할 수 있는 레이블의 수평 테이블을 작성합니다. 레이블 중 하나를 클릭하면 하위 태그가 스택 맨 위에 표시됩니다. 선택적 매개변수는 attr.attrName 구문을 사용하여 레이블에 사용할 하위 태그의 태그 속성을 지정합니다.
<table>
  ${children:stack(attr.label)}
			</table>
${attr:attrName} 이 변수는 패턴의 현재 위치에 있는 태그의 속성 값을 대체합니다. 속성에 설정 값이 없는 경우 빈 문자열이 삽입됩니다.
<input type="text" value="${attr:value}" />
태그 속성
각 태그에 대해 속성 설명 및 유형을 지정할 수 있습니다. 목록의 속성 순서 및 각 유형은 특성 보기에서 속성이 표시되고 편집되는 방식에 영향을 미칩니다. 특정 유형은 속성 값 설정을 지원하기 위한 특정 헬퍼 대화 상자 또는 일련의 사용 가능한 선택사항을 표시합니다.
특성 보기
사용자 정의 특성 보기 페이지의 이 선택적 섹션에는 사용자 인터페이스 요소와 레이아웃 정보가 있습니다. 하나 이상의 탭의 컨텐츠를 정의하기 위해 중첩된 하위 요소를 특성 보기 섹션 아래 추가할 수 있습니다.
Tab
탭에는 그 안에 다른 UI 요소가 있으며 특성 보기에상응합니다. 탭 이름은 초기에 표시된 기본(첫 번째) 탭과 함께 보기에 표시됩니다. 첫 번째 탭에는 항상 선택된 태그의 이름이 있기 때문에 첫 번째 탭에 대한 이름 속성의 값은 무시됩니다.
열 요소는 일련의 기타 UI 요소를 세로 열에 시각적으로 그룹화합니다. 둘 이상의 열은 탭이나 섹션 요소 내에 정의하며 각 열 내에서 하위 제어가 구성됩니다. 열이 아닌 요소는 열이 사용되는 컨테이너와 동일한 컨테이너 내에서 지원되지 않습니다. 다중 열 배열을 섹션 내 해당 고유 영역으로 분리해야 할 수 있습니다.
편집기
편집기 요소는 다음을 정의합니다.
  • 단일 선택 단추와 같이 특성 보기에 표시되는 사용자 인터페이스 제어의 유형
  • 사용자 인터페이스 제어가 수정할 현재 태그의 속성
  • 사용자 인터페이스 제어 다음에 표시되는 문자열 레이블
또한 매개변수를 편집기 요소에 추가할 수 있습니다.
편집기 매개변수
일부 편집기 요소는 선택적 편집기 매개변수를 사용하여 제어의 동작을 사용자 정의할 수 있습니다. 예를 들면, 허용 가능 값을 정의하는 선택사항 매개변수를 사용하여 조합 상자 및 기타 비슷한 선택 제어를 구성할 수 있습니다. 선택사항 매개변수의 값은 enum{value1, value2, value3} 구문을 사용하고 개별 레이블 및 값이 조합 상자에서 사용되는 경우 enum{name1:value1, name2:value2} 구문을 사용합니다. 다른 사전 정의된 편집기 매개변수 대부분은 true 또는 false 값을 승인합니다.
레이블
레이블 요소는 특성 보기에 텍스트 정보를 포함하는 레이블을 배치합니다.
섹션
섹션 요소는 자급식 UI 부분을 정의하는 컨테이너입니다. 섹션은 섹션이 포함하는 제어의 공간에 대한 제어를 제공하는 데 사용할 수 있습니다. 예를 들어, 섹션은 주위 레이아웃에서 여러 열에 걸치도록 구성되거나 자체 컨텐츠에 대해 새 열 구조를 정의하도록 구성할 수 있습니다.
구분 기호
구분 기호 요소는 특성 보기 컨텐츠를 나누기 위해 수평 자를 사용합니다.
주제 유형을 표시하는 아이콘 태스크 주제
Information Center의 이용 약관 | 피드백

시간소인 아이콘 마지막 업데이트 날짜: 2014-05-22

파일 이름: tconfiglibdefjsp.html