[톰캣] tomcat에서 context 추가하는 방법 3가지

1. 서버(server.xml)에서 추가하는 방법

<Host name="localhost" appBase="webapps"
      unpackWARs="true" autoDeploy="true">

    <Context path="/app1" docBase="app1" />

    <Valve className="org.apache.catalina.valves.AccessLogValve" directory="logs"
           prefix="localhost_access_log" suffix=".txt"
           pattern="%h %l %u %t &quot;%r&quot; %s %b" />
</Host>

자세한 내용: 2024.08.20 - [코딩ㆍ개발 정보/HTML 연습] - [톰캣] server.xml , Context 설정

2. 서버(conf/Catalina/localhost/app1.xml) 에서 추가하는 방법

각 애플리케이션별로 별도의 context.xml 파일을 사용하는 방법은 다음과 같습니다. 이 방법을 사용하면 server.xml 파일을 수정하지 않고도 각 애플리케이션에 대해 별도로 설정을 관리할 수 있습니다.

1. 애플리케이션의 context.xml 파일 생성

각 애플리케이션의 설정을 위해 conf/Catalina/localhost/ 디렉토리 안에 개별적인 .xml 파일을 생성합니다. 이 .xml 파일은 애플리케이션의 Context 설정을 포함하게 되며, 파일 이름은 애플리케이션의 컨텍스트 경로와 일치해야 합니다.

예시:

• 애플리케이션 경로가 /app1이라면, app1.xml 파일을 생성합니다.
• 애플리케이션 경로가 /myapp이라면, myapp.xml 파일을 생성합니다.

2. conf/Catalina/localhost/ 디렉토리에 context.xml 파일 배치

Tomcat의 conf/Catalina/localhost/ 디렉토리에 해당 파일을 배치합니다. 이 디렉토리가 없는 경우, 먼저 디렉토리를 생성해야 합니다.

예를 들어, 애플리케이션이 app1이라는 이름으로 배포된다면, 다음과 같이 설정 파일을 생성합니다:

1. Tomcat의 conf/Catalina/localhost/ 디렉토리로 이동합니다.
2. app1.xml 파일을 생성합니다.

3. context.xml 파일 내용 작성

app1.xml 파일에 해당 애플리케이션의 Context 설정을 정의합니다. docBase 속성으로 애플리케이션의 물리적인 경로를 지정할 수 있습니다.

app1.xml 파일 예시:

<Context docBase="/path/to/your/app1" />

• docBase: 애플리케이션이 배포된 실제 경로를 지정합니다. 절대 경로 또는 상대 경로를 사용할 수 있습니다.
• path: 파일 이름에 의해 경로가 자동으로 결정되므로, path 속성을 생략하는 것이 좋습니다.

4. 애플리케이션 경로와 설정 파일의 관계

• 만약 app1.xml 파일이 conf/Catalina/localhost/ 디렉토리에 위치한다면, 해당 설정은 /app1이라는 경로로 제공되는 애플리케이션에 적용됩니다.
• http://localhost:8080/app1으로 접근할 수 있습니다.

5. Tomcat 서버 재시작

설정을 완료한 후, Tomcat 서버를 재시작하여 변경 사항을 적용합니다.

6. 실제 예시

예를 들어, /opt/tomcat/webapps/myapp에 애플리케이션을 배포하고 싶다면:

1. conf/Catalina/localhost/ 디렉토리에 myapp.xml 파일을 생성합니다.
2. myapp.xml 파일에 다음 내용을 작성합니다:

<Context docBase="/opt/tomcat/webapps/myapp" />

1. Tomcat 서버를 재시작합니다.
2. 이제 http://localhost:8080/myapp으로 애플리케이션에 접근할 수 있습니다.

요약

• 각 애플리케이션별로 Tomcat의 conf/Catalina/localhost/ 디렉토리에 .xml 파일을 생성하여 개별적으로 Context 설정을 관리합니다.
• 이 설정 방식은 server.xml을 수정할 필요가 없으며, 애플리케이션의 유지보수 및 배포 관리를 간소화합니다.
• docBase 속성을 통해 애플리케이션의 실제 경로를 지정하며, 설정 파일 이름은 애플리케이션의 URL 경로와 일치시킵니다.

3. 애플리케이션 내 context.xml 설정

애플리케이션별로 별도의 context.xml 파일을 설정하면, 특정 웹 애플리케이션에 대한 컨텍스트 설정을 분리하여 관리할 수 있습니다.

예시: META-INF/context.xml 파일

애플리케이션의 META-INF/context.xml 파일에 다음과 같은 설정을 추가할 수 있습니다:

<Context>

    <!-- 데이터베이스 연결 설정 -->
    <Resource name="jdbc/mydb"
              auth="Container"
              type="javax.sql.DataSource"
              maxTotal="20"
              maxIdle="10"
              maxWaitMillis="10000"
              username="dbuser"
              password="dbpassword"
              driverClassName="com.mysql.cj.jdbc.Driver"
              url="jdbc:mysql://localhost:3306/mydatabase"/>

    <!-- 추가적인 설정 -->
    <Parameter name="configLocation" value="/WEB-INF/config.xml"/>
    <ResourceLink name="myResource"
                  global="myGlobalResource"
                  type="com.example.MyResource"/>
                  
    <!-- 기타 설정 -->
</Context>

 

4. 한글 깨짐 방지 설정 추가

• URIEncoding 설정: 위의 server.xml 파일에서 Connector 요소에 URIEncoding="UTF-8"과 useBodyEncodingForURI="true"가 포함되어 있습니다. 이 설정은 GET 요청의 URI 인코딩을 UTF-8로 설정해 한글 깨짐을 방지합니다.

<?xml version="1.0" encoding="UTF-8"?>
<Server port="8005" shutdown="SHUTDOWN">
  <Listener className="org.apache.catalina.startup.VersionLoggerListener" />
  <Listener className="org.apache.catalina.core.AprLifecycleListener" SSLEngine="on" />
  <Listener className="org.apache.catalina.core.JreMemoryLeakPreventionListener" />
  <Listener className="org.apache.catalina.mbeans.GlobalResourcesLifecycleListener" />
  <Listener className="org.apache.catalina.core.ThreadLocalLeakPreventionListener" />

  <GlobalNamingResources>
    <Resource name="UserDatabase" auth="Container"
              type="org.apache.catalina.UserDatabase"
              description="User database that can be updated and saved"
              factory="org.apache.catalina.users.MemoryUserDatabaseFactory"
              pathname="conf/tomcat-users.xml" />
  </GlobalNamingResources>

  <Service name="Catalina">

    <!-- A "Connector" represents an endpoint by which requests are received
         and responses are returned. Documentation at :
         Java HTTP Connector: https://tomcat.apache.org/tomcat-9.0-doc/config/http.html
         Java AJP  Connector: https://tomcat.apache.org/tomcat-9.0-doc/config/ajp.html
         APR (HTTP/AJP) Connector: https://tomcat.apache.org/tomcat-9.0-doc/apr.html
         Define a non-SSL HTTP/1.1 Connector on port 8080 -->
    <Connector port="8080" protocol="HTTP/1.1"
               connectionTimeout="20000"
               redirectPort="8443"
               URIEncoding="UTF-8"
               useBodyEncodingForURI="true"
               />

    <!-- A "Connector" using the shared thread pool -->
    <!--
    <Connector executor="tomcatThreadPool"
               port="8080" protocol="HTTP/1.1"
               connectionTimeout="20000"
               redirectPort="8443" />
    -->

    <!-- Define an SSL HTTP/1.1 Connector on port 8443
         This connector uses the NIO implementation, which requires the JSSE
         style configuration. When using the APR/native implementation, the
         OpenSSL style configuration is required as described in the APR/native
         documentation -->
    <!--
    <Connector port="8443" protocol="org.apache.coyote.http11.Http11NioProtocol"
               maxThreads="150" SSLEnabled="true">
        <SSLHostConfig>
            <Certificate certificateKeystoreFile="conf/localhost-rsa.jks"
                         type="RSA" />
        </SSLHostConfig>
    </Connector>
    -->

    <!-- Define an AJP 1.3 Connector on port 8009 -->
    <Connector port="8009" protocol="AJP/1.3" redirectPort="8443" />

    <Engine name="Catalina" defaultHost="localhost">

      <Realm className="org.apache.catalina.realm.LockOutRealm">
        <Realm className="org.apache.catalina.realm.UserDatabaseRealm"
               resourceName="UserDatabase"/>
      </Realm>

      <Host name="localhost"  appBase="webapps"
            unpackWARs="true" autoDeploy="true">

        <Valve className="org.apache.catalina.valves.AccessLogValve" directory="logs"
               prefix="localhost_access_log" suffix=".txt"
               pattern="%h %l %u %t &quot;%r&quot; %s %b" />

      </Host>
    </Engine>
  </Service>
</Server>

• 응답 콘텐츠 인코딩 설정: 만약 웹 애플리케이션의 응답이 UTF-8 인코딩을 사용하도록 하려면, 각 애플리케이션의 web.xml에서 filter를 사용하여 인코딩을 강제할 수 있습니다.

<filter>
    <filter-name>CharacterEncodingFilter</filter-name>
    <filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>
    <init-param>
        <param-name>encoding</param-name>
        <param-value>UTF-8</param-value>
    </init-param>
    <init-param>
        <param-name>forceEncoding</param-name>
        <param-value>true</param-value>
    </init-param>
</filter>
<filter-mapping>
    <filter-name>CharacterEncodingFilter</filter-name>
    <url-pattern>/*</url-pattern>
</filter-mapping>