HTP

HTP 패키지의 기본 개념과 패키지 내의 프러시저와 함수를 사용하는 방법을 설명합니다.

개요

HTP은 HTML 소스 코드를 생성하는 패키지입니다. 프러시저를 사용하여 HTML 태그를 작성하고, 합쳐진소스 코드를 내보내는 역할을 합니다. 예를 들어 HTP.HTMLOPEN은 <HTML> 태그를, HTP.HTMLCLOSE 는 </HTML> 태그를 생성합니다.

Apache와의 연동

Tibero 5.0부터는 mod_tbpsm라는 Apache 모듈을 구현하여 배포합니다. Apache HTTP 서버로부터 온 요청 에 따라 mod_tbpsm을 이용하여 HTP 패키지로 구현된 프러시저를 호출하고 생성된 HTML 페이지를 내보냅니다.

참고

mod_tbpsm 설정 및 사용 방법은 "Tibero 애플리케이션 개발자 안내서"를 참고합니다.

프러시저와 함수

본 절에서는HTP 패키지에서 제공하는 프러시저와 함수를 알파벳 순으로 설명합니다.

BODYCLOSE

</BODY> 태그를 작성하는 프러시저입니다. </BODY> 태그는 HTML 문서 중 본 내용의 끝을 의미합니다.

BODYCLOSE 프러시저의 세부 내용은 다음과 같습니다.

프로토타입

HTP.BODYCLOSE

예제

BEGIN
    HTP.BODYCLOSE;
END;

다음은 생성된 HTML 코드입니다.

</BODY>

BODYOPEN

<BODY> 태그를 작성하는 프러시저입니다. <BODY> 태그는 HTML 문서 중 본 내용의 시작을 의미하고, 속성을 지정하여 배경 등을 변경할 수 있습니다.

BODYOPEN 프러시저의 세부 내용은 다음과 같습니다.

프로토타입

HTP.BODYOPEN
(
    background IN VARCHAR2 DEFAULT NULL,
    attributes IN VARCHAR2 DEFAULT NULL
)

파라미터

파라미터

설명

background

<BODY> 태그의 background 속성값
HTML문서의 배경 그림 파일 경로 를 지정

attributes

<BODY> 태그의 기타 속성 및 속성값들의 문자열

예제

BEGIN
    HTP.BODYOPEN('/img/tibero.jpg');
END;

다음은 생성된 HTML 코드입니다.

<BODY background="/img/tibero.jpg">

BR

HTML 페이지의 새로운 라인을 가리키는 <BR> 태그를 작성하는 프러시저입니다.

BR 프러시저의 세부 내용은 다음과 같습니다.

프로토타입

HTP.BR
(
    clear      IN VARCHAR2 DEFAULT NULL,
    attributes IN VARCHAR2 DEFAULT NULL
)

파라미터

파라미터

설명

clear

CLEAR 속성의 값

attributes

기타 속성 및 값들의 문자열

예제

BEGIN
    HTP.BR;
END;

다음은 생성된 HTML 코드입니다.

<BR>

CENTER

<CENTER> 태그, 중앙에 배치될 문자열, </CENTER> 태그를 작성하는 프러시저입니다.

CENTER 프러시저의 세부 내용은 다음과 같습니다.

프로토타입

HTP.CENTER
(
    text IN VARCHAR2
)

파라미터

파라미터

설명

text

웹 페이지의 중앙에 배치될 문자열

예제

BEGIN
    HTP.CENTER('Tibero');
END;

다음은 생성된 HTML 코드입니다.

<CENTER>Tibero</CENTER>

CENTERCLOSE

</CENTER> 태그를 작성하는 프러시저입니다.

CENTERCLOSE 프러시저의 세부 내용은 다음과 같습니다.

프로토타입

HTP.CENTERCLOSE

예제

BEGIN
    HTP.CENTERCLOSE;
END;

다음은 생성된 HTML 코드입니다.

</CENTER>

CENTEROPEN

<CENTER> 태그를 작성하는 프러시저입니다.

CENTEROPEN 프러시저의 세부 내용은 다음과 같습니다.

프로토타입

HTP.CENTEROPEN

예제

BEGIN
    HTP.CENTEROPEN;
    HTP.IMG(url => '/img/tibero.gif');
    HTP.CENTERCLOSE;
END;

다음은 생성된 HTML 코드입니다.

<CENTER>
<IMG src="/img/tibero.glf">
</CENTER>

FONTCLOSE

</FONT> 태그를 작성하는 프러시저입니다. <FONT> 태그에서 부여된 속성들은 이 태그 앞까지만 적용됩니다.

FONTCLOSE 프러시저의 세부 내용은 다음과 같습니다.

프로토타입

HTP.FONTCLOSE

예제

BEGIN
    HTP.FONTCLOSE;
END;

다음은 생성된 HTML 코드입니다.

</FONT>

FONTOPEN

<FONT> 태그를 작성하는 프러시저입니다. 이후 작성되는 문자열들의 폰트 설정에 반영됩니다.

FONTOPEN 프러시저의 세부 내용은 다음과 같습니다.

프로토타입

HTP.FONTOPEN
(
    color      IN VARCHAR2 DEFAULT NULL,
    face       IN VARCHAR2 DEFAULT NULL,
    size       IN VARCHAR2 DEFAULT NULL,
    attributes IN VARCHAR2 DEFAULT NULL
)

파라미터

파라미터

설명

color

COLOR 속성의 값

face

FACE 속성의 값

size

SIZE 속성의 값

attributes

기타 속성 및 속성값들의 문자열

예제

BEGIN
    HTP.FONTOPEN(NULL, 'Fixedsys', 3);
END;

다음은 생성된 HTML 코드입니다.

<FONT face="Fixedsys" size="3">

FORMSELECTCLOSE

</SELECT> 태그를 작성하는 프러시저입니다.

FORMSELECTCLOSE 프러시저의 세부 내용은 다음과 같습니다.

프로토타입

HTP.FORMSELECTCLOSE

예제

“3.10. FORMSELECTOPEN” 예제를 참조합니다.

FORMSELECTOPEN

<SELECT> 태그를 작성하는 프러시저입니다.

FORMSELECTOPEN 프러시저의 세부 내용은 다음과 같습니다.

프로토타입

HTP.FORMSELECTOPEN
(
    cname       IN VARCHAR2,
    cprompt     IN VARCHAR2 DEFAULT NULL,
    nsize       IN VARCHAR2 DEFAULT NULL,
    cattributes IN VARCHAR2 DEFAULT NULL
)

파라미터

파라미터

설명

cprompt

선택 리스트 앞에 올 문장

cname

NAME 속성의 값

nsize

SIZE 속성의 값

cattributes

기타 속성 및 속성값들의 문자열

예제

BEGIN
    HTP.FORMSELECTOPEN('favorite_fruit', '좋아하는 과일은?');
    HTP.FORMSELECTOPTION('사과');
    HTP.FORMSELECTOPTION('포도');
    HTP.FORMSELECTOPTION('귤');
    HTP.FORMSELECTOPTION('자두');
    HTP.FORMSELECTCLOSE;
END;

다음은 생성된 HTML 코드입니다.

좋아하는 과일은?:
<SELECT NAME="favorite_fruit">
<OPTION>사과
<OPTION>포도
<OPTION>귤
<OPTION>자두
</SELECT>

FORMSELECTOPTION

<OPTION> 태그를 작성하는 프러시저입니다.

FORMSELECTOPTION 프러시저의 세부 내용은 다음과 같습니다.

프로토타입

HTP.FORMSELECTOPTION
(
    cvalue      IN VARCHAR2,
    cselected   IN VARCHAR2 DEFAULT NULL,
    cattributes IN VARCHAR2 DEFAULT NULL
)

파라미터

파라미터

설명

cvalue

선택할 문자열

cselected

SELECTED 속성의 값

cattributes

기타 속성 및 속성값들의 문자열

예제

“FORMSELECTOPEN” 예제를 참조합니다.

GET_PAGE

태그를 작성하는 프러시저가 아니라, 생성된 웹 페이지를 읽어옵니다.

GET_PAGE 프러시저의 세부 내용은 다음과 같습니다.

프로토타입

HTP.GET_PAGE
(
    page OUT NOCOPY CLOB
)

파라미터

파라미터

설명

page

생성된 웹 페이지를 읽어올 값

예제

DECLARE
    page CLOB;
BEGIN
    HTP.HTMLOPEN;
    HTP.HTMLCLOSE;

    htp.get_page(page);
    dbms_output.put_line(page);
END;

HEADCLOSE

</HEAD> 태그를 작성하는 프러시저입니다. </HEAD> 태그는 HTML 문서 중 머릿말의 끝을 의미합니다.

HEADCLOSE 프러시저의 세부 내용은 다음과 같습니다.

프로토타입

HTP.HEADCLOSE

예제

BEGIN
    HTP.HEADCLOSE;
END;

다음은 생성된 HTML 코드입니다.

</HEAD>

HEADER

헤더 시작 태그(<H1> ~ <H6>), 헤더 문자열 및 헤더 끝 태그(</H1> ~ </H6>)를 작성하는 프러시저입니다.

HEADER 프러시저의 세부 내용은 다음과 같습니다.

프로토타입

HTP.HEADER
(
    nsize      IN PLS_INTEGER,
    ctext       IN VARCHAR2,
    calign      IN VARCHAR2 DEFAULT NULL,
    cnowrap     IN VARCHAR2 DEFAULT NULL,
    cclear      IN VARCHAR2 DEFAULT NULL,
    cattributes IN VARCHAR2 DEFAULT NULL
)

파라미터

파라미터

설명

nsize

헤더의 레벨
값은 1~6의 범위를 지정할 수 있음

ctext

헤더에 표시되는 문자열

calign

ALIGN 속성의 값

cnowrap

NOWRAP 속성의 값

cclear

CLEAR 속성의 값

cattributes

기타 속성 및 값들의 문자열

예제

BEGIN
    HTP.HEADER(1, 'Tibero');
END;

다음은 생성된 HTML 코드입니다.

<H1>Tibero</H1>

HEADOPEN

<HEAD> 태그를 작성하는 프러시저입니다. <HEAD> 태그는 HTML 문서 중 머릿말의 시작을 의미합니다.

HEADOPEN 프러시저의 세부 내용은 다음과 같습니다.

프로토타입

HTP.HEADOPEN

예제

BEGIN
    HTP.HEADOPEN;
END;

다음은 생성된 HTML 코드입니다.

<HEAD>

HR

HTML 페이지에 가로줄을 그리는 <HR> 태그를 작성하는 프러시저입니다.

HR 프러시저의 세부 내용은 다음과 같습니다.

프로토타입

HTP.HR
(
    cclear      IN VARCHAR2 DEFAULT NULL,
    csrc        IN VARCHAR2 DEFAULT NULL,
    cattributes IN VARCHAR2 DEFAULT NULL
)

파라미터

파라미터

설명

cclear

CLEAR 속성의 값

csrc

가로줄의 바탕 그림 파일을 지정하는 SRC 속성의 값

cattributes

기타 속성 및 값들의 문자열

예제

BEGIN
    HTP.HR(csrc => '"/img/tibero.jpg"',
        cattributes => 'size="10" noshade style="color:gray;"');
END;

다음은 생성된 HTML 코드입니다.

<HR src="/img/tibero.jpg" size="10" noshade style="color:gray;">

HTMLCLOSE

</HTML> 태그를 작성하는 프러시저입니다. </HTML> 태그는 HTML 문서의 끝을 의미합니다.

HTMLCLOSE 프러시저의 세부 내용은 다음과 같습니다.

프로토타입

HTP.HTMLCLOSE

예제

BEGIN
    HTP.HTMLCLOSE;
END;

다음은 생성된 HTML 코드입니다.

</HTML>

HTMLOPEN

<HTML> 태그를 작성하는 프러시저입니다. <HTML> 태그는 HTML 문서의 시작을 의미합니다.

HTMLOPEN 프러시저의 세부 내용은 다음과 같습니다.

프로토타입

HTP.HTMLOPEN

예제

BEGIN
    HTP.HTMLOPEN;
END;

다음은 생성된 HTML 코드입니다.

<HTML>

IMG

HTML 페이지에 그림을 삽입하는 <IMG> 태그를 작성하는 프러시저입니다.

IMG 프러시저의 세부 내용은 다음과 같습니다.

프로토타입

HTP.IMG
(
    csrc        IN VARCHAR2,
    calign      IN VARCHAR2 DEFAULT NULL,
    calt        IN VARCHAR2 DEFAULT NULL,
    cismap      IN VARCHAR2 DEFAULT NULL,
    cattributes IN VARCHAR2 DEFAULT NULL
)

파라미터

파라미터

설명

csrc

그림 파일을 지정하는 SRC 속성의 값

calign

ALIGN 속성의 값

calt

웹 브라우저가 그림을 지원하지 않을 경우 대체할 문자열을 지정하는 ALT 속 성의 값

cismap

NULL이 아닐 경우 이미지맵임을 가리키는 ISMAP 속성이 부여됨

cattributes

기타 속성 및 값들의 문자열

예제

BEGIN
    HTP.IMG(csrc => '"/img/tibero.gif"',
         cattributes => 'WIDTH="200" HEIGHT="200" BORDER="1"');
END;

다음은 생성된 HTML 코드입니다.

<IMG src="/img/tibero.gif" WIDTH="200" HEIGHT="200" BORDER="1">

IMG2

HTML 페이지에 그림을 삽입하는 <IMG> 태그를 작성하는 프러시저입니다. IMG 프러시저에서 usemap 파 라미터만 추가된 프러시저입니다.

IMG2 프러시저의 세부 내용은 다음과 같습니다.

프로토타입

HTP.IMG2
(
    csrc        IN VARCHAR2,
    calign      IN VARCHAR2 DEFAULT NULL,
    calt        IN VARCHAR2 DEFAULT NULL,
    cismap      IN VARCHAR2 DEFAULT NULL,
    cusemap     IN VARCHAR2 DEFAULT NULL,
    cattributes IN VARCHAR2 DEFAULT NULL
)

파라미터

파라미터

설명

csrc

그림 파일을 지정하는 SRC 속성의 값

calign

ALIGN 속성의 값

calt

웹 브라우저가 그림을 지원하지 않을 경우 대체할 문자열을 지정하는 ALT 속 성의 값

cismap

NULL이 아닐 경우 이미지맵임을 가리키는 ISMAP 속성이 부여됨

cusemap

USEMAP 속성의 값

cattributes

기타 속성 및 값들의 문자열

예제

BEGIN
    HTP.IMG2(csrc => '"/img/tibero.gif"',
        cattributes => 'WIDTH="200" HEIGHT="200" BORDER="1"');
END;

다음은 생성된 HTML 코드입니다.

<IMG src="/img/tibero.gif" WIDTH="200" HEIGHT="200" BORDER="1">

LINE

HTML 페이지에 가로줄을 그리는 <HR> 태그를 작성하는 프러시저입니다. HR 프러시저와 똑같은 기능을 제공합니다.

LINE 프러시저의 세부 내용은 다음과 같습니다.

프로토타입

HTP.LINE
(
    cclear      IN VARCHAR2 DEFAULT NULL,
    csrc        IN VARCHAR2 DEFAULT NULL,
    cattributes IN VARCHAR2 DEFAULT NULL
)

파라미터

파라미터

설명

cclear

CLEAR 속성의 값

csrc

가로줄의 바탕 그림 파일을 지정하는 SRC 속성의 값

cattributes

기타 속성 및 값들의 문자열

예제

BEGIN
    HTP.LINE(csrc => '"/img/tibero.jpg"',
        cattributes => 'size="10" noshade style="color:gray;"');
END;

다음은 생성된 HTML 코드입니다.

<HR src="/img/tibero.jpg" size="10" noshade style="color:gray;">

PRINT

작성 진행 중인 HTML 소스 코드 뒤에 입력 문자열 및 \n(새줄 문자)을 작성하는 프러시저입니다. HTML 소스 코드상의 새줄의 의미이므로 실제 웹 페이지에서 새 줄을 추가하려면 <br> 태그를 작성해야 합니다.

PRINT 프러시저의 세부 내용은 다음과 같습니다.

프로토타입

HTP.PRINT
(
    cbuf IN VARCHAR2  DEFAULT NULL
)

파라미터

파라미터

설명

cbuf

HTML 소스 코드에 추가로 생성할 문자열

예제

BEGIN
    HTP.PRINT('<html>');
    HTP.PRINT('<head>');
    HTP.PRINT('</head>');
    HTP.PRINT('<body>');
    HTP.PRINT('He');
    HTP.PRINT('llo');  
    HTP.PRINT('</body>');
    HTP.PRINT('</html>');    
END;

다음은 생성된 HTML 코드입니다.

<html>
<head>
</head>
<body>
He
llo
</body>
</html>

PRN

작성 진행 중인 HTML 소스 코드 뒤에 입력 문자열을 작성하는 프러시저입니다. PRINT 프러시저와 다르게 \n(새줄 문자)가 붙지 않습니다.

PRN 프러시저의 세부 내용은 다음과 같습니다.

프로토타입

HTP.PRN
(
    cbuf IN VARCHAR2 DEFAULT NULL
)

파라미터

파라미터

설명

cbuf

HTML 소스 코드에 추가로 생성할 문자열

예제

BEGIN
    HTP.PRN('<html>');
    HTP.PRN('<head>');
    HTP.PRN('</head>');
    HTP.PRN('<body>');
    HTP.PRN('He');
    HTP.PRN('llo');  -- He 바로 뒤에 붙어 Hello가 된다. (생성되는 HTML 소스 코드상에서)
    HTP.PRN('</body>');
    HTP.PRN('</html>');    
END;

다음은 생성된 HTML 코드입니다.

<html><head></head><body>Hello</body></html>

TITLE

<TITLE> </TITLE> 태그 및 그 사이에 제목을 작성하는 프러시저입니다. <TITLE> 태그는 웹 브라우저 창에 서 제목 표시줄에 표시되는 문자열을 지정합니다.

TITLE 프러시저의 세부 내용은 다음과 같습니다.

프로토타입

HTP.TITLE
(
    ctitle IN VARCHAR2
)

파라미터

파라미터

설명

ctitle

제목 문자열

예제

BEGIN
    HTP.TITLE('Tibero');
END;

다음은 생성된 HTML 코드입니다.

<TITLE>Tibero</TITLE>

PreviousHTF NextOWA_UTIL

Last updated 17 days ago

hashtag개요

hashtagApache와의 연동

hashtag프러시저와 함수

hashtagBODYCLOSE

hashtagBODYOPEN

hashtagBR

hashtagCENTER

hashtagCENTERCLOSE

hashtagCENTEROPEN

hashtagFONTCLOSE

hashtagFONTOPEN

hashtagFORMSELECTCLOSE

hashtagFORMSELECTOPEN

hashtagFORMSELECTOPTION

hashtagGET_PAGE

hashtagHEADCLOSE

hashtagHEADER

hashtagHEADOPEN

hashtagHR

hashtagHTMLCLOSE

hashtagHTMLOPEN

hashtagIMG

hashtagIMG2

hashtagLINE

hashtagPRINT

hashtagPRN

hashtagTITLE

개요

Apache와의 연동

프러시저와 함수

BODYCLOSE

BODYOPEN

BR

CENTER

CENTERCLOSE

CENTEROPEN

FONTCLOSE

FONTOPEN

FORMSELECTCLOSE

FORMSELECTOPEN

FORMSELECTOPTION

GET_PAGE

HEADCLOSE

HEADER

HEADOPEN

HR

HTMLCLOSE

HTMLOPEN

IMG

IMG2

LINE

PRINT

PRN

TITLE