Korobopolly's Dev Blog

Hugo 시작하기 - 설치, 사이트 생성, GitHub Pages 배포

Mon, 16 Feb 2026 14:00:00 +0900

Hugo란?

Hugo는 Go로 작성된 정적 사이트 생성기(Static Site Generator)입니다. 마크다운으로 글을 쓰면 HTML로 변환해주며, 빌드 속도가 매우 빠릅니다.

수천 개의 페이지도 수 초 이내에 빌드
마크다운 기반 콘텐츠 관리
테마와 레이아웃 커스터마이징 자유도 높음
GitHub Pages, Netlify, Vercel 등 다양한 플랫폼에 배포 가능

1. 설치

Windows

# winget
winget install Hugo.Hugo.Extended

# chocolatey
choco install hugo-extended

macOS

brew install hugo

Linux (Ubuntu/Debian)

# snap
sudo snap install hugo

# apt (버전이 오래될 수 있음)
sudo apt install hugo

Linux (직접 설치)

최신 버전이 필요하면 GitHub 릴리즈에서 직접 다운로드합니다.

Git 브랜치 전략 - Git Flow, GitHub Flow, Rebase, Cherry-pick

Mon, 16 Feb 2026 13:25:00 +0900

1. 브랜치란?

브랜치의 개념

브랜치(Branch)는 독립적인 작업 공간을 만들어주는 Git의 핵심 기능입니다. 마치 평행세계처럼 원본 코드에 영향을 주지 않고 새로운 기능을 개발할 수 있습니다.

# 현재 브랜치 확인
git branch

# 모든 브랜치 확인 (원격 포함)
git branch -a

HEAD 포인터

HEAD는 현재 작업 중인 브랜치를 가리키는 포인터입니다.

# HEAD가 가리키는 위치 확인
cat .git/HEAD
# 출력: ref: refs/heads/main

# 특정 커밋으로 HEAD 이동 (detached HEAD 상태)
git checkout <commit-hash>

브랜치 구조 시각화:

암호화 기초 - AES, RSA, 디지털 서명, 패스워드 해싱, 하이브리드 암호화

Mon, 16 Feb 2026 13:25:00 +0900

들어가며

현대 소프트웨어 시스템에서 데이터 보안은 선택이 아닌 필수입니다. 사용자 비밀번호, 개인정보, 금융 데이터 등 민감한 정보를 안전하게 보호하려면 암호화 기술을 올바르게 이해하고 적용해야 합니다.

이 글에서는 대칭키 암호화(AES), 비대칭키 암호화(RSA), 디지털 서명의 원리와 Java 구현을 실전 예제와 함께 다룹니다.

암호화가 필요한 이유

보호해야 할 데이터

저장 데이터(Data at Rest): 데이터베이스의 비밀번호, 개인정보
전송 데이터(Data in Transit): HTTPS 통신, API 요청/응답
처리 데이터(Data in Use): 메모리 상의 민감 정보

암호화 없이 발생하는 문제

// 위험한 예: 평문 저장
String password = "user1234";
db.save("INSERT INTO users (password) VALUES ('" + password + "')");
// DB 유출 시 모든 비밀번호 노출

// 위험한 예: 평문 전송
HttpClient.get("http://api.example.com/user?apiKey=secret123");
// 중간자 공격(MITM)으로 API 키 탈취 가능

암호화 적용 후

// 안전한 예: 암호화 저장
String encrypted = AESUtil.encrypt(password, secretKey);
db.save("INSERT INTO users (password) VALUES ('" + encrypted + "')");
// DB 유출되어도 암호화된 상태

// 안전한 예: HTTPS 사용
HttpClient.get("https://api.example.com/user?apiKey=secret123");
// TLS/SSL로 암호화된 통신

대칭키 암호화 (AES)

같은 키로 암호화와 복호화를 수행하는 방식입니다. 빠르고 효율적이지만 키 공유 문제가 있습니다.

Git 핵심 개념 - 커밋, 되돌리기, Stash, 태그, 원격 저장소

Mon, 16 Feb 2026 13:24:00 +0900

Git이란?

Git은 분산 버전 관리 시스템(Distributed Version Control System)으로, 파일의 변경 이력을 추적하고 여러 개발자가 협업할 수 있도록 도와줍니다.

SVN과의 주요 차이점

특징	Git (분산)	SVN (중앙집중)
저장소 위치	로컬에 전체 이력 저장	중앙 서버에만 이력 저장
오프라인 작업	가능 (커밋, 브랜치 등)	제한적
속도	빠름 (로컬 작업)	느림 (서버 통신 필요)
브랜치 생성	빠르고 가벼움	무겁고 비용이 큼

Git 핵심 개념: 3가지 영역

Git은 파일을 3가지 상태로 관리합니다.

Working Directory → Staging Area → Repository
 (작업 디렉토리) (스테이징 영역) (저장소)
 ↓ ↓ ↓
 git add git commit git push

Working Directory: 실제 파일을 수정하는 공간
Staging Area (Index): 커밋할 변경사항을 준비하는 공간
Repository: 커밋된 스냅샷이 저장되는 공간

기본 명령어

저장소 초기화 및 복제

# 새 Git 저장소 생성
git init

# 원격 저장소 복제
git clone https://github.com/username/repository.git

# 특정 브랜치만 복제
git clone -b develop https://github.com/username/repository.git

변경사항 추적 및 커밋

# 파일 상태 확인
git status

# 파일을 Staging Area에 추가
git add file.txt # 특정 파일
git add . # 현재 디렉토리 모든 변경사항
git add -p # 대화형 모드 (부분 커밋 가능)

# 커밋 생성
git commit -m "커밋 메시지"

# add + commit 한 번에 (추적 중인 파일만)
git commit -am "커밋 메시지"

# 커밋 메시지 수정
git commit --amend

변경사항 확인

# Working Directory vs Staging Area
git diff

# Staging Area vs Repository
git diff --staged

# 특정 파일의 변경사항
git diff file.txt

# 두 커밋 간 차이
git diff commit1 commit2

커밋 히스토리 관리

로그 확인

# 기본 로그
git log

# 한 줄로 보기
git log --oneline

# 그래프로 보기
git log --graph --oneline --all

# 최근 3개 커밋만
git log -3

# 특정 날짜 범위
git log --since="2 weeks ago" --until="yesterday"

# 특정 작성자
git log --author="홍길동"

# 파일별 로그
git log -- file.txt

# 커밋 메시지 검색
git log --grep="버그 수정"

특정 커밋 상세 보기

# 커밋 상세 내용
git show commit-hash

# 특정 파일의 특정 커밋
git show commit-hash:path/to/file.txt

# 각 줄을 마지막으로 수정한 사람 확인
git blame file.txt

# 특정 줄 범위만
git blame -L 10,20 file.txt

되돌리기

reset vs revert vs checkout

# reset: 커밋 히스토리 변경 (로컬 작업에만 사용)
git reset --soft HEAD~1 # 커밋만 취소 (Staging Area 유지)
git reset --mixed HEAD~1 # 커밋 + add 취소 (기본값)
git reset --hard HEAD~1 # 모든 변경사항 삭제 (위험!)

# revert: 새로운 커밋으로 되돌림 (안전, 공유된 브랜치에 사용)
git revert commit-hash

# checkout: 특정 커밋 상태로 이동 (읽기 전용)
git checkout commit-hash

# restore: 파일 되돌리기 (Git 2.23+)
git restore file.txt # Working Directory에서 되돌림
git restore --staged file.txt # Staging Area에서 되돌림

reset 옵션 비교

옵션	HEAD 이동	Staging Area	Working Directory
--soft	O	유지	유지
--mixed	O	초기화	유지
--hard	O	초기화	초기화

실수 복구

# 실수로 reset --hard 했을 때
git reflog # 모든 HEAD 이동 이력 확인
git reset --hard HEAD@{2} # 특정 시점으로 복구

# 삭제된 브랜치 복구
git reflog
git checkout -b recovered-branch HEAD@{3}

.gitignore 작성법

기본 문법

# 주석

# 특정 파일
secret.txt

# 특정 디렉토리
logs/

# 와일드카드
*.log # 모든 .log 파일
*.log.* # .log.로 시작하는 파일

# 예외 처리
*.log
!important.log # important.log는 추적

# 특정 디렉토리의 파일만
/config.json # 루트의 config.json만
**/temp/ # 모든 경로의 temp 디렉토리

언어별 예시

Node.js 프로젝트

JWT 인증 시스템 - Spring Security 통합, Refresh Token, 보안 설정

Mon, 16 Feb 2026 13:24:00 +0900

들어가며

웹 애플리케이션에서 사용자 인증은 가장 기본적이면서도 중요한 기능입니다. 전통적인 세션 기반 인증 방식은 서버에 상태를 저장하기 때문에 확장성과 분산 환경에서 한계가 있습니다. JWT(JSON Web Token)는 이러한 문제를 해결하는 토큰 기반 인증 방식으로, 최근 REST API와 마이크로서비스 환경에서 널리 사용되고 있습니다.

이 글에서는 JWT의 원리부터 Spring Boot와 프론트엔드에서의 실전 구현까지 다룹니다.

세션 기반 vs 토큰 기반 인증

세션 기반 인증

전통적인 방식으로, 서버가 세션 정보를 메모리나 DB에 저장합니다.

1. 사용자 로그인 → 서버가 세션 ID 생성 → 메모리/DB 저장
2. 클라이언트에 세션 ID 쿠키 전송
3. 이후 요청마다 쿠키로 세션 ID 전송 → 서버가 세션 저장소 조회

장점:

GitHub Actions CI/CD - Spring Boot, React, Docker 빌드와 배포

Mon, 16 Feb 2026 13:23:00 +0900

GitHub Actions를 활용하면 코드 푸시부터 배포까지 전 과정을 자동화할 수 있습니다. 이번 포스트에서는 실전에서 바로 사용할 수 있는 CI/CD 파이프라인 구축 방법을 다룹니다.

1. CI/CD 개념 이해하기

CI (Continuous Integration, 지속적 통합)

개발자가 코드를 커밋할 때마다 자동으로 빌드와 테스트를 실행하는 프로세스입니다.

주요 목적:

코드 통합 과정에서 발생하는 버그를 조기 발견
빌드 실패나 테스트 실패를 즉시 파악
코드 품질 유지 및 향상

CD (Continuous Deployment/Delivery, 지속적 배포)

테스트를 통과한 코드를 자동으로 프로덕션 환경에 배포하는 프로세스입니다.

Docker 시작하기 - Dockerfile, Compose, 멀티스테이지 빌드

Mon, 16 Feb 2026 13:22:00 +0900

1. Docker란? - 컨테이너 vs VM

Docker가 등장한 이유

"내 컴퓨터에선 잘 되는데요?" - 개발자라면 한 번쯤 들어본 말입니다. 개발 환경과 운영 환경의 차이로 인한 문제를 해결하기 위해 Docker가 등장했습니다.

컨테이너 vs 가상머신 (VM)

[ VM 구조 ] [ Container 구조 ]
┌──────────────┐ ┌──────────────┐
│ App A │ │ App A │
├──────────────┤ ├──────────────┤
│ Guest OS │ │ Libraries │
├──────────────┤ ├──────────────┤
│ Hypervisor │ │ Docker Engine│
├──────────────┤ ├──────────────┤
│ Host OS │ │ Host OS │
└──────────────┘ └──────────────┘

가상머신 (VM)

소켓 프로그래밍 - Java TCP 통신, 프로토콜 설계, 스레드 분리

Mon, 16 Feb 2026 13:22:00 +0900

네트워크 기초

네트워크 프로그래밍에서 가장 중요한 선택 중 하나는 전송 프로토콜입니다. TCP와 UDP의 차이를 이해하는 것이 첫 번째 단계입니다.

TCP vs UDP

TCP (Transmission Control Protocol)

연결 지향 프로토콜: 3-way handshake로 연결 수립
신뢰성 보장: 패킷 순서 보장, 재전송 메커니즘
흐름 제어와 혼잡 제어
용도: HTTP, 파일 전송, 데이터베이스 연결

UDP (User Datagram Protocol)

비연결 프로토콜: 연결 수립 없이 즉시 전송
신뢰성 미보장: 패킷 손실 가능, 순서 보장 없음
낮은 오버헤드, 빠른 전송 속도
용도: DNS, 스트리밍, 온라인 게임

이 포스트에서는 신뢰성 있는 통신이 필요한 대부분의 애플리케이션에 적합한 TCP를 중심으로 설명합니다.

DB 인덱스와 쿼리 최적화 - EXPLAIN, N+1 문제, 트랜잭션 격리 수준

Mon, 16 Feb 2026 13:21:00 +0900

데이터베이스의 성능을 좌우하는 가장 중요한 요소 중 하나가 바로 인덱스입니다. 이 글에서는 인덱스의 동작 원리부터 실전 최적화 기법까지 단계별로 알아봅니다.

1. 인덱스란?

인덱스는 데이터베이스 테이블의 검색 속도를 높이기 위한 자료구조입니다. 책의 색인(index)처럼 특정 데이터를 빠르게 찾을 수 있도록 도와줍니다.

B-Tree 구조

대부분의 RDBMS는 B-Tree(Balanced Tree) 구조를 사용합니다.

 [50]
 / \
 [25] [75]
 / \ / \
[10] [30] [60] [90]

B-Tree의 특징:

균형 잡힌 트리 구조로 탐색 시간이 O(log N)
루트 노드에서 시작해 리프 노드까지 탐색
데이터가 정렬된 상태로 유지됨

왜 빠른가?

React E2E 테스트 - Playwright 설정, Locator, 네트워크 모킹, CI 통합

Mon, 16 Feb 2026 13:21:00 +0900

E2E 테스트는 실제 사용자 관점에서 애플리케이션을 검증합니다. 이번 글에서는 Playwright를 활용한 React 애플리케이션 E2E 테스트 작성법을 알아봅니다.

E2E 테스트란

테스트 피라미드

소프트웨어 테스트는 세 가지 레벨로 나뉩니다.

 /\
 / \ E2E 테스트 (적음, 느림, 비용 높음)
 /____\
 / \ 통합 테스트 (중간)
 /________\
 / \ 단위 테스트 (많음, 빠름, 비용 낮음)
 /____________\

단위 테스트 (Unit Test):

개별 함수, 컴포넌트 테스트
빠르고 격리된 환경
예: sum(1, 2) === 3

통합 테스트 (Integration Test):

React 상태 관리 - Context API, Provider 패턴, Redux vs Zustand 비교

Mon, 16 Feb 2026 13:20:00 +0900

Props drilling 문제를 겪어보신 적 있나요? 컴포넌트가 깊어질수록 상태를 여러 단계에 걸쳐 전달해야 하는 문제가 발생합니다. 이번 글에서는 전역 상태 관리 아키텍처 패턴과 실전 Context 조합 전략, 그리고 프로젝트 규모에 맞는 상태 관리 솔루션 선택 방법을 알아봅니다.

상태 관리의 필요성

Props Drilling 문제

중간 컴포넌트들이 실제로 사용하지 않는 props를 단순히 아래로 전달만 하는 상황입니다.

// Props Drilling 예시
function App() {
 const [user, setUser] = useState(null);

 return <Layout user={user} setUser={setUser} />;
}

function Layout({ user, setUser }) {
 return (
 <div>
 <Header user={user} setUser={setUser} />
 <Main user={user} />
 </div>
 );
}

function Header({ user, setUser }) {
 return <UserMenu user={user} setUser={setUser} />;
}

function UserMenu({ user, setUser }) {
 // 실제로 사용하는 곳은 여기
 return user ? (
 <button onClick={() => setUser(null)}>로그아웃</button>
 ) : (
 <button onClick={() => setUser({ name: '홍길동' })}>로그인</button>
 );
}

중간 컴포넌트들은 user와 setUser를 직접 사용하지 않지만 전달만 하고 있습니다. 이것이 Props Drilling 문제입니다.

Spring Boot WebSocket - STOMP 프로토콜과 실시간 통신 구현

Mon, 16 Feb 2026 13:20:00 +0900

HTTP 폴링 vs WebSocket

실시간 통신을 구현하는 방법은 크게 두 가지입니다.

HTTP 폴링 (Polling)

클라이언트가 주기적으로 서버에 요청을 보내 새 데이터를 확인합니다.

// Short Polling
setInterval(() => {
 fetch('/api/messages')
 .then(res => res.json())
 .then(data => updateUI(data));
}, 1000); // 1초마다 요청

단점:

불필요한 요청이 많음 (데이터가 없어도 요청)
서버 부하 증가 (동시 접속자 1000명 = 초당 1000건 요청)
실시간성 낮음 (폴링 간격만큼 지연)

Long Polling

서버가 새 데이터가 있을 때까지 응답을 보류합니다.

SQL 기초 - DDL, DML, JOIN, 서브쿼리, 데이터 모델링

Mon, 16 Feb 2026 13:20:00 +0900

관계형 데이터베이스 개념

관계형 데이터베이스(RDBMS)는 데이터를 테이블 형태로 저장하고 관리합니다.

핵심 용어

테이블(Table): 데이터를 저장하는 구조 (엑셀의 시트와 유사)
행(Row): 하나의 레코드 (데이터 항목)
열(Column): 속성 또는 필드
기본키(Primary Key): 각 행을 고유하게 식별하는 열 (중복 불가, NULL 불가)
외래키(Foreign Key): 다른 테이블의 기본키를 참조하는 열

-- 예시: users 테이블
-- id (기본키), name, email, created_at (열)
-- 각 행은 한 명의 사용자 데이터

DDL (Data Definition Language)

테이블 구조를 정의하는 명령어입니다.

Spring Boot 캐싱 - Caffeine, @Cacheable, TTL 전략

Mon, 16 Feb 2026 13:19:00 +0900

캐싱이란

캐싱(Caching)은 자주 사용되는 데이터를 빠르게 접근할 수 있는 임시 저장소에 보관하는 기술입니다. 데이터베이스 조회, 외부 API 호출, 복잡한 연산 결과 등을 메모리에 저장하여 동일한 요청에 대해 빠르게 응답할 수 있습니다.

왜 캐싱이 필요한가

성능 향상

데이터베이스 조회는 일반적으로 수십~수백 밀리초가 걸리지만, 메모리 캐시는 마이크로초 단위로 응답합니다.

// 캐시 없이 매번 DB 조회
public User getUser(Long id) {
 return userRepository.findById(id).orElseThrow(); // 평균 50ms
}

// 캐시 적용
@Cacheable("users")
public User getUser(Long id) {
 return userRepository.findById(id).orElseThrow(); // 첫 조회 50ms, 이후 0.1ms
}

비용 절감

외부 API 호출이나 복잡한 연산을 캐싱하면 서버 리소스와 비용을 절감할 수 있습니다.

Spring Boot 이벤트 아키텍처 - @EventListener, @Async, 트랜잭션 이벤트

Mon, 16 Feb 2026 13:18:00 +0900

이벤트 기반 아키텍처란

이벤트 기반 아키텍처(Event-Driven Architecture)는 시스템의 컴포넌트들이 이벤트를 통해 상호작용하는 설계 패턴입니다. 특정 작업이 완료되었을 때 이벤트를 발행하고, 관심 있는 컴포넌트가 이를 구독하여 처리하는 방식입니다.

전통적인 방식에서는 서비스 A가 서비스 B, C, D를 직접 호출했다면, 이벤트 기반 방식에서는 서비스 A가 이벤트만 발행하고, B, C, D가 각자 필요한 이벤트를 구독하여 처리합니다.

왜 이벤트 기반 아키텍처인가

서비스 간 결합도 감소

직접 호출 방식의 문제점:

@Service
public class UserService {
 private final EmailService emailService;
 private final NotificationService notificationService;
 private final AuditService auditService;
 private final AnalyticsService analyticsService;

 public void registerUser(User user) {
 userRepository.save(user);

 // 모든 서비스를 직접 호출
 emailService.sendWelcomeEmail(user);
 notificationService.sendPushNotification(user);
 auditService.logUserRegistration(user);
 analyticsService.trackUserSignup(user);
 }
}

위 코드는 UserService가 4개의 서비스에 강하게 결합되어 있습니다. 새로운 기능 추가 시마다 UserService를 수정해야 합니다.

Java 동시성 프로그래밍 - ExecutorService, 동기화, Context Switching

Mon, 16 Feb 2026 13:16:00 +0900

동시성 프로그래밍이란

현대 애플리케이션은 여러 작업을 동시에 처리해야 합니다. 파일 업로드를 받으면서 DB 쿼리를 실행하고, API 요청을 처리하는 등 멀티태스킹은 필수입니다. Java는 강력한 동시성 라이브러리를 제공하여 이런 작업을 안전하고 효율적으로 처리할 수 있게 합니다.

이 글에서는 Thread 기본부터 ThreadPool, 동기화 메커니즘까지 실전 예제와 함께 알아봅니다.

Thread와 Runnable 기본

Thread 생성 방법

Java에서 스레드를 생성하는 두 가지 방법이 있습니다.

1. Thread 클래스 상속

public class MyThread extends Thread {
 @Override
 public void run() {
 System.out.println("Thread 실행: " + Thread.currentThread().getName());
 }
}

// 사용
MyThread thread = new MyThread();
thread.start();

2. Runnable 인터페이스 구현 (권장)

Java 디자인 패턴 - Singleton, Builder, Observer, Strategy 구현

Mon, 16 Feb 2026 13:15:00 +0900

디자인 패턴이란

디자인 패턴은 소프트웨어 설계에서 반복적으로 나타나는 문제들에 대한 재사용 가능한 해결책입니다. "바퀴를 다시 발명하지 마라"는 원칙처럼, 검증된 설계 방법을 배우고 적용하면 유지보수가 쉽고 확장 가능한 코드를 작성할 수 있습니다.

이 글에서는 실무에서 자주 쓰이는 핵심 패턴들을 Java 코드와 함께 알아봅니다.

디자인 패턴의 분류

GoF(Gang of Four)는 23가지 패턴을 세 가지로 분류했습니다:

생성 패턴 (Creational): 객체 생성 방식 - Singleton, Builder, Factory
구조 패턴 (Structural): 객체 조합 방식 - Facade, Adapter, Decorator
행위 패턴 (Behavioral): 객체 간 통신 방식 - Observer, Strategy, Template Method

모든 패턴을 외울 필요는 없습니다. 문제를 만났을 때 "이 상황에 맞는 패턴이 있나?"를 떠올릴 수 있으면 충분합니다.

React Hooks 심화 - useEffect, useMemo, useReducer, 커스텀 Hook

Mon, 16 Feb 2026 13:15:00 +0900

React Hooks란?

Hooks는 함수형 컴포넌트에서 상태 관리, 사이드 이펙트 처리, 성능 최적화 등을 가능하게 하는 함수입니다. React 16.8에서 도입되어 현재 React 개발의 핵심이 되었습니다.

Hooks 규칙

최상위에서만 호출: 조건문, 반복문, 중첩 함수 내에서 호출 금지
React 함수 내에서만 호출: 일반 JavaScript 함수에서 호출 금지

// 잘못된 사용
function BadExample() {
 if (someCondition) {
 const [value, setValue] = useState(""); // 조건문 안에서 호출 금지
 }
}

// 올바른 사용
function GoodExample() {
 const [value, setValue] = useState("");

 if (someCondition) {
 // Hook이 아닌 로직은 조건문 안에서 사용 가능
 }
}

useEffect - 사이드 이펙트 처리

기본 사용법

import { useState, useEffect } from "react";

function UserProfile({ userId }: { userId: number }) {
 const [user, setUser] = useState<User | null>(null);
 const [loading, setLoading] = useState(true);

 useEffect(() => {
 // 사이드 이펙트 실행
 setLoading(true);
 fetch(`/api/users/${userId}`)
 .then((res) => res.json())
 .then((data) => {
 setUser(data);
 setLoading(false);
 });
 }, [userId]); // userId가 변경될 때만 실행

 if (loading) return <p>로딩 중...</p>;
 if (!user) return <p>사용자를 찾을 수 없습니다.</p>;

 return (
 <div>
 <h2>{user.name}</h2>
 <p>{user.email}</p>
 </div>
 );
}

의존성 배열 패턴

function EffectPatterns() {
 const [count, setCount] = useState(0);

 // 1. 마운트 시 1회만 실행
 useEffect(() => {
 console.log("컴포넌트 마운트");
 }, []);

 // 2. 특정 값 변경 시 실행
 useEffect(() => {
 console.log("count 변경:", count);
 }, [count]);

 // 3. 매 렌더링마다 실행 (의존성 배열 생략)
 useEffect(() => {
 console.log("렌더링됨");
 });

 return <button onClick={() => setCount(count + 1)}>{count}</button>;
}

클린업 함수

컴포넌트 언마운트 시 또는 이펙트 재실행 전에 정리 작업을 수행합니다.

Java Stream API - filter, map, collect와 병렬 스트림

Mon, 16 Feb 2026 13:14:00 +0900

Stream API란?

Java 8에서 도입된 Stream API는 컬렉션 데이터를 함수형 스타일로 처리할 수 있게 해주는 강력한 도구입니다. Stream을 사용하면 데이터를 선언적으로 처리하고, 병렬 처리를 쉽게 구현할 수 있으며, 코드의 가독성을 크게 향상시킬 수 있습니다.

Stream은 데이터의 흐름을 나타내며, 원본 데이터를 변경하지 않고 중간 연산과 최종 연산을 통해 데이터를 처리합니다. 이러한 특성 덕분에 불변성을 유지하면서도 효율적인 데이터 처리가 가능합니다.

Stream 생성 방법

Stream을 생성하는 다양한 방법이 있습니다.

컬렉션으로부터 생성

List<String> list = Arrays.asList("Apple", "Banana", "Cherry");
Stream<String> stream = list.stream();

// 병렬 스트림
Stream<String> parallelStream = list.parallelStream();

배열로부터 생성

String[] array = {"Apple", "Banana", "Cherry"};
Stream<String> stream = Arrays.stream(array);

// 범위 지정
int[] numbers = {1, 2, 3, 4, 5};
IntStream stream = Arrays.stream(numbers, 1, 4); // 2, 3, 4

Stream.of() 사용

Stream<String> stream = Stream.of("Apple", "Banana", "Cherry");
Stream<Integer> numberStream = Stream.of(1, 2, 3, 4, 5);

범위 생성

// 1부터 10까지 (10 포함)
IntStream range = IntStream.rangeClosed(1, 10);

// 1부터 10까지 (10 미포함)
IntStream range2 = IntStream.range(1, 10);

무한 스트림 생성

// iterate: 초기값부터 시작해서 함수를 반복 적용
Stream<Integer> evenNumbers = Stream.iterate(0, n -> n + 2);

// generate: 매번 새로운 값을 생성
Stream<Double> randomNumbers = Stream.generate(Math::random);

// 무한 스트림은 limit()으로 제한 필요
Stream<Integer> first10Evens = Stream.iterate(0, n -> n + 2).limit(10);

중간 연산 (Intermediate Operations)

중간 연산은 Stream을 반환하므로 여러 개를 연결(chaining)할 수 있습니다. 중간 연산은 지연 평가(lazy evaluation)되어 최종 연산이 호출될 때까지 실행되지 않습니다.

React 시작하기 - JSX, 컴포넌트, Props, State, 이벤트 처리

Mon, 16 Feb 2026 13:14:00 +0900

React란?

React는 Meta(구 Facebook)에서 개발한 UI 라이브러리입니다. 컴포넌트 기반 아키텍처로 복잡한 UI를 독립적이고 재사용 가능한 조각으로 나누어 개발할 수 있습니다.

React의 핵심 특징

컴포넌트 기반: UI를 독립적인 컴포넌트로 분리하여 관리
선언적 UI: 상태에 따라 UI가 자동으로 업데이트
Virtual DOM: 효율적인 렌더링으로 성능 최적화
단방향 데이터 흐름: 예측 가능한 데이터 관리
풍부한 생태계: Next.js, React Native 등 확장 가능

프로젝트 생성

Vite로 React 프로젝트 생성

# Vite로 React + TypeScript 프로젝트 생성
npm create vite@latest my-react-app -- --template react-ts

# 프로젝트 디렉토리로 이동
cd my-react-app

# 의존성 설치
npm install

# 개발 서버 시작
npm run dev

프로젝트 구조

my-react-app/
├── public/
│ └── vite.svg
├── src/
│ ├── assets/
│ ├── App.tsx
│ ├── App.css
│ ├── main.tsx
│ └── index.css
├── index.html
├── package.json
├── tsconfig.json
└── vite.config.ts

핵심 파일 설명:

Spring Boot REST API - Controller, JPA CRUD, 예외 처리

Mon, 16 Feb 2026 13:13:00 +0900

REST API 설계 원칙

RESTful API는 HTTP 프로토콜을 기반으로 자원(Resource)을 URI로 표현하고, HTTP 메서드로 작업을 정의하는 아키텍처 스타일입니다. Spring Boot는 REST API 개발을 위한 강력한 기능을 제공합니다.

REST의 핵심 원칙

1. 자원 기반 URI 설계

명사를 사용하여 자원을 표현: /users, /products
계층 구조 표현: /users/{id}/orders
복수형 사용 권장: /users (O), /user (X)

2. HTTP 메서드 활용

GET: 조회
POST: 생성
PUT: 전체 수정
PATCH: 부분 수정
DELETE: 삭제

3. 상태 코드 활용

Spring Boot 시작하기 - 프로젝트 생성, 구조, 첫 실행

Mon, 16 Feb 2026 13:12:00 +0900

Spring Boot란 무엇인가?

Spring Boot는 Spring 프레임워크를 기반으로 한 오픈소스 Java 프레임워크입니다. Spring의 강력한 기능을 그대로 사용하면서도, 복잡한 설정 없이 빠르게 프로덕션 레벨의 애플리케이션을 만들 수 있도록 설계되었습니다.

Spring vs Spring Boot

전통적인 Spring Framework의 경우:

XML 기반의 복잡한 설정 파일 필요
의존성 버전 관리를 직접 해야 함
서버 배포를 위한 WAR 파일 생성 및 Tomcat 설치 필요
설정 코드가 비즈니스 로직보다 많아지는 경우 발생

Spring Boot는 이러한 문제를 해결합니다:

Lombok 핵심 어노테이션 - @Data, @Builder, Spring Boot 실전 패턴

Mon, 16 Feb 2026 13:11:00 +0900

Lombok이란

Java로 개발하다 보면 getter, setter, 생성자, toString, equals 같은 반복적인 코드를 매번 작성해야 합니다. Lombok은 어노테이션만으로 이런 보일러플레이트 코드를 컴파일 시점에 자동 생성해주는 라이브러리입니다.

Lombok 없이 vs 있을 때

Lombok 없이:

public class User {
 private Long id;
 private String name;
 private String email;

 public User() {}

 public User(Long id, String name, String email) {
 this.id = id;
 this.name = name;
 this.email = email;
 }

 public Long getId() { return id; }
 public void setId(Long id) { this.id = id; }
 public String getName() { return name; }
 public void setName(String name) { this.name = name; }
 public String getEmail() { return email; }
 public void setEmail(String email) { this.email = email; }

 @Override
 public String toString() {
 return "User{id=" + id + ", name=" + name + ", email=" + email + "}";
 }

 @Override
 public boolean equals(Object o) { /* ... */ }

 @Override
 public int hashCode() { /* ... */ }
}

Lombok 사용:

Java 17+ 최신 문법 - Record, Sealed Class, Pattern Matching, Virtual Thread

Mon, 16 Feb 2026 13:10:00 +0900

개요

Java는 6개월마다 새로운 버전을 출시하며 지속적으로 발전하고 있습니다. Java 17은 LTS(Long-Term Support) 버전으로, 이후 Java 21도 LTS로 지정되었습니다. 이 글에서는 Java 17 이상에서 도입된 주요 기능들을 실제 코드 예제와 함께 살펴보겠습니다.

1. Sealed Classes (봉인 클래스)

Sealed Classes는 Java 17에서 정식 기능으로 추가되었으며, 클래스 계층 구조를 명시적으로 제어할 수 있게 해줍니다. 어떤 클래스가 특정 클래스를 상속할 수 있는지를 제한함으로써 더 안전하고 예측 가능한 코드를 작성할 수 있습니다.

기본 문법

public sealed class Shape
 permits Circle, Rectangle, Triangle {
 // 공통 메서드
}

public final class Circle extends Shape {
 private final double radius;

 public Circle(double radius) {
 this.radius = radius;
 }

 public double area() {
 return Math.PI * radius * radius;
 }
}

public final class Rectangle extends Shape {
 private final double width;
 private final double height;

 public Rectangle(double width, double height) {
 this.width = width;
 this.height = height;
 }

 public double area() {
 return width * height;
 }
}

public non-sealed class Triangle extends Shape {
 // 다른 클래스가 Triangle을 상속할 수 있음
}

주요 특징

sealed 키워드로 봉인 클래스 선언
permits 절로 허용할 하위 클래스 명시
하위 클래스는 반드시 final, sealed, non-sealed 중 하나로 선언
도메인 모델링 시 타입 안전성 향상

2. Pattern Matching (패턴 매칭)

instanceof 패턴 매칭

기존의 instanceof 검사 후 캐스팅하는 번거로운 과정을 간소화합니다.

OMC Team과 Pipeline - 멀티 에이전트 협업, 태스크 관리, 순차 체이닝

Mon, 16 Feb 2026 13:09:00 +0900

멀티 에이전트 협업의 필요성

복잡한 소프트웨어 프로젝트는 단일 개발자가 모든 것을 처리하기 어렵습니다. 프론트엔드, 백엔드, 데이터베이스, 테스트, 배포 등 각 영역은 서로 다른 전문성을 요구합니다. OMC의 Team과 Pipeline 모드는 이러한 현실을 AI 에이전트 세계에 그대로 적용합니다.

여러 전문 에이전트가 각자의 역할을 수행하고, 서로 통신하며, 의존성을 관리하고, 최종 목표를 향해 협업합니다. 마치 실제 개발팀처럼 작동하는 AI 팀을 구성할 수 있습니다.

Team 모드 - 조직화된 협업

Team 모드는 Claude Code의 네이티브 팀 기능을 활용하여 여러 에이전트를 조직화하고 협업시킵니다.

OMC Ecomode와 Ultrawork - 토큰 절약 모드, 병렬 처리 엔진

Mon, 16 Feb 2026 13:08:00 +0900

실행 모드의 중요성

oh-my-claudecode(OMC)는 다양한 실행 모드를 제공하여 작업의 특성에 따라 최적의 전략을 선택할 수 있습니다. 그 중에서도 Ecomode와 Ultrawork는 서로 다른 목표를 가진 두 가지 핵심 모드입니다.

Ecomode: 토큰 비용을 최소화하면서 합리적인 성능 유지
Ultrawork: 실행 속도를 최대화하기 위한 공격적인 병렬 처리

이 두 모드를 이해하고 적절히 활용하면 비용과 성능 사이의 균형을 프로젝트 요구사항에 맞게 조정할 수 있습니다.

Ecomode: 토큰 효율적 실행

Ecomode란?

Ecomode는 가능한 한 적은 토큰을 사용하면서도 작업을 완수하는 것을 목표로 하는 실행 모드입니다. Claude 모델의 계층 구조를 활용하여 작업의 복잡도에 따라 적절한 모델을 자동 선택합니다.

OMC Autopilot과 Ralph - 자동 실행 모드와 검증 루프

Mon, 16 Feb 2026 13:07:00 +0900

자동화된 개발의 시작

OMC의 가장 강력한 기능은 개발 과정 전체를 자동화하는 실행 모드들입니다. Autopilot은 아이디어에서 완성된 코드까지의 전체 여정을 자동으로 처리하고, Ralph는 작업이 완벽하게 완료될 때까지 반복 검증합니다.

이 두 모드는 완전 자동화와 품질 보장이라는 각각의 강점을 가지고 있으며, 작업의 성격에 따라 적절히 선택하면 개발 생산성을 획기적으로 향상시킬 수 있습니다.

Autopilot - 완전 자동 개발

Autopilot은 사용자의 요청을 받아 분석부터 구현, 테스트, 검증까지 전체 개발 사이클을 자동으로 수행합니다.

기본 사용법

/autopilot "JWT 기반 사용자 인증 API를 만들어줘"

단 한 줄의 명령으로 Autopilot은 다음 워크플로우를 자동 실행합니다.

oh-my-claudecode 소개 - 에이전트 카탈로그, 모델 라우팅, 상태 관리

Mon, 16 Feb 2026 13:06:00 +0900

OMC란 무엇인가

oh-my-claudecode(OMC)는 Claude Code를 위한 멀티 에이전트 오케스트레이션 레이어입니다. Claude Code의 기본 기능 위에서 동작하며, Hooks와 MCP(Model Context Protocol) 도구를 활용하여 복잡한 소프트웨어 개발 작업을 여러 전문화된 AI 에이전트들이 협업하여 처리할 수 있도록 합니다.

단일 AI 에이전트가 모든 작업을 처리하는 대신, OMC는 각 작업의 특성에 맞는 전문 에이전트에게 업무를 위임합니다. 코드 탐색, 아키텍처 설계, 구현, 테스트, 검증, 리뷰 등 각 단계마다 최적화된 에이전트가 투입되어 작업의 품질과 효율성을 극대화합니다.

Quick Start

Step 1: Install

Claude Code 플러그인 마켓플레이스에서 설치합니다.

Claude Code Plan Mode - 워크플로우, 설계 계획 수립, 활용 팁

Mon, 16 Feb 2026 13:05:00 +0900

Plan Mode란 무엇인가

Claude Code의 Plan Mode는 복잡한 코드 변경 작업을 시작하기 전에 체계적인 설계와 탐색을 수행할 수 있는 특별한 작업 모드입니다. EnterPlanMode 도구를 통해 진입하며, 이 모드에서는 코드를 직접 수정하지 않고 코드베이스를 탐색하고 설계 문서를 작성하는 데 집중합니다.

Plan Mode의 핵심 철학은 "생각 먼저, 구현은 나중에"입니다. 특히 멀티파일 변경이나 아키텍처 결정이 필요한 상황에서 성급한 코드 수정으로 인한 시행착오를 크게 줄일 수 있습니다.

Plan Mode를 사용해야 하는 시나리오

Plan Mode는 모든 작업에 필요한 것은 아닙니다. 다음과 같은 경우에 특히 유용합니다.

Claude Code MCP 서버 - 설정, 주요 서버 소개, 커스텀 서버 구축

Mon, 16 Feb 2026 13:04:00 +0900

MCP란 무엇인가

MCP(Model Context Protocol)는 AI 모델과 외부 도구를 연결하는 표준 프로토콜입니다. Claude Code는 MCP를 통해 파일 시스템, 데이터베이스, 웹 API, 문서 검색 엔진 등 다양한 외부 서비스와 통합할 수 있습니다.

기본적으로 Claude Code는 코드 읽기, 쓰기, 실행 등의 기능을 제공하지만, MCP 서버를 추가하면 이러한 능력을 무한히 확장할 수 있습니다. 예를 들어, Context7 MCP 서버를 연결하면 최신 라이브러리 문서를 실시간으로 검색할 수 있고, Exa MCP 서버를 통해 웹 검색 결과를 활용할 수 있습니다.

Claude Code Hooks - 이벤트 타입, 자동 린팅, 조건부 실행 설정

Mon, 16 Feb 2026 13:03:00 +0900

Hooks 시스템 개요

Claude Code의 Hooks는 도구 실행의 특정 시점에 자동으로 쉘 명령을 실행할 수 있는 자동화 메커니즘입니다. 파일을 편집할 때마다 자동으로 린팅을 실행하거나, 세션 시작 시 프로젝트 컨텍스트를 로딩하거나, 특정 도구 호출 후 알림을 보내는 등 다양한 자동화가 가능합니다.

Hooks는 개발 워크플로우를 크게 개선할 수 있습니다. 반복적인 작업을 자동화하고, 코드 품질을 즉각적으로 검증하며, 작업 흐름을 방해하지 않으면서도 필요한 체크를 수행할 수 있습니다.

Hook 이벤트 타입

Claude Code는 네 가지 주요 이벤트 타입을 제공합니다.

Claude Code 커스텀 슬래시 커맨드 - 커맨드 파일 구조와 실전 예제

Mon, 16 Feb 2026 13:02:00 +0900

슬래시 커맨드란?

Claude Code에서 슬래시 커맨드(Slash Command)는 /commit, /plan, /review처럼 /로 시작하는 단축 명령어입니다. 이 커맨드들은 복잡한 작업 지시를 간단한 한 줄로 실행할 수 있게 해주며, 반복적인 작업을 자동화하는 강력한 도구입니다.

내장 커맨드 외에도 프로젝트별로 커스텀 슬래시 커맨드를 정의하여 팀의 워크플로우에 맞는 자동화를 구축할 수 있습니다.

커스텀 커맨드의 필요성

반복 작업의 문제

다음과 같은 상황을 생각해봅시다:

"새 블로그 포스트를 만들어줘. 제목은 [title]이고, 날짜는 오늘,
태그는 [tags], 시리즈는 [series]로 설정하고,
/content/posts/ 디렉토리에 slug 형식으로 파일명 만들고,
프론트매터는 기존 포스트 형식 따라서..."

이런 지시를 매번 반복하는 것은 비효율적입니다. 커스텀 커맨드를 만들면:

CLAUDE.md - 프로젝트 규칙, 코딩 컨벤션, 워크플로우 설정

Mon, 16 Feb 2026 13:01:00 +0900

CLAUDE.md란?

CLAUDE.md는 Claude Code에게 프로젝트별 컨텍스트와 작업 지침을 전달하는 특수한 마크다운 파일입니다. 이 파일을 프로젝트 루트에 두면 Claude Code가 세션 시작 시 자동으로 읽어들여 프로젝트의 규칙, 코딩 스타일, 아키텍처 결정사항 등을 이해하고 작업에 반영합니다.

전역 설정 파일인 ~/.claude/CLAUDE.md와 달리, 프로젝트 루트의 CLAUDE.md는 해당 프로젝트에만 적용되며 팀원 간 공유가 가능하여 일관된 개발 경험을 제공합니다.

CLAUDE.md의 주요 역할

1. 프로젝트 컨텍스트 제공

Claude Code에게 프로젝트의 목적, 기술 스택, 디렉토리 구조 등을 명시적으로 알려줄 수 있습니다.

소개

Mon, 16 Feb 2026 00:00:00 +0000

이 블로그에 대해

실전 개발에 필요한 기술을 정리하는 기술 블로그입니다. AI 도구 활용법부터 백엔드, 프론트엔드까지 실무에서 바로 쓸 수 있는 내용을 다룹니다.

다루는 주제

AI 개발 도구

Claude Code: Plan Mode, MCP 서버, Hooks 자동화, 컨텍스트 관리
oh-my-claudecode(OMC): 멀티 에이전트 오케스트레이션, Autopilot, Team 모드

백엔드

Java: 최신 기능 (Sealed Classes, Records, Virtual Threads), Stream API
Spring Boot: 프로젝트 설정, REST API, JPA 연동

프론트엔드

React: 컴포넌트, JSX, Hooks, 상태 관리, 커스텀 훅

대상 독자

실전 개발 기술을 체계적으로 정리하고 싶은 개발자
AI 코딩 도구를 활용한 생산성 향상에 관심이 있는 분
Java, Spring Boot, React를 배우거나 복습하고 싶은 분

연락처

GitHub: korobopolly