Java EE 배치 디스크립터를 사용하여 환경 참조 정의

이 규칙은 WEB-INF/web.xml 파일의 <env-entry> 요소로 변환되어야 하는, META-INF/context.xml의 Context <Environment> 요소에 플래그를 지정합니다.

Apache Tomcat에서는 다음 위치에서 Context <Environment> 요소를 정의할 수 있습니다.

• META-INF/context.xml 파일
• Tomcat conf 디렉토리의 애플리케이션 XML 구성 파일
• conf/server.xml의 <Host> 요소

마이그레이션 도구는 Tomcat 구성 디렉토리에 액세스할 수 없기 때문에 META-INF/context.xml 파일의 Context <Environment>에만 플래그를 지정합니다. 기타 위치에 정의되어 있는 Context <Environment> 정보는 META-INF/context.xml 파일에 복사하여 마이그레이션 도구로 처리할 수 있습니다.

WEB-INF/web.xml 파일이 웹 프로젝트에 존재하는 경우,

다음 조건 중 하나에서 Context <Environment> 요소를 플래그 지정합니다.

• web.xml 파일에 해당 항목과 일치하는 항목이 없음
• 해당 항목과 web.xml 파일의 일치하는 항목의 유형이 서로 다름
• 해당 항목과 web.xml 파일의 일치하는 항목의 값이 서로 다르고 이 항목의 대체 플래그가 false로 설정되어 있음

소스 스캐너에서 이 규칙에 대한 빠른 수정사항을 사용할 수 있습니다. 빠른 수정사항은 web.xml 파일에 이미 존재하는 경우에도 web.xml 파일에 Context <Environment> 요소를 나타내는 새 <env-entry> 요소를 추가합니다. 이 항목이 존재하는 경우에는 해당 항목이 업데이트됩니다.

WEB-INF/web.xml 파일이 존재하지 않는 경우,

모든 Context <Environment> 요소에 플래그를 지정합니다.

웹 프로젝트가 Java EE 5 이상이면 빠른 수정사항이 해당 <env-entry> 요소가 포함된 WEB-INF/web.xml 파일을 작성합니다. 웹 프로젝트가 J2EE 1.4 이하이면 빠른 수정사항이 오류를 보고합니다.

예를 들어, 다음 컨텐츠가 있는 META-INF/context.xml 파일과

<Environment description="Trigger because it does not exist" name="newEntry" override="false" type="java.lang.String" value="abc123"/> <Environment description="Trigger because of different value" name="contextEnvString_1" override="false" type="java.lang.String" value="new Value"/> <Environment description="Trigger because of different type" name="contextEnvString_2" override="false" type="java.lang.Integer" value="123"/> <Environment description="will not Trigger because of override set to true." name="contextEnvString_3" override="true" type="java.lang.Integer" value="123"/>

애플리케이션의 web.xml 파일을 생각해 보십시오.

<env-entry> <description>Trigger because of different value</description> <env-entry-name>contextEnvString_1</env-entry-name> <env-entry-type>java.lang.String</env-entry-type> <env-entry-value>oldValue</env-entry-value> </env-entry> <env-entry> <description>Trigger because of different type</description> <env-entry-name>contextEnvString_2</env-entry-name> <env-entry-type>java.lang.String</env-entry-type> <env-entry-value>123</env-entry-value> </env-entry> <env-entry> <description>will not Trigger because of override set to true.</description> <env-entry-name>contextEnvString_3</env-entry-name> <env-entry-type>java.lang.Integer</env-entry-type> <env-entry-value>123456789</env-entry-value> </env-entry>

빠른 수정사항을 적용하고 나면 web.xml 파일이 업데이트되어 다음 컨텐츠가 포함됩니다.

<env-entry> <description>Trigger because of different value</description> <env-entry-name>contextEnvString_1</env-entry-name> <env-entry-type>java.lang.String</env-entry-type> <env-entry-value>new Value</env-entry-value> </env-entry> <env-entry> <description>Trigger because of different type</description> <env-entry-name>contextEnvString_2</env-entry-name> <env-entry-type>java.lang.Integer</env-entry-type> <env-entry-value>123</env-entry-value> </env-entry> <env-entry> <description>will not Trigger because of override set to true.</description> <env-entry-name>contextEnvString_3</env-entry-name> <env-entry-type>java.lang.Integer</env-entry-type> <env-entry-value>123456789</env-entry-value> </env-entry> <env-entry> <description>Trigger becasue it does not exist</description> <env-entry-name>newEntry</env-entry-name> <env-entry-type>java.lang.String</env-entry-type> <env-entry-value>abc123</env-entry-value> </env-entry>