The Apache Tomcat Servlet/JSP Container

아파치 톰캣 7

Version 7.0.28-dev, Oct 2 2013
Apache Logo

Links

Top Level Elements

Executors

Connectors

Containers

Nested Components

Cluster Elements

Other

The Engine Container

Table of Contents
Introduction

The Engine element represents the entire request processing machinery associated with a particular Catalina Service. It receives and processes all requests from one or more Connectors, and returns the completed response to the Connector for ultimate transmission back to the client.

엔진 요소는 특정 카탈리 서비스와 관련된 전체 요청 처리 기계를 나타냅니다.   그것은 받아서 처리하는 모든 요청을 하나 이상의 커넥터에서, 그리고 클라이언트에 궁극적인 전송 다시위한 커넥터로 완성된 응답을 반환합니다.

Exactly one Engine element MUST be nested inside a Service element, following all of the corresponding Connector elements associated with this Service.

정확히 하나의 엔진 요소는 본 서비스와 관련된 해당 커넥터 모든 요소 따라 서비스 요소 내부에 중첩해야합니다.
Attributes
Common Attributes

All implementations of Engine support the following attributes:

엔진의 모든 구현은 다음과 같은 속성을 지원합니다
AttributeDescription
backgroundProcessorDelay

This value represents the delay in seconds between the invocation of the backgroundProcess method on this engine and its child containers, including all hosts and contexts. 이 값은이 엔진에 backgroundProcess 메서드의 호출하고 모든 호스트와 상황 등 아동 용기, 사이 초 지연을 나타냅니다. Child containers will not be invoked if their delay value is not negative (which would mean they are using their own processing thread). Setting this to a positive value will cause a thread to be spawn. 그들의 지연 값 (어떤 사람들이 자신의 프로세싱 스레드를 사용하는 의미가) 음수가 아닌 경우 child 컨테이너가 호출되지 않습니다. 긍정적인 가치로 설정하면 스레드가 자녀로 하게됩니다. After waiting the specified amount of time, the thread will invoke the backgroundProcess method on this engine and all its child containers. 시간의 지정된 금액을 기다리고 후, 스레드는이 엔진과 모든 자식 컨테이너에 backgroundProcess 메서드를 호출합니다. If not specified, the default value for this attribute is 10, which represent a 10 seconds delay.

지정하지 않으면이 속성의 기본값은 10입니다 이는 10 초 지연을 나타냅니다.
className

Java class name of the implementation to use. This class must implement the org.apache.catalina. Engine interface. If not specified, the standard value (defined below) will be used. 사용하는 구현의 Java 클래스 이름. 이 클래스에 org.apache.catalina.Engine 인터페이스를 구현해야합니다. 지정하지 않으면 표준 값(아래 정의된)이 사용됩니다.

defaultHost

The default host name, which identifies the Host that will process requests directed to host names on this server, but which are not configured in this configuration file. 이 서버에서 이름을 호스트에 지시 요청을 처리되지만이 구성 파일에 구성되어 있지되는 호스트를 식별하는 기본 호스트 이름. This name MUST match the name attributes of one of the Host elements nested immediately inside.

이 이름은 바로 안에 중첩된 호스트 요소 중 하나의 이름 속성과 일치해야합니다.
jvmRoute

식별자는 세션 선호도를 사용하도록 로드 균형 조정 시나리오에 사용해야합니다. 클러스터에 참여하는 모든 톰캣 서버에서 고유해야합니다 식별자,생성된 세션 식별자에 추가됩니다. 따라서 프런트 엔드 프록시가 항상 같은 톰캣 인스턴스에 특정 세션을 전달할 수 있도록합니다.

name

로그 및 오류 메시지에 사용되는이 엔진의 논리적 이름. 동일한 서버에서 여러 서비스 요소를 사용하면 각 엔진은 고유한 이름을 할당되어야 합니다.

startStopThreads

The number of threads this Engine will use to start child Host elements in parallel. The special value of 0 will result in the value of Runtime.getRuntime().availableProcessors() being used. 스레드 개수는 이 엔진은 병렬로 아동 호스트 요소를 시작하는 데 사용됩니다. 0 특별한 가치는 Runtime.getRuntime ()의 가치가 높아집니다. availableProcessors ()가 사용되고있다. Negative values will result in Runtime. getRuntime().availableProcessors() + value being used unless this is less than 1 in which case 1 thread will be used. If not specified, the default value of 1 will be used.

음수 값은 Runtime.getRuntime ()가 발생합니다. getRuntime().availableProcessors()이 한 스레드가 사용되는 경우 최대 1가 아니면 사용되고 + 값. 지정하지 않으면 1의 기본값이 사용됩니다.
Standard Implementation

The standard implementation of Engine is org.apache.catalina.core.StandardEngine. 엔진의 표준 구현은 org.apache.catalina.core.StandardEngine입니다 It supports the following additional attributes (in addition to the common attributes listed above):

그것은 다음과 같은 추가 속성을 (위에 나열된 일반적인 특성 이외에) 지원
AttributeDescription
Nested Components

You can nest one or more Host elements inside this Engine element, each representing a different virtual host associated with this server. 당신은 그 안에 둥지 하나 이상의 호스트 요소 수 이 엔진 요소,이 서버와 관련된 다른 가상 호스트를 나타내는 각. At least one Host is required, and one of the nested Hosts MUST have a name that matches the name specified for the defaultHost attribute, listed above.

최소한 하나의 호스트가 필요하고, 중첩된 호스트 중 하나 여야합니다 위에 나열된 기본 호스트 속성에 대해 지정된 이름과 일치하는 이름이있다.

You can nest at most one instance of the following utility components by nesting a corresponding element inside your Engine element:

다음과 같은 유틸리티 구성 요소의 대부분의 한 인스턴스에서 둥지 수 당신의 엔진 요소 내에 중첩 해당 요소에 의해 :
  • Realm - Configure a realm that will allow its database of users, and their associated roles, to be shared across all Hosts and Contexts nested inside this Engine, unless overridden by a Realm configuration at a lower level.
  • 낮은 수준의 영역 구성에 의해 오버로드하지 않는 사용자의 데이터베이스 및 관련 역할, 모든 호스트에서 공유하고이 엔진 내부에 중첩될 수있는가, 수 영역을 영역 - 구성합니다.
Special Features
Logging

An engine is associated with the org.apache.catalina.core.ContainerBase.[enginename] log category. Note that the brackets are actually part of the name, don't omit them.

엔진은 org.apache.catalina.core.ContainerBase와 연결되어 있습니다. [enginename]은 로그 카테고리입니다.괄호가 실제로 이름의 일부임을 참고, 그들을 생략하지 않습니다.
Access Logs

When you run a web server, one of the output files normally generated is an access log, which generates one line of information for each request processed by the server, in a standard format. Catalina includes an optional Valve implementation that can create access logs in the same standard format created by web servers, or in any number of custom formats.

당신은 웹 서버가 정상적으로 enerated 출력 파일 중 하나를 실행하면 표준 형식으로, 서버에 의해 처리하는 각 요청에 대해 하나의 정보 라인을 생성하는 액세스 로그입니다. 카탈리 나는 웹 서버에서 만든 같은 표준 형식으로 또는 사용자 정의 형식의 숫자에있는 액세스 로그를 만들 수 있습니다 optiona 밸브 구현을 포함합니다.

You can ask Catalina to create an access log for all requests processed by an Engine, Host, or Context by nesting a Valve element like this:

이 같은 둥지 밸브 요소로 엔진, 호스트, 또는 문맥에 의해 처리된 모든 요청에 대한 액세스 로그를 만들 카탈리 나를 요청할 수 있습니다
<Engine name="Standalone" ...>
  ...

  엔진 이름 = "독립형"

  <Valve className="org.apache.catalina.valves.AccessLogValve"
         prefix="catalina_access_log." suffix=".txt"
         pattern="common"/>
  ...
 
</Engine>

See Access Log Valve for more information on the configuration attributes that are supported.

지원되는 구성 속성에 대한 자세한 내용은 로그 밸브에 액세스를 참조하십시오.
Lifecycle Listeners

If you have implemented a Java object that needs to know when this Engine is started or stopped, you can declare it by nesting a Listener element inside this element. The class name you specify must implement the org.apache.catalina.LifecycleListener interface, and it will be notified about the occurrence of the corresponding lifecycle events. Configuration of such a listener looks like this:

당신이 자바 객체를 구현했을 경우 그 알 필요하실 때 엔진이 시작 또는 중지되고,이 요소 내에 중첩 리스너 요소하여 선언할 수 있습니다. 지정한 클래스 이름은 org.apache.catalina.LifecycleListener 인터페이스를 구현해야하며, 그것은 해당 생명주기 이벤트 발생에 대해 통지합니다. 이러한 리스너의 구성은 다음과 같습니다
<Engine name="Standalone" ...>
    엔진 이름 = "독립형"
 

  ...
  <Listener className="com.mycompany.mypackage.MyListener" ... >
  ...
</Engine>

Note that a Listener can have any number of additional properties that may be configured from this element. Attribute names are matched to corresponding JavaBean property names using the standard property method naming patterns.

리스너가이 요소에서 구성할 수있는 추가 속성이 여러 개 가질 수 있습니다. 속성 이름은 패턴을 명명 표준 프로퍼티 메소드를 사용하여 해당 JavaBean 속성 이름과 일치합니다.
Request Filters

You can ask Catalina to check the IP address, or host name, on every incoming request directed to the surrounding Engine, Host, or Context element. The remote address or name will be checked against configured "accept" and/or "deny" filters, which are defined using java.util.regex Regular Expression syntax. Requests that come from locations that are not accepted will be rejected with an HTTP "Forbidden" error. Example filter declarations:

당신은 매우에 IP 주소 또는 호스트 이름을 확인 카탈리 나를 요청할 수 있습니다 들어오는 요청은 주위 엔진 호스트, 또는 상황에 맞는 요소로 이동합니다. 원격 주소 또는 이름이 구성된 것은 java.util.regex 정규식 구문을 사용하여 정의하는, "동의"및 / 또는 "거부"필터를 기준으로 확인됩니다. 허용되지 않은 지역에서 온 요청은 HTTP "금지"오류와 함께 거부됩니다. 예제 필터 선언 :
<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\.\d+"/>
  ...
</Engine>

See Remote Address Filter and Remote Host Filter for more information about the configuration options that are supported.

지원되는 구성 옵션에 대한 자세한 내용은 원격 주소가 필터와 원격 호스트 필터를 참조하십시오.

Copyright © 1999-2013, Apache Software Foundation