Spring에서는 Servlet과 DispatcherServlet이 웹 요청 처리에서 핵심적인 역할을 해요. 개념을 하나씩 명확히 정리해볼게요.

🧱 1. Servlet이란?

✅ 정의

• 자바 웹에서 가장 기본적인 컴포넌트
• HTTP 요청을 처리하고, HTTP 응답을 반환하는 자바 클래스
• 톰캣(Tomcat) 같은 서블릿 컨테이너에서 실행됨

✅ 역할

• 웹 브라우저에서 온 요청을 받아서 처리하고, 응답을 생성함
• 예전에는 모든 요청을 직접 Servlet에서 처리했어요.

@WebServlet("/hello")
public class HelloServlet extends HttpServlet {
    protected void doGet(HttpServletRequest request, HttpServletResponse response) {
        response.getWriter().write("Hello from Servlet!");
    }
}

이건 거의 Spring 이전의 전통적인 웹 방식이에요.

Spring Boot에서 Filter와 Interceptor는 모두 요청(Request)과 응답(Response)을 가로채서 처리할 수 있게 해주는 기능이지만, 역할, 실행 시점, 적용 범위에서 차이가 있습니다. 아래에서 간단 + 예시와 함께 정리해볼게요.

🔹 1. Filter (서블릿 필터)

✅ 개요

• Servlet 스펙에 정의된 기능
• Spring보다 더 하위 레벨
• DispatcherServlet 이전에 실행됨

✅ 사용 예시

• 인증, 인코딩, 로깅, XSS 방어
• 공통 전처리/후처리

✅ 예제

@Component
public class MyFilter implements Filter {
    @Override
    public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain)
            throws IOException, ServletException {
        System.out.println("Filter: 요청 전");
        chain.doFilter(request, response);
        System.out.println("Filter: 응답 후");
    }
}

🔹 2. Interceptor (스프링 인터셉터)

✅ 개요

• Spring MVC의 기능
• DispatcherServlet 이후에 동작
• 주로 컨트롤러 진입 전/후에 로직 적용

✅ 사용 예시

• 로그인 체크
• 권한 검사
• 요청 로깅
• 공통 응답 가공

✅ 예제

public class MyInterceptor implements HandlerInterceptor {
    @Override
    public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) {
        System.out.println("Interceptor: 컨트롤러 호출 전");
        return true; // false면 컨트롤러로 안 넘어감
    }
}

그리고 등록은 이렇게 해야 해요:

github action sample

spring boot

• gradle build를 사용하는 spring boot를 빌드하고 ssh로

• secret 류는 setting-> security에 Secrets and variables 내 action 메뉴에서 설정

• 마지막에 slack webhook으로 배포 상황 알림

• action 설정이나 slack webhoook url 설정하는 방법은 다른 블로그에도 많으니 생략하겠습니다.

  name: Build and Deploy
  
  on:
    push:
      branches:
        - develop
  
  jobs:
    build-and-deploy:
      runs-on: ubuntu-latest
  
      steps:
        # 1. SSH 호스트 키 추가
        - name: Add SSH known hosts
          run: |
            mkdir -p ~/.ssh
            ssh-keyscan -H github.com >> ~/.ssh/known_hosts
  
        # 2. 리포지토리 체크아웃 (서브모듈 포함)
        - name: Checkout repository with submodules
          uses: actions/checkout@v3
          with:
            submodules: recursive
            ssh-key: ${{ secrets.PRIVATE_KEY_FOR_SUBMODULE }}
            fetch-depth: 0
  
        # 3. 서브모듈 최신화
        - name: Update submodules to the latest
          run: |
            git submodule update --init --recursive
            git submodule foreach git pull origin $(git rev-parse --abbrev-ref HEAD)
  
        # 4. JDK 설정
        - name: Set up JDK 23
          uses: actions/setup-java@v3
          with:
            java-version: '23'
            distribution: 'temurin'
  
        # 5. Gradle 빌드
        - name: Build with Gradle
          run: ./gradlew clean build -x test
  
        # 6. 서버로 파일 전송
        - name: Deploy to Server
          env:
            SSH_PRIVATE_KEY: ${{ secrets.DEV_SSH_PRIVATE_KEY }}
            DEPLOY_SERVER_IP: ${{ secrets.DEV_SERVER_IP }}
            DEPLOY_SERVER_USER: ${{ secrets.DEV_SERVER_USER }}
          run: |
            echo "DEPLOY_SERVER_IP: $DEPLOY_SERVER_IP"
            mkdir -p ~/.ssh
            echo "$SSH_PRIVATE_KEY" > ~/.ssh/github_action
            chmod 600 ~/.ssh/github_action
            ssh-keyscan -H "$DEPLOY_SERVER_IP" >> ~/.ssh/known_hosts
  
            # 빌드 파일 전송
            scp -i ~/.ssh/github_action build/libs/*.jar $DEPLOY_SERVER_USER@$DEPLOY_SERVER_IP:/home/$DEPLOY_SERVER_USER/backend/
  
            # swagger rest doc json
            # scp -i ~/.ssh/github_action build/resources/main/restdocs/*.json $DEPLOY_SERVER_USER@$DEPLOY_SERVER_IP:/home/$DEPLOY_SERVER_USER/swagger-docs/
            find build/resources/main/restdocs -name "*.json" | grep . && scp -i ~/.ssh/github_action build/resources/main/restdocs/*.json $DEPLOY_SERVER_USER@$DEPLOY_SERVER_IP:/home/$DEPLOY_SERVER_USER/swagger-docs/ || echo "No JSON files to copy, skipping..."
  
        # 7. 서버에서 애플리케이션 실행
        - name: Start Application
          env:
            DEPLOY_SERVER_IP: ${{ secrets.DEV_SERVER_IP }}
            SERVER_USER: ${{ secrets.DEV_SERVER_USER }}
            REPOSITORY_NAME: ${{ github.repository }}
          run: |
            PROJECT_NAME=$(echo $REPOSITORY_NAME | cut -d'/' -f2)
            ssh -i ~/.ssh/github_action $SERVER_USER@$DEPLOY_SERVER_IP << EOF
            cd /home/$SERVER_USER/backend
            chmod 700 /home/$SERVER_USER/backend/${PROJECT_NAME}*-exec.jar 
            sh /home/$SERVER_USER/bin/deploy.sh $PROJECT_NAME dev /home/$SERVER_USER 512m
            sh /home/$SERVER_USER/infra/swagger/swagger_script.sh restart ${PROJECT}-api.json
            EOF
  
        - name: action-slack
          uses: 8398a7/action-slack@v3
          with:
            status: ${{ job.status }}
            author_name: Pink Spider - dev
            fields: repo,commit,message,author # action,eventName,ref,workflow,job,took 추가할 수 있음
            mention: here
            if_mention: failure,cancelled
          env:
            SLACK_WEBHOOK_URL: ${{ secrets.DEV_SLACK_WEBHOOK_URL }} # required
          if: always() # Pick up events even if the job fails or is canceled.
  

• deploy.sh

git history 전부 없애고 reset 하는 방법

• git history 를 왜 없애야 할까?
  • 자주있는 일은 아니지만, git history를 전부 날리고 reset 해야 할 때가 있습니다..
  • 예를 들어, 서버의 비밀번호나 암복호화 key, 개인정보 등 노출되면 민감정보나 파일등이 git에 올라가 버렸다면?
  • 해당 내용을 지우고 다시 commit & push를 했지만, history를 보고 이전 commit을 불러오면 그만이므로, 해결책이 될 수 없지요.
  • 아예 history까지 날려버려서 이전의 실수(꼭 실수했을때만 reset 한다고 할 수는 없지만)를 이력까지 지웁시다.

main 혹은 develop등 남겨놓을 브랜치에서 (여기선 main)

• –orphan 은 기존커밋 이력없이…의 의미입니다. 즉, 기존 이력없이 시작하는 브랜치를 하나 만듭니다.

  git checkout --orphan latest_branch
  

새로 커밋

git add .
git commit -m "initial commit after reset"

기존 브랜치 날리고 새로 만듦

git branch -D main
git branch -m main

main에 force push하고 불필요한 내용 정리해서 repo 최적화

git push -f origin main
git gc --aggressive --prune=all

Clean Code 1장

클린 코드의 조건- 내 나름의 정리

• 1장에서는 자바나 C 창시자등 개발계의 거장들이 생각하는 좋은 코드에 대한 견해를 모아놓은 부분입니다.
• 다음은 이 분들의 의견에서 나름 공통적인 부분을 추려서 내 나름대로 정리한 내용입니다.
• 사실상 책 전체에 녹아 있는 내용이기도 합니다.

SARAM

• S : Simple

  • 내 의견 : 코드는 단순해야 합니다. 비즈니스 로직이 코드에 녹아들기 시작하면 프로젝트 자체는 복잡해집니다. 코드(클래스, 메소드 차원)이라도 심플해야 합니다.

• A : Atomic

AES 암복호화를 위한 key생성 코드로 만들기

Contents

AES 암호화 알고리즘에 대하여.

• 암복호화가 가능한 대표적인 양방향 알고리즘입니다.
• 자료상으로 찾아보면 AES(Advanced Encryption Standard)는 대칭 키 암호화 방식의 대표적인 알고리즘으로, 미국 국립표준기술연구소(NIST)에 의해 2001년 표준으로 채택되었습니다. Rijndael 알고리즘을 기반으로 설계되었으며, 높은 보안성과 빠른 성능 덕분에 다양한 보안 애플리케이션에서 널리 사용되고 있습니다.

AES 특징

• 대칭 키 암호화: 동일한 키를 사용하여 데이터를 암호화 및 복호화합니다.
• 고정된 블록 크기: AES는 128비트 블록 크기를 사용합니다.
• 다양한 키 길이 지원: 128비트, 192비트, 256비트 키 길이를 제공합니다.
• 보안성: 기존의 DES(Data Encryption Standard)보다 강력한 보안성을 자랑합니다.
• 빠른 속도: 소프트웨어 및 하드웨어에서 효율적으로 동작합니다.

AES 암호화 과정

• AES 암호화는 여러 라운드(Round)의 연산을 통해 이루어집니다. 사용되는 키 길이에 따라 라운드 수가 달라집니다.