The Engine Container

Engine 엘리먼트는 특정 Catalina Service에 관련된 전체 요청처리장치(request processing machinery)를 나타냅니다. 이 장치는 Connectors에서 오는 모든 요청을 수신하고 처리하며, 처리된 응답을 해당 Connector로 돌려보내어, 최종 메시지를 클라이언트로 전달하게 합니다.

반드시 하나의 Engine 엘리먼트만이 Service에 중첩될 수 있으며, 이 Service에 연결된 모든 해당 Connector 엘리먼트 다음에 위치하게 됩니다.

공통 속성(Common Attributes)

Engine의 모든 구현체에서는 다음 속성을 지원합니다: 속성 설명 className 사용할 구현체의 Java 클래스명. 이 클래스는 반드시 org.apache.catalina.Engine를 구현해야 합니다. 지정하지 않으면 표준값(아래에 정의됨)이 사용됩니다. defaultHost 디폴트 호스트명. 설정 파일에서는 정의되지 않았지만 이 서버 상에 있는 호스트명 중에서 요청을 처리할 Host를 식별합니다. 이 이름은 반드시 바로 안에 중첩된 Host 엘리먼트 중 하나의 name 속성과 일치해야 합니다. jvmRoute 로드밸런싱 시나리오에서 세션유지를 위해서 반드시 사용해야 할 식별자. 이 식별자는 클러스터에 참가하는 모든 Tomcat 4 서버에 대해 반드시 유일해야 합니다. 생성되는 세션 식별자에는 이 식별자가 추가되어, 가장 앞단의 프록시가 특정 세션을 항상 같은 Tomcat 4 인스턴스로 포워드 할 수 있게 합니다. name 이 Engine의 논리적인 이름이며, 로그와 에러메시지에서 사용됩니다.

표준구현체(Standard Implementation)

Engine의 표준구현체는 org.apache.catalina.core.StandardEngine 입니다. 이 구현체는 위에 나열한 공통 속성외에도 다음과 같은 추가적인 속성을 제공합니다: 속성 설명 debug 이 Engine이 해당 Logger 에 디버깅 로그를 출력하는 상세수준을 의미합니다. 숫자가 높을 수록 더 자세한 출력을 생성합니다. 지정하지 않는 경우 디버깅 상세수준의 디폴트 값은 0 입니다.

이 Engine 엘리먼트 안에는 하나 이상의 Host를 중첩시킬 수 있습니다. 각 Host는 이 서버에 연관된 각기 다른 가상 호스트를 나타냅니다. Host는 최소한 하나 이상 존재해야 하며, 중첩된 Host 중 하나는 반드시 위에서 설명한 defaultHost에서 지정한 이름과 일치하는 name 속성을 가져야 합니다.

이 Engine 엘리먼트 내에는 하나의 DefaultContext 엘리먼트를 포함시켜서, 자동으로 배치(deploy)될 웹어플리케이션의 디폴트 특성을 정의할 수 있습니다.

다음 유틸리티 컴포넌트들은 Engine 엘리먼트 내에 각각 하나까지만 포함시킬 수 있습니다:

• Logger - 이 Engine에 대한 모든 로그 메시지를 받아서 처리할 로거(logger)를 설정합니다. 이 로거는 이 Engine 외에도 이 Engine이 정의된 Service의 Connectors로부터의 로그도 처리합니다. 또 이 로거는 하위에서 Logger 설정을 따로 하지 않는 경우, 하위의 Host와 Context에서의 로그도 처리합니다.
• Realm - 영역(realm)을 설정하여, 사용자와 사용자의 역할을 저장할 데이터베이스를 이 Engine에 포함된 모든 Host와 Context 에서 공유할 수 있도록 합니다. 하위에서 Realm 설정이 정의되면 여기의 설정은 무시됩니다.

액세스 로그(Access Logs)

웹서버를 운영할 때 일반적으로 생성되는 출력 파일중 하나가 액세스 로그(access log)입니다. 이 로그는 서버가 처리하는 각 요청마다 표준 포맷에 따라 한 라인씩 출력합니다. Catalina에서는 Valve 구현을 통해, 웹서버들이 표준 포맷에 따라 생성하는 액세스 로그와 같은 포맷의 로그를 생성할 수도 있고, 또는 다양한 커스텀 포맷으로 로그를 생성할 수 있도록 하고 있습니다. 당신은 Catalina에 Engine, Host, 또는 Context가 처리하는 모든 요청에 대한 액세스 로그를 생성하도록 지시할 수 있는데, 이는 다음과 같이 Valve 엘리먼트를 중첩시키면 됩니다: <Engine name="Standalone" ...> ... <Valve className="org.apache.catalina.valves.AccessLogValve" prefix="catalina_access_log." suffix=".txt" pattern="common"/> ... </Engine> 제공되는 설정 속성에 대한 더 많은 정보는 Access Log Valve에서 볼 수 있습니다.

생명주기 리스너(Lifecycle Listeners)

만약 이 Engine가 언제 시작되고 종료되는지 어떤 Java 객체가 알 필요가 있다면, 이 엘리먼트 안에 Listener 엘리먼트를 포함시켜서 그 Java 클래스명을 선언하면 됩니다. 이 때 지정하는 Java 클래스는 org.apache.catalina.LifecycleListener 인터페이스를 반드시 구현해야 하며, 해당 생명주기 이벤트 발생에 대해 통지를 받게 될 것입니다. 리스너의 설정은 다음과 같습니다: <Engine name="Standalone" ...> ... <Listener className="com.mycompany.mypackage.MyListener" ... > ... </Engine> Listener는 이 엘리먼트에 설정될 추가 프로퍼티를 얼마든지 가질 수 있음을 기억하십시오. 속성명은 표준 프로퍼티 메소드(getter/setter) 명명규칙을 사용하는 해당 JavaBean 속성명에 매칭됩니다.

요청필터(Request Filters)

어떤 Context, 또는 상위의 Engine, Host 엘리먼트에서 수신하는 모든 요청에 대해, IP 주소나 호스트명 등을 Catalina가 검사하도록 지시할 수 있습니다. 원격지 주소나 이름은 설정된 "허가(accept)" 그리고/또는 "거부(deny)" 리스트에 대해 검사하며, 이러한 설정은 Jakarta Regexp 정규표현식(regular expression) 라이브러리에 의해 지원되는 정규표현식 문법에 따라 정의됩니다. 허가되지 않은 위치에서 보낸 요청은 HTTP "Forbidden" 오류와 함께 거부됩니다. 필터 선언의 예는 다음과 같습니다: <Engine name="Standalone" ...> ... <Valve className="org.apache.catalina.valves.RemoteHostValve" allow="*.mycompany.com,www.yourcompany.com"/> <Valve className="org.apache.catalina.valves.RemoteAddrValve" deny="192.168.1.*"/> ... </Engine> 지원되는 설정 옵션에 대한 더 자세한 정보는 원격지 주소 필터(Remote Address Filter)와 원격 호스트 필터(Remote Host Filter)에서 볼 수 있습니다.