제10장 domain.xml의 웹 엔진내의 Virtual Host 설정

(129) `<domain> <servers> <server> <web-engine> <virtual-host>`
Description	도메인 이름을 기준으로 서로 같은 URL로 서로 다른 웹 애플리케이션을 서비스 할 수 있도록 설정한다. 같은 가상 호스트에 속한 도메인들은 같은 서비스가 가능하지만, 서로 다른 가상 호스트에 속한 도메인들은 같은 서비스를 할 수 없다.
Value Type	`virtual-hostType`
Child Elements	(130) `virtual-host-name` (131) `host-name+` (132) `encoding?` (140) `cookie-policy?` (144) `properties?` (148) `attach-stacktrace-on-error?` (149) `access-log?` (229) `pipeline?`

(130) `<domain> <servers> <server> <web-engine> <virtual-host> <virtual-host-name>`
Description	가상 호스트의 내부 식별 이름을 설정한다. DEFAULT_HOST와 SYSTEM_HOST는 예약어이므로 사용할 수 없다.
Value Type	`valuableToken`

(131) `<domain> <servers> <server> <web-engine> <virtual-host> <host-name>`
Description	DNS 이름(예, "www.foo.com") 또는 IP 주소를 포함한다. 필요에 따라서는 TCP 포트를 기술할 수 있다. (예, "www.foo.com:8088") 여기에 기술된 문자열은 웹 엔진 내에서 유일해야 한다.
Value Type	`valuableToken`

(132) `<domain> <servers> <server> <web-engine> <virtual-host> <encoding>`
Description	웹 애플리케이션의 요청이나 응답을 처리할 때 사용되는 Encoding을 설정한다.
Value Type	`webContainerEncodingType`
Child Elements	(133) `request-encoding?` (137) `response-encoding?`

(133) `<domain> <servers> <server> <web-engine> <virtual-host> <encoding> <request-encoding>`
Description	HTTP 요청을 읽을 때 적용할 Encoding을 지정한다. Socket에서 읽은 byte array(query strings, application/x-www-form-urlencoded 형식의 body 등)를 파싱해서 String 객체로 만들 때 적용한다.
Value Type	`requestEncodingType`
Child Elements	(134) `default` (135) `client-override` (136) `forced`

(134) `<domain> <servers> <server> <web-engine> <virtual-host> <encoding> <request-encoding> <default>`
Description	지정된 Encoding이 없을 경우 기본적으로 적용하는 값이다.
Value Description	표준 캐릭터 Encoding 값(e.g. UTF-8)
Value Type	`valuableToken`

(135) `<domain> <servers> <server> <web-engine> <virtual-host> <encoding> <request-encoding> <client-override>`
Description	지정된 Encoding이 없고, HTTP 클라이언트에서 보내는 Content-Type 헤더의 charset 속성을 치환하는 값이다. JEUS 6 이전 및 JEUS 7 Fix#1까지의 <forced> 설정을 대신한다.
Value Type	`valuableToken`

(136) `<domain> <servers> <server> <web-engine> <virtual-host> <encoding> <request-encoding> <forced>`
Description	지정된 Encoding이 있지만, 강제적으로 적용하는 값이다. 이 값은 애플리케이션의 모든 동작보다 우선 순위가 높다.
Value Description	표준 캐릭터 Encoding 값(e.g. UTF-8)
Value Type	`valuableToken`

(137) `<domain> <servers> <server> <web-engine> <virtual-host> <encoding> <response-encoding>`
Description	HTTP Response header에 "Content-type: text/html; charset=XXX"의 "XXX" 부분을 설정할 때 사용한다. JSP Page Encoding에도 적용한다. 컨테이너 내부적으로는 Servlet이 만든 String 객체를 버퍼에 저장하기 위해 byte array로 변환할 때 사용한다.
Value Type	`encodingSubType`
Child Elements	(138) `default` (139) `forced`

(138) `<domain> <servers> <server> <web-engine> <virtual-host> <encoding> <response-encoding> <default>`
Description	지정된 Encoding이 없을 경우 기본적으로 적용하는 값이다.
Value Description	표준 캐릭터 Encoding 값(e.g. UTF-8)
Value Type	`valuableToken`

(139) `<domain> <servers> <server> <web-engine> <virtual-host> <encoding> <response-encoding> <forced>`
Description	지정된 Encoding이 있지만, 강제적으로 적용하는 값이다. 이 값은 애플리케이션의 모든 동작보다 우선 순위가 높다.
Value Description	표준 캐릭터 Encoding 값(e.g. UTF-8)
Value Type	`valuableToken`

(140) `<domain> <servers> <server> <web-engine> <virtual-host> <cookie-policy>`
Description	HTTP header에서 쿠키를 읽고 쓸 때 적용할 정책을 설정한다. javax.servlet.http.Cookie API에 적용하는 설정이 아님을 주의한다.
Value Type	`httpCookiePolicyType`
Child Elements	(141) `write-value-on-header-policy?`

(141) `<domain> <servers> <server> <web-engine> <virtual-host> <cookie-policy> <write-value-on-header-policy>`
Description	Cookie Value를 HTTP header에서 읽고 쓸 때 URL Encoding Rule의 적용 여부를 설정한다.
Value Type	`write-value-on-header-policyType`
Child Elements	(142) `apply-url-encoding-rule?` (143) `charset-encoding?`

(142) `<domain> <servers> <server> <web-engine> <virtual-host> <cookie-policy> <write-value-on-header-policy> <apply-url-encoding-rule>`
Description	URL Encoding Rule 적용 여부를 설정한다.
Value Type	`boolean`

(143) `<domain> <servers> <server> <web-engine> <virtual-host> <cookie-policy> <write-value-on-header-policy> <charset-encoding>`
Description	URL Encoding Rule을 적용 여부에 상관없이 쿠키를 응답에 쓰거나 해석할 때 사용하는 Character Encoding이다. 설정하지 않을 경우 Request Encoding 및 Response Encoding 을 따른다.
Value Type	`valuableToken`

(144) `<domain> <servers> <server> <web-engine> <virtual-host> <properties>`
Description	가상호스트에 적용되는 속성을 설정한다.
Value Type	`propertiesType`
Child Elements	(145) `property*`

(145)

<domain> <servers> <server> <web-engine> <virtual-host> <properties> <property>

Value Type propertyType

Child Elements

(146) key

(147) value

(146) `<domain> <servers> <server> <web-engine> <virtual-host> <properties> <property> <key>`
Description	프로퍼티의 Key 값이다.
Value Type	`valuableToken`

(147) `<domain> <servers> <server> <web-engine> <virtual-host> <properties> <property> <value>`
Description	프로퍼티의 Value 값이다.
Value Type	`valuableToken`

(148) `<domain> <servers> <server> <web-engine> <virtual-host> <attach-stacktrace-on-error>`
Description	JEUS에서 보내주는 에러 페이지에 Stacktrace를 첨부할지를 설정한다. 개발 기간 동안에는 유용하지만 운영 환경에서는 비활성화해야 한다. 만약, 위의 Default Error Page 항목을 사용자가 설정하여 사용한다면 이 옵션은 무의미하다.
Value Description	Boolean 타입으로, 이 설정을 활성화 또는 비활성화한다.
Value Type	`boolean`

(149) `<domain> <servers> <server> <web-engine> <virtual-host> <access-log>`
Description	가상 호스트 레벨에서의 Access 로그를 설정한다. 기본적으로 가상 호스트마다 남기는 Access 로그는 웹 엔진 레벨의 Access 로그에도 남는다.
Value Type	`access-logType`
Child Elements	(150) `level?` (151) `use-parent-handlers?` (152) `filter-class?` (153) `formatter-pattern?` (154) `handler?` (225) `enable?` (226) `format?` (227) `exclude-ext?` (228) `enable-host-name-lookup?`

(150) `<domain> <servers> <server> <web-engine> <virtual-host> <access-log> <level>`
Dynamic	동적 변경이 가능하다.
Description	Logger의 레벨을 설정한다. 각 레벨의 의미는 Java SE Logging API의 "Level Class Documentation"을 참고한다.
Value Type	`loggingLevelType`
Default Value	`INFO`
Defined Value	`OFF` `SEVERE` `WARNING` `INFO` `CONFIG` `FINE` `FINER` `FINEST` `ALL`

(151) `<domain> <servers> <server> <web-engine> <virtual-host> <access-log> <use-parent-handlers>`
Dynamic	동적 변경이 가능하지만 JEUS 내부적으로 설정과 관계없이 설정해주는 부분(jeus logger, access logger)은 수정되지 않는다.
Description	상위 Logger의 핸들러를 이 Logger에서도 사용할지를 결정한다. 기본값은 true로 상위 Logger의 핸들러를 사용해서 로그 메시지를 출력한다. 단, "jeus" Logger의 경우는 Root Logger이기 때문에 false로 설정한다. 웹 액세스 로그의 경우, 웹 엔진 액세스 로거에서는 이 설정은 의미가 없다. 가상 호스트 별 액세스 로거에서는 이 설정을 false로 하면 웹 엔진 전체의 액세스 로그에 가상 호스트 별 액세스 로그를 남기지 않는다.
Value Type	`boolean`
Default Value	`true`

(152) `<domain> <servers> <server> <web-engine> <virtual-host> <access-log> <filter-class>`
Description	Logger에 지정할 필터 클래스의 Fully Qualified Class Name을 설정한다. 필터 클래스에 구현한 내용을 바탕으로 로그 메시지들이 필터링되어 출력된다.
Value Type	`valuableToken`
Example	`com.tmax.logging.filter.MyFilter`

(153) `<domain> <servers> <server> <web-engine> <virtual-host> <access-log> <formatter-pattern>`
Description	이 Logger의 핸들러가 출력하는 로그의 출력 패턴을 설정한다. 희망하는 로그의 출력 패턴을 지정하면 jeus.util.logging.PatternFormatter에서 해당 패턴을 바탕으로 로그 메시지를 Formatting하여 출력한다. 단, 입력 패턴에는 %를 형식 문자 입력 외에는 사용할 수 없다. 지원하는 형식 문자는 총 9가지(%d, %l, %J, %T, %c, %M, %N, %a, %m)이며 각 형식 문자의 의미는 "JEUS Server 안내서"의 "8.3. Logging 설정"을 참고한다.
Value Type	`valuableToken`
Default Value	`[%d{yyyy.MM.dd HH:mm:ss}][%l] [%J-%T] [%M-%N] %m`
Example	`[%d{yyyy.MM.dd HH:mm:ss:SSS}][%l] [%J-%T] [%M-%N] %m`

(154) `<domain> <servers> <server> <web-engine> <virtual-host> <access-log> <handler>`
Dynamic	동적으로 핸들러 추가가 가능하다.
Description	Logger에서 사용할 핸들러를 설정한다.
Value Type	`handlerType`
Child Elements	(155) `file-handler` (175) `smtp-handler` (195) `socket-handler` (206) `user-handler`

(155) `<domain> <servers> <server> <web-engine> <virtual-host> <access-log> <handler> <file-handler>`
Description	Logger를 파일로 출력하고자 할 경우에 사용하는 핸들러이다.
Value Type	`file-handlerType`
Child Elements	(156) `name` (157) `level?` (158) `encoding?` (159) `filter-class?` (160) `file-name?` (161) `permission?` (162) `chown?` (163) `enable-rotation?` (164) `rotation-count?` (165) `rotation-dir?` (166) `valid-day` (167) `valid-hour` (168) `valid-size` (169) `buffer-size?` (170) `append?`

(156) `<domain> <servers> <server> <web-engine> <virtual-host> <access-log> <handler> <file-handler> <name>`
Description	핸들러의 이름을 설정한다. 핸들러 이름은 하나의 Logger 내에서 유일해야 하며, 설정된 이름은 관리 도구(WebAdmin 등의 툴) 등에서 핸들러를 지칭할 때 사용한다.
Value Type	`valuableToken`
Example	`handler1`

(157) `<domain> <servers> <server> <web-engine> <virtual-host> <access-log> <handler> <file-handler> <level>`
Dynamic	동적 변경이 가능하다.
Description	핸들러의 레벨을 설정한다. Logger를 통과한 메시지의 레벨이 해당 핸들러 레벨에 포함될 경우에만 핸들러에 의해 출력된다.
Value Type	`loggingLevelType`
Default Value	`FINEST`
Defined Value	`OFF` `SEVERE` `WARNING` `INFO` `CONFIG` `FINE` `FINER` `FINEST` `ALL`

(158) `<domain> <servers> <server> <web-engine> <virtual-host> <access-log> <handler> <file-handler> <encoding>`
Description	핸들러가 메시지를 남길 때 사용할 Encoding을 설정한다.
Value Type	`valuableToken`

(159) `<domain> <servers> <server> <web-engine> <virtual-host> <access-log> <handler> <file-handler> <filter-class>`
Description	핸들러에 지정할 필터 클래스의 Fully Qualified Class Name을 설정한다. 필터 클래스에 구현한 내용을 바탕으로 로그 메시지들이 필터링되어서 출력된다.
Value Type	`valuableToken`
Example	`com.tmax.logging.filter.MyFilter`

(160) `<domain> <servers> <server> <web-engine> <virtual-host> <access-log> <handler> <file-handler> <file-name>`
Description	핸들러가 사용할 파일 이름을 설정한다. 만약, User가 이 설정을 하지 않으면 각 Logger의 Default File Name이 사용된다. 각각의 Default File Name은 "JEUS Server 안내서"를 참고한다.
Value Type	`token`
Example	`/home/jeus/logs/mylog.log`

(161) `<domain> <servers> <server> <web-engine> <virtual-host> <access-log> <handler> <file-handler> <permission>`
Description	Log 파일의 접근 권한 설정을 한다. 9자리의 r,w,x,-로 이루어진 log permission을 주도록 한다. (주의: Unix 계열의 OS에서만 유효한 옵션)
Value Type	`string`
Example	`rwxr-x---`

(162) `<domain> <servers> <server> <web-engine> <virtual-host> <access-log> <handler> <file-handler> <chown>`
Description	Log 파일의 소유자, 소유그룹 설정을 한다. ,(comma)로 구분하는 소유자와 소유그룹을 순서대로 주도록 한다.
Value Type	`string`
Example	`owner,group`

(163) `<domain> <servers> <server> <web-engine> <virtual-host> <access-log> <handler> <file-handler> <enable-rotation>`
Description	핸들러가 사용하는 파일이 Log File Rotation 기능을 사용할지 여부를 설정한다. 별도로 설정하지 않으면 true로 설정되고, 파일에 Logging할 때 Rotation 기능을 사용한다.
Value Description	Boolean 타입으로, 기본값은 true이다.
Value Type	`boolean`
Default Value	`true`
Example	`true`

(164) `<domain> <servers> <server> <web-engine> <virtual-host> <access-log> <handler> <file-handler> <rotation-count>`
Description	핸들러가 사용하는 파일이 Log File Rotation 기능을 사용할 때 백업할 파일의 개수를 설정한다. 만약, 설정하지 않고 File Size로 Rotation할 경우에는 99999개 까지 쌓이고, 날짜나 시간으로 Rotation할 경우에는 Rotation된 파일은 계속 쌓인다.
Value Type	`off-intType`
Value Type Description	기본적으로 Non Negative Int 타입이지만 -1인 경우에는 미설정 상태이다. 즉, off된다.
Example	`10`

(165) `<domain> <servers> <server> <web-engine> <virtual-host> <access-log> <handler> <file-handler> <rotation-dir>`
Description	핸들러가 사용하는 파일이 Log File Rotation 기능을 사용할 때 Rotation된 파일이 저장될 위치를 설정한다. 설정하지 않으면 현재 Logging을 하고 있는 파일의 디렉터리에 저장된다.
Value Type	`string`
Example	`/home/jeus/backup_logs`

(166) `<domain> <servers> <server> <web-engine> <virtual-host> <access-log> <handler> <file-handler> <valid-day>`
Description	핸들러가 사용하는 파일을 설정한 기간 동안만 사용하고 계속 갱신할 경우에 사용한다. 이 설정은 날짜 단위로 파일을 바꿀 때 사용한다. 이 경우 핸들러가 사용하는 파일 이름 뒤에 파일이 사용된 날짜가 자동으로 붙게 된다.
Value Description	날짜를 나타내는 값으로 정수이다. Valid Day, Valid Hour, Valid Size를 설정하지 않은 경우 Valid Day를 1로 설정한 것과 동일하게 동작한다.
Value Type	`off-intType`
Value Type Description	기본적으로 Non Negative Int 타입이지만 -1인 경우에는 미설정 상태이다. 즉, off된다.
Example	`1`

(167) `<domain> <servers> <server> <web-engine> <virtual-host> <access-log> <handler> <file-handler> <valid-hour>`
Description	핸들러가 사용하는 파일을 Valid Hour에 지정된 기간 동안만 사용하고 계속 갱신할 경우에 사용한다. 이 설정은 시간 단위로 파일을 바꿀 때 사용한다. 이 경우 핸들러가 사용하는 파일 이름 뒤에 파일이 사용된 날짜와 시간이 자동으로 붙게 된다.
Value Description	시간을 나타내는 값으로 정수이다.
Value Type	`off-intType`
Value Type Description	기본적으로 Non Negative Int 타입이지만 -1인 경우에는 미설정 상태이다. 즉, off된다.
Example	`3`

(168) `<domain> <servers> <server> <web-engine> <virtual-host> <access-log> <handler> <file-handler> <valid-size>`
Description	핸들러가 사용하는 파일이 Valid Size에 지정한 크기보다 작을 때까지만 사용하고 계속 갱신할 경우에 사용한다. 이 설정은 사이즈 단위로 파일을 바꿀 때 사용한다. 이 경우 핸들러가 사용하는 파일 이름 뒤에 순차적으로 Index가 붙게 된다.
Value Description	사이즈를 나타내며 단위는 kb이다.
Value Type	`off-intType`
Value Type Description	기본적으로 Non Negative Int 타입이지만 -1인 경우에는 미설정 상태이다. 즉, off된다.
Example	`1024`

(169) `<domain> <servers> <server> <web-engine> <virtual-host> <access-log> <handler> <file-handler> <buffer-size>`
Description	핸들러가 파일에 출력할 때 사용하는 Buffer의 크기를 지정한다.
Value Description	Byte 단위이고 기본값은 1024이다.
Value Type	`nonNegativeIntType`
Value Type Description	0 이상의 Int 값이다.
Default Value	`1024`
Performance Recommendation	이 값이 클수록 파일에 출력되는 메시지는 지연되어 출력되지만 Logging 성능은 좋아진다.

(170) `<domain> <servers> <server> <web-engine> <virtual-host> <access-log> <handler> <file-handler> <append>`
Description	핸들러가 사용하는 파일이 이미 존재하는 경우 파일 뒤에 덧붙여 사용할지를 결정한다. false로 설정되어 있다면 Enable Rotation이 true로 설정된 경우에는 Boot Time에 Rotation을 하고 Enable Rotation이 false로 설정된 경우에는 기존의 파일에 덮어쓴다.
Value Description	Boolean 타입이고, 기본값은 true이다.
Value Type	`file-handlerType`
Default Value	`true`
Child Elements	(171) `name` (172) `level?` (173) `encoding?` (174) `filter-class?`

(171) `<domain> <servers> <server> <web-engine> <virtual-host> <access-log> <handler> <file-handler> <append> <name>`
Description	핸들러의 이름을 설정한다. 핸들러 이름은 하나의 Logger 내에서 유일해야 하며, 설정된 이름은 관리 도구(WebAdmin 등의 툴) 등에서 핸들러를 지칭할 때 사용한다.
Value Type	`valuableToken`
Example	`handler1`

(172) `<domain> <servers> <server> <web-engine> <virtual-host> <access-log> <handler> <file-handler> <append> <level>`
Dynamic	동적 변경이 가능하다.
Description	핸들러의 레벨을 설정한다. Logger를 통과한 메시지의 레벨이 해당 핸들러 레벨에 포함될 경우에만 핸들러에 의해 출력된다.
Value Type	`loggingLevelType`
Default Value	`FINEST`
Defined Value	`OFF` `SEVERE` `WARNING` `INFO` `CONFIG` `FINE` `FINER` `FINEST` `ALL`

(173) `<domain> <servers> <server> <web-engine> <virtual-host> <access-log> <handler> <file-handler> <append> <encoding>`
Description	핸들러가 메시지를 남길 때 사용할 Encoding을 설정한다.
Value Type	`valuableToken`

(174) `<domain> <servers> <server> <web-engine> <virtual-host> <access-log> <handler> <file-handler> <append> <filter-class>`
Description	핸들러에 지정할 필터 클래스의 Fully Qualified Class Name을 설정한다. 필터 클래스에 구현한 내용을 바탕으로 로그 메시지들이 필터링되어서 출력된다.
Value Type	`valuableToken`
Example	`com.tmax.logging.filter.MyFilter`

(175) `<domain> <servers> <server> <web-engine> <virtual-host> <access-log> <handler> <smtp-handler>`
Description	Logger를 e-mail로 보내고자 할 경우에 사용하는 핸들러이다.
Value Type	`smtp-handlerType`
Performance Recommendation	하나의 로그 메시지가 하나의 e-mail로 전송되기 때문에 적절한 필터 없이 사용할 경우 엄청난 양의 e-mail을 전송하게 되므로 사용 시 주의가 필요하다.
Child Elements	(176) `name` (177) `level?` (178) `encoding?` (179) `filter-class?` (180) `smtp-host-address` (181) `sender-id` (182) `sender-password` (183) `from-address` (184) `to-address` (185) `property*` (188) `cc-address?` (189) `bcc-address?` (190) `send-for-all-messages?`

(176) `<domain> <servers> <server> <web-engine> <virtual-host> <access-log> <handler> <smtp-handler> <name>`
Description	핸들러의 이름을 설정한다. 핸들러 이름은 하나의 Logger 내에서 유일해야 하며, 설정된 이름은 관리 도구(WebAdmin 등의 툴) 등에서 핸들러를 지칭할 때 사용한다.
Value Type	`valuableToken`
Example	`handler1`

(177) `<domain> <servers> <server> <web-engine> <virtual-host> <access-log> <handler> <smtp-handler> <level>`
Dynamic	동적 변경이 가능하다.
Description	핸들러의 레벨을 설정한다. Logger를 통과한 메시지의 레벨이 해당 핸들러 레벨에 포함될 경우에만 핸들러에 의해 출력된다.
Value Type	`loggingLevelType`
Default Value	`FINEST`
Defined Value	`OFF` `SEVERE` `WARNING` `INFO` `CONFIG` `FINE` `FINER` `FINEST` `ALL`

(178) `<domain> <servers> <server> <web-engine> <virtual-host> <access-log> <handler> <smtp-handler> <encoding>`
Description	핸들러가 메시지를 남길 때 사용할 Encoding을 설정한다.
Value Type	`valuableToken`

(179) `<domain> <servers> <server> <web-engine> <virtual-host> <access-log> <handler> <smtp-handler> <filter-class>`
Description	핸들러에 지정할 필터 클래스의 Fully Qualified Class Name을 설정한다. 필터 클래스에 구현한 내용을 바탕으로 로그 메시지들이 필터링되어서 출력된다.
Value Type	`valuableToken`
Example	`com.tmax.logging.filter.MyFilter`

(180) `<domain> <servers> <server> <web-engine> <virtual-host> <access-log> <handler> <smtp-handler> <smtp-host-address>`
Description	e-mail을 보낼 SMTP 서버의 주소를 지정한다.
Value Type	`valuableToken`

(181) `<domain> <servers> <server> <web-engine> <virtual-host> <access-log> <handler> <smtp-handler> <sender-id>`
Description	e-mail을 보낼 sender의 id를 지정한다.
Value Type	`valuableToken`

(182) `<domain> <servers> <server> <web-engine> <virtual-host> <access-log> <handler> <smtp-handler> <sender-password>`
Description	e-mail을 보낼 sender의 password를 지정한다. 암호화해서 저장할 때에는 '{암호화할 알고리듬}암호화된 password'와 같은 형식으로 입력한다.
Value Type	`valuableToken`
Example	`{DES}FQrLbQ/D8O1lDVS71L28rw==`

(183) `<domain> <servers> <server> <web-engine> <virtual-host> <access-log> <handler> <smtp-handler> <from-address>`
Description	e-mail을 보내는 사람의 주소를 지정한다.
Value Type	`valuableToken`

(184) `<domain> <servers> <server> <web-engine> <virtual-host> <access-log> <handler> <smtp-handler> <to-address>`
Description	e-mail을 받는 사람의 주소를 지정한다.
Value Type	`valuableToken`

(185) `<domain> <servers> <server> <web-engine> <virtual-host> <access-log> <handler> <smtp-handler> <property>`
Description	이용하는 mail서버에 특정한 smtp 프로퍼티를 지정한다. schema에 명시된 property와 겹치는 경우에는 schema의 값을 따른다.
Value Type	`propertyType`
Child Elements	(186) `key` (187) `value`

(186) `<domain> <servers> <server> <web-engine> <virtual-host> <access-log> <handler> <smtp-handler> <property> <key>`
Description	프로퍼티의 Key 값이다.
Value Type	`valuableToken`

(187) `<domain> <servers> <server> <web-engine> <virtual-host> <access-log> <handler> <smtp-handler> <property> <value>`
Description	프로퍼티의 Value 값이다.
Value Type	`valuableToken`

(188) `<domain> <servers> <server> <web-engine> <virtual-host> <access-log> <handler> <smtp-handler> <cc-address>`
Description	e-mail을 참조로 받는 사람의 주소를 지정한다.
Value Type	`valuableToken`

(189) `<domain> <servers> <server> <web-engine> <virtual-host> <access-log> <handler> <smtp-handler> <bcc-address>`
Description	e-mail을 숨은 참조로 받는 사람의 주소를 지정한다.
Value Type	`valuableToken`

(190) `<domain> <servers> <server> <web-engine> <virtual-host> <access-log> <handler> <smtp-handler> <send-for-all-messages>`
Description	핸들러로 들어왔을 때 이를 e-mail로 보낼 대상으로 여길지를 설정한다. false로 설정되어 있으면 Logger의 특별한 send() 메소드로 호출된 메시지들만 e-mail로 전송된다. 즉, 처음부터 e-mail로 보낼 의도로 지정된 메시지들만 e-mail로 전송된다.
Value Type	`smtp-handlerType`
Default Value	`false`
Child Elements	(191) `name` (192) `level?` (193) `encoding?` (194) `filter-class?`

(191) `<domain> <servers> <server> <web-engine> <virtual-host> <access-log> <handler> <smtp-handler> <send-for-all-messages> <name>`
Description	핸들러의 이름을 설정한다. 핸들러 이름은 하나의 Logger 내에서 유일해야 하며, 설정된 이름은 관리 도구(WebAdmin 등의 툴) 등에서 핸들러를 지칭할 때 사용한다.
Value Type	`valuableToken`
Example	`handler1`

(192) `<domain> <servers> <server> <web-engine> <virtual-host> <access-log> <handler> <smtp-handler> <send-for-all-messages> <level>`
Dynamic	동적 변경이 가능하다.
Description	핸들러의 레벨을 설정한다. Logger를 통과한 메시지의 레벨이 해당 핸들러 레벨에 포함될 경우에만 핸들러에 의해 출력된다.
Value Type	`loggingLevelType`
Default Value	`FINEST`
Defined Value	`OFF` `SEVERE` `WARNING` `INFO` `CONFIG` `FINE` `FINER` `FINEST` `ALL`

(193) `<domain> <servers> <server> <web-engine> <virtual-host> <access-log> <handler> <smtp-handler> <send-for-all-messages> <encoding>`
Description	핸들러가 메시지를 남길 때 사용할 Encoding을 설정한다.
Value Type	`valuableToken`

(194) `<domain> <servers> <server> <web-engine> <virtual-host> <access-log> <handler> <smtp-handler> <send-for-all-messages> <filter-class>`
Description	핸들러에 지정할 필터 클래스의 Fully Qualified Class Name을 설정한다. 필터 클래스에 구현한 내용을 바탕으로 로그 메시지들이 필터링되어서 출력된다.
Value Type	`valuableToken`
Example	`com.tmax.logging.filter.MyFilter`

(195) `<domain> <servers> <server> <web-engine> <virtual-host> <access-log> <handler> <socket-handler>`
Description	Logger를 지정된 소켓으로 보내고자 할 경우에 사용하는 핸들러이다.
Value Type	`socket-handlerType`
Performance Recommendation	하나의 Logging 메시지가 하나의 소켓으로 전송되므로 적절한 필터 없이 사용하는 것은 성능 저하를 가져온다.
Child Elements	(196) `name` (197) `level?` (198) `encoding?` (199) `filter-class?` (200) `address` (201) `port`

(196) `<domain> <servers> <server> <web-engine> <virtual-host> <access-log> <handler> <socket-handler> <name>`
Description	핸들러의 이름을 설정한다. 핸들러 이름은 하나의 Logger 내에서 유일해야 하며, 설정된 이름은 관리 도구(WebAdmin 등의 툴) 등에서 핸들러를 지칭할 때 사용한다.
Value Type	`valuableToken`
Example	`handler1`

(197) `<domain> <servers> <server> <web-engine> <virtual-host> <access-log> <handler> <socket-handler> <level>`
Dynamic	동적 변경이 가능하다.
Description	핸들러의 레벨을 설정한다. Logger를 통과한 메시지의 레벨이 해당 핸들러 레벨에 포함될 경우에만 핸들러에 의해 출력된다.
Value Type	`loggingLevelType`
Default Value	`FINEST`
Defined Value	`OFF` `SEVERE` `WARNING` `INFO` `CONFIG` `FINE` `FINER` `FINEST` `ALL`

(198) `<domain> <servers> <server> <web-engine> <virtual-host> <access-log> <handler> <socket-handler> <encoding>`
Description	핸들러가 메시지를 남길 때 사용할 Encoding을 설정한다.
Value Type	`valuableToken`

(199) `<domain> <servers> <server> <web-engine> <virtual-host> <access-log> <handler> <socket-handler> <filter-class>`
Description	핸들러에 지정할 필터 클래스의 Fully Qualified Class Name을 설정한다. 필터 클래스에 구현한 내용을 바탕으로 로그 메시지들이 필터링되어서 출력된다.
Value Type	`valuableToken`
Example	`com.tmax.logging.filter.MyFilter`

(200) `<domain> <servers> <server> <web-engine> <virtual-host> <access-log> <handler> <socket-handler> <address>`
Description	핸들러가 생성될 때 메시지들을 보낼 곳의 IP 주소를 설정한다.
Value Type	`valuableToken`

(201) `<domain> <servers> <server> <web-engine> <virtual-host> <access-log> <handler> <socket-handler> <port>`
Description	핸들러가 생성될 때 메시지들을 보낼 곳의 포트 번호를 설정한다.
Value Type	`socket-handlerType`
Value Type Description	0 이상의 Int 값이다.
Child Elements	(202) `name` (203) `level?` (204) `encoding?` (205) `filter-class?`

(202) `<domain> <servers> <server> <web-engine> <virtual-host> <access-log> <handler> <socket-handler> <port> <name>`
Description	핸들러의 이름을 설정한다. 핸들러 이름은 하나의 Logger 내에서 유일해야 하며, 설정된 이름은 관리 도구(WebAdmin 등의 툴) 등에서 핸들러를 지칭할 때 사용한다.
Value Type	`valuableToken`
Example	`handler1`

(203) `<domain> <servers> <server> <web-engine> <virtual-host> <access-log> <handler> <socket-handler> <port> <level>`
Dynamic	동적 변경이 가능하다.
Description	핸들러의 레벨을 설정한다. Logger를 통과한 메시지의 레벨이 해당 핸들러 레벨에 포함될 경우에만 핸들러에 의해 출력된다.
Value Type	`loggingLevelType`
Default Value	`FINEST`
Defined Value	`OFF` `SEVERE` `WARNING` `INFO` `CONFIG` `FINE` `FINER` `FINEST` `ALL`

(204) `<domain> <servers> <server> <web-engine> <virtual-host> <access-log> <handler> <socket-handler> <port> <encoding>`
Description	핸들러가 메시지를 남길 때 사용할 Encoding을 설정한다.
Value Type	`valuableToken`

(205) `<domain> <servers> <server> <web-engine> <virtual-host> <access-log> <handler> <socket-handler> <port> <filter-class>`
Description	핸들러에 지정할 필터 클래스의 Fully Qualified Class Name을 설정한다. 필터 클래스에 구현한 내용을 바탕으로 로그 메시지들이 필터링되어서 출력된다.
Value Type	`valuableToken`
Example	`com.tmax.logging.filter.MyFilter`

(206) `<domain> <servers> <server> <web-engine> <virtual-host> <access-log> <handler> <user-handler>`
Description	User가 Java SE Logging API에 따라 생성한 핸들러를 사용할 경우의 설정이다.
Value Type	`user-handlerType`
Child Elements	(207) `name` (208) `level?` (209) `encoding?` (210) `filter-class?` (211) `handler-class` (212) `handler-property?` (216) `formatter-pattern?` (217) `formatter-property?`

(207) `<domain> <servers> <server> <web-engine> <virtual-host> <access-log> <handler> <user-handler> <name>`
Description	핸들러의 이름을 설정한다. 핸들러 이름은 하나의 Logger 내에서 유일해야 하며, 설정된 이름은 관리 도구(WebAdmin 등의 툴) 등에서 핸들러를 지칭할 때 사용한다.
Value Type	`valuableToken`
Example	`handler1`

(208) `<domain> <servers> <server> <web-engine> <virtual-host> <access-log> <handler> <user-handler> <level>`
Dynamic	동적 변경이 가능하다.
Description	핸들러의 레벨을 설정한다. Logger를 통과한 메시지의 레벨이 해당 핸들러 레벨에 포함될 경우에만 핸들러에 의해 출력된다.
Value Type	`loggingLevelType`
Default Value	`FINEST`
Defined Value	`OFF` `SEVERE` `WARNING` `INFO` `CONFIG` `FINE` `FINER` `FINEST` `ALL`

(209) `<domain> <servers> <server> <web-engine> <virtual-host> <access-log> <handler> <user-handler> <encoding>`
Description	핸들러가 메시지를 남길 때 사용할 Encoding을 설정한다.
Value Type	`valuableToken`

(210) `<domain> <servers> <server> <web-engine> <virtual-host> <access-log> <handler> <user-handler> <filter-class>`
Description	핸들러에 지정할 필터 클래스의 Fully Qualified Class Name을 설정한다. 필터 클래스에 구현한 내용을 바탕으로 로그 메시지들이 필터링되어서 출력된다.
Value Type	`valuableToken`
Example	`com.tmax.logging.filter.MyFilter`

(211) `<domain> <servers> <server> <web-engine> <virtual-host> <access-log> <handler> <user-handler> <handler-class>`
Description	User가 생성한 핸들러의 Fully Qualified Class Name을 설정한다.이 클래스는 java.util.logging.Handler를 상속받고 jeus.util.logging.JeusHandler를 구현해야 한다.
Value Type	`valuableToken`
Example	`com.tmax.logging.handler.MyHandler`

(212) `<domain> <servers> <server> <web-engine> <virtual-host> <access-log> <handler> <user-handler> <handler-property>`
Description	핸들러가 생성될 때 넘겨줄 프로퍼티를 설정한다. 이 프로퍼티들은 Key Value로 Map 객체에 저장되어 JeusHandler.setProperty() 메소드를 통해 핸들러로 전달된다.
Value Type	`handlerPropertySetType`
Child Elements	(213) `property*`

(213) `<domain> <servers> <server> <web-engine> <virtual-host> <access-log> <handler> <user-handler> <handler-property> <property>`
Description	핸들러 등에게 전달할 프로퍼티들을 설정한다.
Value Type	`propertyType`
Child Elements	(214) `key` (215) `value`

(214) `<domain> <servers> <server> <web-engine> <virtual-host> <access-log> <handler> <user-handler> <handler-property> <property> <key>`
Description	프로퍼티의 Key 값이다.
Value Type	`valuableToken`

(215) `<domain> <servers> <server> <web-engine> <virtual-host> <access-log> <handler> <user-handler> <handler-property> <property> <value>`
Description	프로퍼티의 Value 값이다.
Value Type	`valuableToken`

(216) `<domain> <servers> <server> <web-engine> <virtual-host> <access-log> <handler> <user-handler> <formatter-pattern>`
Description	이 Logger의 핸들러가 출력하는 로그의 출력 패턴을 설정한다. 희망하는 로그의 출력 패턴을 지정하면 jeus.util.logging.PatternFormatter에서 해당 패턴을 바탕으로 로그 메시지를 Formatting하여 출력한다.
Value Type	`valuableToken`
Default Value	`[%d{yyyy.MM.dd HH:mm:ss}][%l] [%J-%T] [%M-%N] %m`
Example	`[%d{yyyy.MM.dd HH:mm:ss.SSS}][%l] [%J-%T] [%M-%N] %m`

(217) `<domain> <servers> <server> <web-engine> <virtual-host> <access-log> <handler> <user-handler> <formatter-property>`
Description	핸들러가 생성될 때 함께 생성된 Formatter에게 넘겨줄 프로퍼티를 설정한다. 이 프로퍼티들은 Key Value로 Map 객체에 저장되어 JeusFormatter.setProperty() 메소드를 통해 Formatter로 전달된다.
Value Type	`handlerPropertySetType`
Child Elements	(218) `property*`

(218) `<domain> <servers> <server> <web-engine> <virtual-host> <access-log> <handler> <user-handler> <formatter-property> <property>`
Description	핸들러 등에게 전달할 프로퍼티들을 설정한다.
Value Type	`propertyType`
Child Elements	(219) `key` (220) `value`

(219) `<domain> <servers> <server> <web-engine> <virtual-host> <access-log> <handler> <user-handler> <formatter-property> <property> <key>`
Description	프로퍼티의 Key 값이다.
Value Type	`valuableToken`

(220) `<domain> <servers> <server> <web-engine> <virtual-host> <access-log> <handler> <user-handler> <formatter-property> <property> <value>`
Description	프로퍼티의 Value 값이다.
Value Type	`user-handlerType`
Child Elements	(221) `name` (222) `level?` (223) `encoding?` (224) `filter-class?`

(221) `<domain> <servers> <server> <web-engine> <virtual-host> <access-log> <handler> <user-handler> <formatter-property> <property> <value> <name>`
Description	핸들러의 이름을 설정한다. 핸들러 이름은 하나의 Logger 내에서 유일해야 하며, 설정된 이름은 관리 도구(WebAdmin 등의 툴) 등에서 핸들러를 지칭할 때 사용한다.
Value Type	`valuableToken`
Example	`handler1`

(222) `<domain> <servers> <server> <web-engine> <virtual-host> <access-log> <handler> <user-handler> <formatter-property> <property> <value> <level>`
Dynamic	동적 변경이 가능하다.
Description	핸들러의 레벨을 설정한다. Logger를 통과한 메시지의 레벨이 해당 핸들러 레벨에 포함될 경우에만 핸들러에 의해 출력된다.
Value Type	`loggingLevelType`
Default Value	`FINEST`
Defined Value	`OFF` `SEVERE` `WARNING` `INFO` `CONFIG` `FINE` `FINER` `FINEST` `ALL`

(223) `<domain> <servers> <server> <web-engine> <virtual-host> <access-log> <handler> <user-handler> <formatter-property> <property> <value> <encoding>`
Description	핸들러가 메시지를 남길 때 사용할 Encoding을 설정한다.
Value Type	`valuableToken`

(224) `<domain> <servers> <server> <web-engine> <virtual-host> <access-log> <handler> <user-handler> <formatter-property> <property> <value> <filter-class>`
Description	핸들러에 지정할 필터 클래스의 Fully Qualified Class Name을 설정한다. 필터 클래스에 구현한 내용을 바탕으로 로그 메시지들이 필터링되어서 출력된다.
Value Type	`valuableToken`
Example	`com.tmax.logging.filter.MyFilter`

(225) `<domain> <servers> <server> <web-engine> <virtual-host> <access-log> <enable>`
Dynamic	동적으로 Access 로그 사용 여부를 설정할 수 있다.
Description	Access 로그 사용 여부를 설정한다. 가상 호스트 별 액세스 로그의 경우 이 값을 false로 하면 웹 엔진 액세스 로거를 사용한다. 웹 엔진 액세스 로거의 경우 이 값을 false로 하면 액세스 로그를 남기지 않는다.
Value Type	`boolean`
Default Value	`true`

(226) `<domain> <servers> <server> <web-engine> <virtual-host> <access-log> <format>`
Dynamic	동적으로 Access 로그의 포맷을 변경할 수 있다.
Description	Apache 에서 정의한 Common Log Format을 설정한다. default, common, combined, debug 의 Aliases가 있다. default는 common 형식에 요청 처리 시간(%D)를 추가한 것이다. common, combined는 Apache에서 많이 사용하는 형식을 Alias한 것이고, debug는 default 형식에 Session ID, 요청 스레드 이름이 추가되었다. 만약 JEUS 6 이전 버전의 포맷을 사용하고 싶은 경우에는 6deprecated 로 설정한다. 단, 이 포맷은 동적으로 변경되지 않는다.
Value Type	`token`
Default Value	`default`

(227) `<domain> <servers> <server> <web-engine> <virtual-host> <access-log> <exclude-ext>`
Dynamic	동적으로 Access 로그 제외 확장자를 변경할 수 있다.
Description	Access 로그를 남기지 않는 확장자들을 설정한다. 여러 개를 입력하고 싶은 경우 콤마(,)로 구분한다.
Value Type	`valuableToken`

(228) `<domain> <servers> <server> <web-engine> <virtual-host> <access-log> <enable-host-name-lookup>`
Dynamic	동적으로 호스트 이름 로깅 여부를 변경할 수 있다.
Description	%h 포맷에 대해 IP 주소 대신 호스트 이름을 로깅할 것인지 결정한다. 이값을 true로 할 경우 DNS lookup으로 인한 오버헤드가 발생할 수 있다.
Value Type	`boolean`
Default Value	`false`

(229) `<domain> <servers> <server> <web-engine> <virtual-host> <pipeline>`
Description	가상호스트 단위의 필터설정이다. 애플리케이션이 실행되기 전에 거쳐간다. web-engine 설정이 적용된 이후에 적용된다. 자세한 내용은 매뉴얼의 valve 항목을 참고한다.
Value Type	`pipelineType`
Child Elements	(230) `valve*`

(230) `<domain> <servers> <server> <web-engine> <virtual-host> <pipeline> <valve>`
Description	서버, 가상호스트 혹은 컨텍스트 별로 valve를 적용하고 싶을 때, 적용하는 설정이다.
Value Type	`valveType`
Child Elements	(231) `class-name` (232) `property*`

(231) `<domain> <servers> <server> <web-engine> <virtual-host> <pipeline> <valve> <class-name>`
Description	서버, 가상호스트 혹은 컨텍스트에 적용할 valve class를 지정한다.
Value Description	제우스의 ValveBase를 상속받은 클래스
Value Type	`token`

(232) `<domain> <servers> <server> <web-engine> <virtual-host> <pipeline> <valve> <property>`
Description	valve에 적용할 property를 지정한다.
Value Description	매뉴얼에서 안내하고 있는 key, value
Value Type	`propertyType`
Child Elements	(233) `key` (234) `value`

(233) `<domain> <servers> <server> <web-engine> <virtual-host> <pipeline> <valve> <property> <key>`
Description	프로퍼티의 Key 값이다.
Value Type	`valuableToken`

(234) `<domain> <servers> <server> <web-engine> <virtual-host> <pipeline> <valve> <property> <value>`
Description	프로퍼티의 Value 값이다.
Value Type	`valuableToken`

제10장 domain.xml의 웹 엔진내의 Virtual Host 설정

10.1. 소개

10.2. XML Schema/XML 트리

10.3. Element Reference

10.4. 웹 엔진 내의 Virtual Host domain.xml 파일 예제