[스프링 핵심 원리와 활용] 섹션3. 웹 서버와 서블릿 컨테이너

[YuDeokRin]

섹션 3. 웹 서버와 서블릿 컨테이너

1️⃣ 웹 서버와 스프링 부트 소개

• 외장 서버(전통적인 방식)
  • 외장서버(전통적인 방식) 같은 경우 WAS에 동작하도록 서블릿 스펙에 맞추어 코드를 작성하고 WAR 형식으로 빌드해서 war 파일을 만들었음.
  • 이와 같은 방식은 WAS 기반 위에서 개발하고 실행해야 한다.
• 내장 서버(최근 방식)
  • 내장 톰캣을 가지고 있다. 애플리케이션 코드 안에 톰캣 같은 WAS가 라이브러리로 내장되어 있다는 뜻.
  • 개발자는 코드를 작성하고 JAR로 빌드한 다음에 해당 JAR를 원하는 위치에서 실행하기만 하면 WAS도 함께 실행된다.

2️⃣ 톰캣 설치

• 톰켓 설치

• 서버를 띠웠다.

• 톰켓 이력보는방법

• :8080 포트를 사용하는지 조회해보는 명령어 - 프로세스 ID(PID) 조회

• 프로세스 종료하는 명령어

sudo kill -9 PID  : 프로세스 종료 

• 톰켓 디폴트 8080포트를 사용하는데 바꿔주려면
  • 톰켓폴더 → conf → server.xml 파일 안에서 코드 수정

☸ k3d-rancher-cluster (default) in spring-boot-v20240120/tool/apache-tomcat-10.1.43
❯ cd conf

☸ k3d-rancher-cluster (default) in tool/apache-tomcat-10.1.43/conf
❯ ls
Catalina             catalina.properties  jaspic-providers.xml logging.properties   tomcat-users.xml     web.xml
catalina.policy      context.xml          jaspic-providers.xsd server.xml           tomcat-users.xsd

☸ k3d-rancher-cluster (default) in tool/apache-tomcat-10.1.43/conf
❯ cat server.xml
<?xml version="1.0" encoding="UTF-8"?>
<!--
  Licensed to the Apache Software Foundation (ASF) under one or more
  contributor license agreements.  See the NOTICE file distributed with
  this work for additional information regarding copyright ownership.
  The ASF licenses this file to You under the Apache License, Version 2.0
  (the "License"); you may not use this file except in compliance with
  the License.  You may obtain a copy of the License at

      http://www.apache.org/licenses/LICENSE-2.0

  Unless required by applicable law or agreed to in writing, software
  distributed under the License is distributed on an "AS IS" BASIS,
  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  See the License for the specific language governing permissions and
  limitations under the License.
-->
<!-- Note:  A "Server" is not itself a "Container", so you may not
     define subcomponents such as "Valves" at this level.
     Documentation at /docs/config/server.html
 -->
<Server port="8005" shutdown="SHUTDOWN">
  <Listener className="org.apache.catalina.startup.VersionLoggerListener" />
  <!-- Security listener. Documentation at /docs/config/listeners.html
  <Listener className="org.apache.catalina.security.SecurityListener" />
  -->
  <!-- OpenSSL support using Tomcat Native -->
  <Listener className="org.apache.catalina.core.AprLifecycleListener" />
  <!-- OpenSSL support using FFM API from Java 22 -->
  <!-- <Listener className="org.apache.catalina.core.OpenSSLLifecycleListener" /> -->
  <!-- Prevent memory leaks due to use of particular java/javax APIs-->
  <Listener className="org.apache.catalina.core.JreMemoryLeakPreventionListener" />
  <Listener className="org.apache.catalina.mbeans.GlobalResourcesLifecycleListener" />
  <Listener className="org.apache.catalina.core.ThreadLocalLeakPreventionListener" />

  <!-- Global JNDI resources
       Documentation at /docs/jndi-resources-howto.html
  -->
  <GlobalNamingResources>
    <!-- Editable user database that can also be used by
         UserDatabaseRealm to authenticate users
    -->
    <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>

  <!-- A "Service" is a collection of one or more "Connectors" that share
       a single "Container" Note:  A "Service" is not itself a "Container",
       so you may not define subcomponents such as "Valves" at this level.
       Documentation at /docs/config/service.html
   -->
  <Service name="Catalina">

    <!--The connectors can use a shared executor, you can define one or more named thread pools-->
    <!--
    <Executor name="tomcatThreadPool" namePrefix="catalina-exec-"
        maxThreads="150" minSpareThreads="4"/>
    -->

    <!-- A "Connector" represents an endpoint by which requests are received
         and responses are returned. Documentation at :
         HTTP Connector: /docs/config/http.html
         AJP  Connector: /docs/config/ajp.html
         Define a non-SSL/TLS HTTP/1.1 Connector on port 8080
    -->
    <Connector port="8080" protocol="HTTP/1.1"
               connectionTimeout="20000"
               redirectPort="8443"
               maxParameterCount="1000"
               />
    <!-- A "Connector" using the shared thread pool-->
    <!--
    <Connector executor="tomcatThreadPool"
               port="8080" protocol="HTTP/1.1"
               connectionTimeout="20000"
               redirectPort="8443"
               maxParameterCount="1000"
               />
    -->
    <!-- Define an SSL/TLS HTTP/1.1 Connector on port 8443 with HTTP/2
         This connector uses the NIO implementation. The default
         SSLImplementation will depend on the presence of the APR/native
         library and the useOpenSSL attribute of the AprLifecycleListener.
         Either JSSE or OpenSSL style configuration may be used regardless of
         the SSLImplementation selected. JSSE style configuration is used below.
    -->
    <!--
    <Connector port="8443" protocol="org.apache.coyote.http11.Http11NioProtocol"
               maxThreads="150" SSLEnabled="true"
               maxParameterCount="1000"
               >
        <UpgradeProtocol className="org.apache.coyote.http2.Http2Protocol" />
        <SSLHostConfig>
            <Certificate certificateKeystoreFile="conf/localhost-rsa.jks"
                         certificateKeystorePassword="changeit" type="RSA" />
        </SSLHostConfig>
    </Connector>
    -->

    <!-- Define an AJP 1.3 Connector on port 8009 -->
    <!--
    <Connector protocol="AJP/1.3"
               address="::1"
               port="8009"
               redirectPort="8443"
               maxParameterCount="1000"
               />
    -->

    <!-- An Engine represents the entry point (within Catalina) that processes
         every request.  The Engine implementation for Tomcat stand alone
         analyzes the HTTP headers included with the request, and passes them
         on to the appropriate Host (virtual host).
         Documentation at /docs/config/engine.html -->

    <!-- You should set jvmRoute to support load-balancing via AJP ie :
    <Engine name="Catalina" defaultHost="localhost" jvmRoute="jvm1">
    -->
    <Engine name="Catalina" defaultHost="localhost">

      <!--For clustering, please take a look at documentation at:
          /docs/cluster-howto.html  (simple how to)
          /docs/config/cluster.html (reference documentation) -->
      <!--
      <Cluster className="org.apache.catalina.ha.tcp.SimpleTcpCluster"/>
      -->

      <!-- Use the LockOutRealm to prevent attempts to guess user passwords
           via a brute-force attack -->
      <Realm className="org.apache.catalina.realm.LockOutRealm">
        <!-- This Realm uses the UserDatabase configured in the global JNDI
             resources under the key "UserDatabase".  Any edits
             that are performed against this UserDatabase are immediately
             available for use by the Realm.  -->
        <Realm className="org.apache.catalina.realm.UserDatabaseRealm"
               resourceName="UserDatabase"/>
      </Realm>

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

        <!-- SingleSignOn valve, share authentication between web applications
             Documentation at: /docs/config/valve.html -->
        <!--
        <Valve className="org.apache.catalina.authenticator.SingleSignOn" />
        -->

        <!-- Access log processes all example.
             Documentation at: /docs/config/valve.html
             Note: The pattern used is equivalent to using pattern="common" -->
        <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>

• 이 부분에서 port를 변경

<Connector port="8080" protocol="HTTP/1.1"
               connectionTimeout="20000"
               redirectPort="8443"
               maxParameterCount="1000"
               />

plugins {
    id 'java'
    id 'war'
}

group = 'hello'
version = '0.0.1-SNAPSHOT'
sourceCompatibility = '17'

repositories {
    mavenCentral()
}

dependencies {
    //서블릿
    implementation 'jakarta.servlet:jakarta.servlet-api:6.0.0'
}

tasks.named('test') {
    useJUnitPlatform()
}

• 서블릿 등록
  • /test로 요청이 들어오면 서블릿이 실행된다.
  • TestServlet.service를 로그에 출력

/**
 * http://localhost:8080/test
 */
@WebServlet(urlPatterns = "/test")
public class TestServlet extends HttpServlet {

    @Override
    protected void service(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
        System.out.println("TestServlet.service");
        resp.getWriter().println("test");
    }
}

3️⃣ 프로젝트 설정

• 프로젝트 설정은 간단한 것으로 생각되어 그대로 따라가기만 된다.

4️⃣ WAR 빌드와 배포

• 프로젝트 빌드

• 빌드 후 libs에는 war파일이 생긴다.

• 참고
  • build.gradle에 보면 war 플러그인이 사용된 것을 확인할 수 있다.
  • 플러그인이 war 파일을 만들어준다.

plugins {
    id 'java'
    id 'war'
}

✅ WAR 압축 풀기

• 우리가 빌드한 war 파일의 압축을 풀어서 내용물을 확인
• build/libs 폴더로 이동
• 다음 명령어를 사용해서 압축을 풀자
  • jar -xvf server-0.0.1-SNAPSHOT.war

✅WAR를 푼 결과

• WEB-INF
  • classes
    • hello/servlet/TestServlet.class
  • lib
    • jakarta.servlet-api-6.0.0.jar
• index.html WAR를 푼 결과를 보면 WEB-INF , classes , lib 같은 특별한 폴더들이 보인다. 이 부분을 알아보자.

✅ JAR, WAR 간단 소개

• JAR소개

  • 자바는 여러 클래스와 리소스를 묶어서 JAR(Java Archive)라고 하는 압축 파일을 만들 수 있다.
  • 이 파일은 JVM 위에서 직접 실행되거나 또는 다른 곳에서 사용하는 라이브러리로 제공한다.
  • 직접 실행하는 경우 main() 메서드가 필요 그리고 MAINFEST.MF 파일에 실행할 메인 메서드가 있는 클래스를 지정해두어야함

• WAR 소개

  • WAR(Web Application Archive)라고 한다.
  • WAR 파일은 웹 어플리케이션(WAS)에 배포할 때 사용하는 파일이다.
  • JAR 파일이 JVM위에서 실행된다면, WAR는 웹 애플리케이션 서버 위에서 실행된다.

• 웹 애플리케이션 서버 위에서 실행되고, HTML 같은 정적 리소스와 클래스 파일을 모두 함께 포함하기 때문에 JAR와비교해서 구조가 더 복잡함.

• 주의사항 - WAR 구조를 지켜야 한다.

✅WAR 구조

• WEB-INF

  • classes : 실행 클래스 모음
  • lib : 라이브러리 모음
  • web.xml : 웹 서버 배치 설정 파일(생략 가능)

• index.html : 정적 리소스

• WEB-INF 폴더 하위는 자바 클래스와 라이브러리, 그리고 설정 정보가 들어가는 곳이다.

• WEB-INF 를 제외한 나머지 영역은 HTML, CSS 같은 정적 리소스가 사용되는 영역이다.

➡️ WAR 배포

생성된 WAR파일을 톰캣 서버에 실제 배포해보자.

1. 톰캣 서버를 종료한다. ./shutdown.sh
2. 톰캣폴더/webapps 하위를 모두 삭제한다.
3. 빌드된 server-0.0.1-SNAPSHOT.war 를 복사한다.
4. 톰캣폴더/webapps 하위에 붙여넣는다.
   톰캣폴더/webapps/server-0.0.1-SNAPSHOT.war
5. 이름을 변경한다.
   톰캣폴더/webapps/ROOT.war
6. 톰캣 서버를 실행한다. ./startup.sh

5️⃣ 톰캣 설정 - 인텔리제이 J 무료 버전