제5장 domain.xml의 웹/서블릿 엔진 설정

내용 목차

5.1. 소개
5.2. XML Schema/XML 트리
5.3. Element Reference
5.4. domain.xml의 웹 엔진 예제

여기에서 JEUS의 domain.xml에 설정되는 웹/서블릿 엔진 설정파일의 설명을 찾을 수 있다.

레퍼런스는 다음 형식으로 구성되어 있다.

  1. XML Schema/XML 트리: XML 설정 파일의 모든 태그 리스트를 정리했다. 각 노드의 형식은 다음과 같다.

    1. 태그 레퍼런스로 빨리 찾아보기 위해서 각 태그마다 인덱스 번호( 예: (11) )를 붙여 놓았다. 태그 레퍼런스에서는 이 번호 순서로 설명한다.

    2. XML Schema에서 정의한 XML 태그명을 <tag name> 형식으로 표시한다.

    3. XML Schema에서 정의한 Cardinality를 표시한다. “?” = 0개나 1개의 element, “+” = 1개 이상의 element, “*” = 0개 이상의 element, (기호가 없음) = 정확히 1개의 element

    4. 몇몇 태그에는 “P” 문자를 붙여 놓았는데, 해당 태그는 성능에 관계되는 태그라는 것을 뜻한다. 이 태그는 설정을 튜닝할 때 사용된다.

  2. Element Reference: 트리에 있는 각 XML 태그를 설명한다.

    1. Dynamic: 동적 설정 반영 가능

    2. Non-Dynamic: 동적 설정 반영 불가능, Dynamic이 설정되지 않은 항목들이 보통 이에 해당 하나 특별히 설명이 있는 경우 이 항목이 표시된다.

    3. Description: 태그에 대한 간단한 설명.

    4. Value Description: 입력하는 값과 타입.

    5. Value Type: 값의 데이터 타입. (예: String)

    6. Value Type Description: 값의 데이터 타입에 대한 설명

    7. Default Value: 해당 XML을 사용하지 않았을 때 기본적으로 사용되는 값.

    8. Defined Value: 이미 정해져 있는 값.

    9. Example: 해당 XML 태그에 대한 예.

    10. Performance Recommendation: 성능 향상을 위해서 추천하는 값.

    11. Child Elements: 자신의 태그 안에 사용하는 태그.

(85) < domain >< servers >< server > <web-engine>
Description 웹 엔진은 J2EE Web/Servlet 애플리케이션이 작동하기 위한 환경을 제공한다. J2EE 스펙에서의 웹 컨테이너에 대응하는 기능이다. 서버가 부팅될 때 실행되며, 하나의 서버에서는 하나의 웹 엔진만 지원한다.
Value Type web-containerType
Child Elements

(87) default-error-page

(88) response-header

(93) encoding

(104) cookie-policy

(108) properties

(112) jsp-engine

(122) attach-stacktrace-on-error

(123) virtual-host

(226) web-connections

(406) monitoring

(410) access-log

(474) session-config

(494) async-timeout-min-threads

(495) blocked-url-patterns

(500) pipeline

[예 5.1] domain.xml의 웹 엔진 예제

<?xml version="1.0"?>
<domain xmlns="http://www.tmaxsoft.com/xml/ns/jeus">
    <servers>
        <server>
            <web-engine>
                <!-- define custom header on HTTP response in current web engine -->
                <response-header>
                    <custom-header>
                        <header-field>
                            <field-name>TestHeader</field-name>
                            <field-value>This is a test header value</field-value>
                        </header-field>
                        ...
                        <header-field>
                            ...
                        </header-field>
                    </custom-header>
                </response-header>
            
                <!-- refer to another chapter -->
                <!--
                <encoding>
                    ...
                </encoding>

                <jsp-engine>
                    ...
                </jsp-engine>
                -->
            
                <!-- set default-error-page -->
                <default-error-page>/home/errorpage/error.html</default-error-page>
            
                <!-- determine whether attach stacktrace on jeus error page or not -->
                <attach-stacktrace-on-error>false</attach-stacktrace-on-error>
            
                <!-- refer to another chapter -->
                <!--
                <virtual-host>
            		...
            	</virtual-host>

                <web-connections>
                    ...
                </web-connections>
                -->
            
                <monitoring>
                    <!-- thread check interval(checking idle, block threads, etc...) -->
                    <check-thread-pool>60000</check-thread-pool>
                    <!-- reload check interval -->
                    <check-class-reload>60000</check-class-reload>
                    <!-- session check interval(checking session's timeout, session server,
                         etc...) -->
                    <check-session>60000</check-session>
                </monitoring>

                <!-- access log for web engine : Common Log Format -->
                <access-log>
                    <enable>true</enable>
                    <format>common</format>
                    <handler>
                        <file-handler>
                            <name>fileHandler</name>
                        </file-handler>
                    </handler>
                </access-log>
            
                <!-- properties for web engine -->
                <properties>
                    <property>
                        <key>myKey</key>
                        <value>myValue</value>
                    </property>
                </properties>
            
                <!-- refer to another chapter -->
                <!--
                <session-config>
                    ...
                </session-config>
                -->
            
                <!-- set the minimum threads to process timeout event
                     of asynchrous processing -->
                <async-timeout-min-threads>1</async-timeout-min-threads>
            </web-engine>
        </server>
    </servers>
</domain>