용어 사전
- #{} (MyBatis 파라미터 자리)
- MyBatis SQL 안에서 자바 값이 들어갈 자리를 표시하는 문법이다. #{id} 라고 적으면 MyBatis 가 그 자리를 ? 로 바꾼 PreparedStatement 를 만들고, 실행할 때 id 라는 이름의 값을 거기 끼워 보낸다. 값을 SQL 문자열에 그대로 이어 붙이지 않는다.
- --amend
- 방금 만든 커밋을 지우지 않고, 거기에 빠뜨린 파일이나 메시지를 더해 같은 자리에 다시 덮어쓰는 명령이다. 새 커밋을 쌓는 대신 마지막 커밋 하나를 고쳐 쓴다. 이미 다른 사람이 받아 간 커밋을 amend 하면 그 사람이 가진 기록과 내 기록이 서로 어긋난다.
- --check
- 검사 스크립트를 실제로 고치지 않고 지금 상태가 최신인지만 확인하고 끝내게 만드는 명령행 인자다. 어긋난 곳을 찾으면 실패로 끝나서 그 뒤에 이어지는 배포 같은 자동화를 멈추게 한다. 같은 스크립트를 이 옵션 없이 돌리면 보통 실제로 파일을 고치거나 다시 만든다.
- --debug
- 프로그램을 돌릴 때 붙이는 옵션이다. 붙이면 스프링 부트가 자동 구성 판정 결과를 로그 끝에 전부 찍어 준다. 이 페이지의 271 · 157 · 114 가 거기서 나왔다.
- -ea · -da
- 자바 프로그램을 실행할 때 assert 문이 실제로 검사를 할지 정하는 JVM 옵션이다. -ea(enable assertions)를 주면 assert 문이 조건을 검사해서, 거짓이면 AssertionError를 던진다. -da(disable assertions)를 주거나 아무 옵션도 안 주면 assert 문은 아무 일도 하지 않고 그냥 지나간다 — 기본값이 꺼짐이다.
- -parameters (컴파일 옵션)
- javac에 주는 옵션이다. 켜면 컴파일된 클래스 파일에 「몇 번째 파라미터 이름이 productName이다」 같은 이름 정보가 그대로 남는다. 끄면 이름은 지워지고 arg0 · arg1처럼 번호로만 남는다. Jackson 같은 라이브러리는 이 이름을 보고 JSON 키와 생성자 파라미터를 짝짓는다.
- .dockerignore
- Docker가 이미지를 만들 때 담지 않을 파일·폴더 목록을 적어 두는 파일이다. .gitignore와 비슷한 역할이지만 대상이 Git 커밋이 아니라 Docker 이미지라는 점이 다르다. 여기 적힌 경로는 빌드 컨텍스트 안에 있어도 이미지 안으로 복사되지 않는다.
- .gitattributes
- 파일마다 Git이 다르게 처리해야 할 규칙을 적어 두는 설정 파일이다. 줄바꿈 문자를 통일하거나 특정 파일을 다른 언어로 취급하게 하는 규칙을 여기에 적는다. 사람이 하나하나 맞추지 않아도 저장소를 내려받는 모든 컴퓨터에 같은 규칙이 적용된다.
- .gitignore
- 저장소에 커밋하지 않을 파일 이름을 적어 두는 설정 파일이다. 여기 적힌 이름이나 패턴에 맞는 파일은 git add를 해도 올라가지 않는다. 비밀번호나 토큰처럼 저장소에 남으면 안 되는 값을 담은 파일을 여기 적어 둔다.
- /proc
- 커널이 지금 상태를 파일인 것처럼 보여 주는 가짜 폴더다. ls -l /proc/self/fd 를 치면 지금 열어 둔 것이 나온다. 디스크에 진짜 파일이 있는 것은 아니다.
- 16진수
- 숫자를 0–9 다음에 a(10) b(11) c(12) d(13) e(14) f(15)까지 16개 글자로 적는 방법이다. 두 자리면 「앞자리 × 16 + 뒷자리」다 — 41은 4 × 16 + 1 = 65, 1d는 1 × 16 + 13 = 29. 바이트 두 개로 적은 수는 「앞 바이트 × 256 + 뒤 바이트」다 — 00 41은 65, 01 00은 256. 바이트 하나가 정확히 두 자리라서 파일을 볼 때 쓴다. 앞에 붙은 0x는 16진수라는 표시다.
- 1단 (CLAUDE.md)
- 코딩 표준이 AI에게 닿는 통로를 층으로 나눌 때 가장 위에 있는 자리다. CLAUDE.md처럼 세션을 시작할 때마다 판단 없이 통째로 읽히는 자리를 가리키고, 그 아래 스킬(모델이 부르기로 판단해야만 읽힌다)·rules(정해진 경로의 파일을 다룰 때만 본문이 끼워진다)와 구분된다. 「말하지 않으면 기본값으로 어기게 되는 것」을 이 자리에 둔다.
- 1단 · 2단 · 3단
- 이 블로그의 코딩 표준이 AI 도구에 전달되는 세 단계를 가리키는 말이다. 1단은 CLAUDE.md처럼 항상 읽히는 「항상 적용」 규칙이고, 2단은 특정 파일 경로를 건드릴 때만 불려오는 「규칙」(.claude/rules)이고, 3단은 특정 작업을 할 때만 불려오는 「절차」(.claude/skills)다. 뒤로 갈수록 평소에는 안 보이다가 필요한 순간에만 불려온다.
- 3-way handshake
- TCP 연결을 열 때 주고받는 세 번의 인사다(SYN → SYN+ACK → ACK). 이 셋이 끝나야 연결이 선다.
- 3계층 구조
- 코드를 역할에 따라 Controller · Service · Repository 세 층으로 나누는 구조다. 요청을 받는 일, 업무 규칙을 처리하는 일, DB 를 다루는 일을 각자 다른 층이 맡고, 위층은 바로 아래층만 부른다 — Controller 가 Repository 를 직접 부르지 않고 꼭 Service 를 거친다. 그래서 한 층의 내부를 바꿔도 다른 층은 거의 영향을 받지 않는다.
- 404
- 「그런 주소가 없다」는 HTTP 상태 번호다. 200은 성공, 400은 「보낸 값이 잘못됐다」, 405는 「주소는 있는데 그 방식(GET · POST 등)은 안 받는다」는 뜻이다.
- <foreach>
- MyBatis 매퍼 XML 안에서 리스트를 돌며 SQL 조각을 이어 붙이는 태그다. collection 에 돌 리스트 이름을, item 에 한 칸씩 꺼낸 값을 부를 이름을 적는다. open 은 맨 앞에, close 는 맨 뒤에, separator 는 값과 값 사이에 붙일 글자다. 리스트가 [1, 2, 3] 이면 open="(" separator="," close=")" 로 (1,2,3) 모양이 만들어진다.
- <if> · <where> (MyBatis)
- MyBatis 매퍼 XML 에서 조건에 따라 SQL 조각을 넣거나 빼는 태그다. <if test="조건"> 은 조건이 참일 때만 안쪽 조각을 붙인다. <where> 는 안쪽에 붙은 조각이 하나라도 있을 때만 앞에 WHERE 를 달고, 맨 앞 조각이 AND 나 OR 로 시작하면 그 말을 떼어 낸다. 그래서 WHERE 1=1 같은 늘 참인 조건을 따로 넣지 않아도 된다.
- <sql> · <include>
- MyBatis 매퍼 XML에서 SQL 조각을 한 번 적어 두고 여러 곳에서 끼워 쓰는 태그 한 쌍이다. <sql id="이름"> 안에 조각을 적고, 쓰는 자리에 <include refid="이름"/> 을 두면 MyBatis가 그 자리에 조각을 그대로 붙여 넣는다. 자바에서 겹치는 코드를 메서드로 빼는 것과 같은 목적이다.
- == 과 .equals()
- 둘 다 "같다"를 검사하지만 보는 것이 다르다. ==는 기본형(int, long 등)이면 값을, 객체면 참조(객체가 저장된 주소)를 비교한다. 두 객체가 내용은 같아도 new로 따로 만들어졌다면 ==는 false다. .equals()는 클래스가 정의한 기준으로 "내용이 같은가"를 비교한다 — BigDecimal·String 같은 타입은 값이 같으면 true를 돌려주도록 이미 구현돼 있다. 그래서 숫자나 문자열 같은 객체를 비교할 때는 ==가 아니라 .equals()를 쓴다.
- @Autowired
- 필드나 생성자에 붙여서 「이 자리에 필요한 빈을 스프링이 찾아서 넣어 달라」고 요청하는 표시다. 생성자가 하나뿐이면 이 표시를 안 붙여도 스프링이 알아서 넣어 주기 때문에, 요즘은 생성자 주입에서는 거의 생략한다.
- @BatchSize
- 연관된 데이터를 한 건씩 따로 조회하지 않고, 정해 둔 개수만큼 묶어 IN 쿼리 한 번으로 가져오게 하는 JPA 설정이다. size를 10으로 두면 게시글 10개에 딸린 댓글을 한 개씩 10번 조회하는 대신 IN (1,2,...,10) 같은 쿼리 한 번으로 묶어서 가져온다. join fetch 없이 N+1 문제를 줄이는 방법 중 하나다.
- @Bean
- 내가 직접 쓴 메서드가 돌려주는 객체를 빈으로 등록해 달라고 알리는 표시다. @Component 가 클래스 전체에 붙어 "이 클래스를 통째로 빈으로 만들어라"라고 말하는 것과 달리, @Bean 은 메서드에 붙어 "이 메서드가 만든 결과물을 빈으로 써라"라고 말한다. 내가 수정할 수 없는 남의 클래스를 빈으로 등록할 때 주로 쓴다.
- @Builder
- Lombok 이 제공하는 표시로, 객체를 만들 때 .name("철수").age(10) 처럼 필드 이름을 하나씩 붙여 가며 만들 수 있게 해 준다. 생성자에 값을 순서대로 늘어놓는 방식과 달리, 어떤 값이 무엇인지 이름으로 바로 알아볼 수 있고 일부 필드만 채워 만들기도 쉽다.
- @Component
- 이 클래스를 빈으로 만들어 달라고 표시하는 가장 기본적인 애너테이션이다. @Service, @Controller, @Repository 는 사실 이 표시를 속에 품고 있는 좀 더 구체적인 표시들이다 — 역할 이름만 다를 뿐 "빈으로 만들어라"는 뜻은 같다.
- @Configuration
- 이 클래스 안의 @Bean 메서드들이 Spring이 관리하는 빈을 만드는 설정 클래스라는 표시다. Spring이 애플리케이션을 시작할 때 이 표시가 붙은 클래스를 찾아 그 안의 메서드를 호출해 빈을 등록한다.
- @CreatedBy
- JPA Auditing이 제공하는 표시로, Entity가 처음 저장될 때 "누가 만들었는가"를 AuditorAware가 돌려준 값으로 자동으로 채워 준다. 같은 계열로 수정한 사람을 채우는 @LastModifiedBy가 있다.
- @Data
- Lombok이 제공하는 표시로, @Getter·@Setter·@ToString·@EqualsAndHashCode·@RequiredArgsConstructor를 한 번에 붙인 것과 같은 효과를 낸다. 애너테이션 하나만 붙이면 조회·수정 메서드, 문자열 표현, 같음 비교, 생성자까지 전부 자동으로 생긴다. final 필드에는 수정 메서드를 만들지 않고 그 필드를 생성자가 받는다.
- @Deprecated
- 클래스나 메서드 위에 붙여 "이건 이제 쓰지 말라"고 표시하는 애너테이션(@로 시작하는 표시)이다. 표시만 할 뿐 동작은 바꾸지 않고, 다른 코드가 이걸 쓰면 컴파일러가 경고를 낸다. 괄호 안에는 since(언제부터)와 forRemoval(앞으로 지울 예정인지)만 넣을 수 있고, 왜 쓰지 말아야 하는지와 대신 무엇을 쓸지는 주석(javadoc)의 @deprecated 태그에 적는다.
- @EntityGraph
- Spring Data JPA 의 Repository 메서드에 붙여, 그 메서드로 조회할 때 지정한 연관 데이터까지 처음부터 같이 가져오라고 알리는 표시다. attributePaths 에 필드 이름(예를 들어 comments)을 적는다. JPQL 을 직접 쓰지 않고도 join fetch 와 비슷하게 한 번에 가져온다.
- @Getter
- Lombok 이 제공하는 표시로, 클래스의 모든 필드에 대해 get으로 시작하는 조회 메서드를 자동으로 만들어 준다. private final int status 필드가 있으면 getStatus() 메서드를 손으로 적지 않아도 컴파일할 때 생겨난다.
- @Id · @GeneratedValue
- Entity 클래스에서 어느 필드가 테이블의 기본 키(PK)인지 표시하는 애너테이션이다. `@Id`는 "이 필드가 그 행을 구별하는 값이다"를 알려주고, `@GeneratedValue`를 함께 붙이면 값을 직접 넣지 않아도 DB가 저장할 때 번호를 자동으로 매겨 준다.
- @JsonCreator · @JsonProperty
- Jackson이 JSON을 자바 객체로 되돌릴 때 생성자나 필드 이름을 어떻게 맞출지 알려주는 애너테이션이다. @JsonCreator는 「역직렬화할 때 이 생성자를 써라」, @JsonProperty는 「이 값은 JSON의 이 이름과 짝이다」라는 뜻이다. 필드 이름이 JSON 키와 다르거나 생성자가 여러 개라 Jackson이 헷갈릴 때 붙인다.
- @LastModifiedDate · @PreUpdate
- Entity의 시간 필드를 자동으로 채워주는 두 가지 방법이다. @LastModifiedDate(@CreatedDate도 같은 계열)는 Spring Data JPA Auditing 기능이 Entity가 저장·수정될 때마다 알아서 채워 주는 애너테이션이고, @PreUpdate는 JPA 표준이 제공하는 콜백으로 UPDATE 쿼리가 나가기 직전에 메서드 하나가 자동으로 실행되게 한다. 둘 다 "수정 시각을 기록한다"는 같은 목적을 서로 다른 방식으로 이룬다.
- @NoArgsConstructor
- Lombok이 제공하는 표시로, 아무 값도 받지 않는 생성자(기본 생성자)를 자동으로 만들어 준다. `access = AccessLevel.PRIVATE`을 함께 붙이면 그 생성자를 클래스 밖에서는 못 쓰게 막아, "이 기본 생성자는 프레임워크 전용이고 직접 쓰지 말라"는 뜻으로 쓴다.
- @OneToMany · cascade · orphanRemoval
- 부모 Entity가 자식 컬렉션의 생명주기까지 대신 관리하게 만드는 설정이다. @OneToMany는 "이 필드가 자식 여러 개를 담는 컬렉션"이라는 뜻이고, cascade = CascadeType.ALL은 부모를 저장·삭제할 때 자식도 같이 저장·삭제하라는 뜻이며, orphanRemoval = true는 컬렉션에서 자식을 빼기만 해도(부모와 연결이 끊기면) 그 자식 행을 DB에서 지우라는 뜻이다.
- @Override
- 메서드 위에 붙여 "이건 인터페이스나 부모 클래스에 있는 메서드를 다시 구현한 것이다"라고 표시하는 애너테이션이다. 안 붙여도 동작은 같지만, 붙여 두면 이름이나 매개변수를 잘못 적었을 때 컴파일러가 바로 알려준다 — 원래 메서드와 모양이 다르면 "이건 재정의가 아니다"라고 에러를 낸다.
- @PathVariable
- 주소 안에 박힌 값을 메서드 인자로 받는 표시다. /test/5 에서 5 를 꺼내 준다. 주소의 앞부분은 클래스에 붙인 @RequestMapping("/test") 에서 오고, 뒷부분은 메서드에 붙인 @GetMapping("/{step}") 에서 온다 — 둘이 이어 붙어 /test/{step} 이 된다.
- @PreAuthorize
- 메서드가 시작되기 전에 「이 사람이 이걸 호출할 권한이 있는가」를 검사하는 표시다. @PreAuthorize(「hasRole('ADMIN')」)을 붙이면 관리자 권한이 없는 사람이 호출했을 때 메서드 코드가 한 줄도 실행되지 않고 바로 막힌다.
- @RequestBody
- 요청과 함께 온 JSON 본문을 자바 객체로 바꿔서 메서드 인자로 받는 표시다. 손님이 보낸 글(JSON)을 내가 정한 양식(DTO 클래스)에 맞춰 자동으로 옮겨 적어 주는 것과 같다.
- @RequestParam
- 주소의 물음표 뒤에 붙은 값을 메서드 인자로 받는 표시다. /orders?item=book 에서 book 을 꺼내 준다.
- @RequiredArgsConstructor
- Lombok 이 제공하는 표시로, final 로 선언한 필드만 받는 생성자를 자동으로 만들어 준다. 생성자를 손으로 적지 않아도, 그 생성자를 보고 의존성 주입이 이뤄진다는 점은 똑같다.
- @RestController
- 이 클래스가 Controller 라는 표시(@Controller)와, 메서드가 돌려준 값을 화면(HTML)이 아니라 응답 본문 그대로 내보내라는 표시(@ResponseBody)를 합친 것이다. 그래서 메서드가 객체를 돌려주면 JSON 으로 바뀌어 나간다.
- @RestControllerAdvice
- 모든 Controller 에서 발생한 예외를 한곳에서 받아 처리하는 클래스에 붙이는 표시다. 이 클래스를 Advice 라고 부른다. 안에서 @ExceptionHandler 를 붙인 메서드로 "이 예외가 나면 이렇게 응답한다"를 정해 두면, Controller 마다 try-catch 를 반복해서 쓰지 않아도 된다.
- @Schema
- Swagger 문서에 그 필드의 설명을 적어 두는 애너테이션이다. description에 사람이 읽을 설명을, nullable 같은 속성에 그 필드의 특성을 적으면 Swagger 화면과 OpenAPI 문서에 그대로 나타난다. 코드에는 영향을 주지 않고 문서에만 쓰인다.
- @Slf4j
- Lombok 이 제공하는 표시로, 로그를 남길 때 쓰는 log 라는 이름의 필드를 자동으로 만들어 준다. 이 표시가 없으면 Logger log = LoggerFactory.getLogger(이 클래스.class) 를 직접 써야 하는데, @Slf4j 를 클래스에 붙이면 그 줄 없이 바로 log.warn(...), log.error(...) 를 쓸 수 있다.
- @StepScope
- 스프링이 빈을 하나만 만들어 공유하지 않고, Step이 실행될 때마다 새 인스턴스를 만들게 하는 표시다. Partitioner가 나눈 파티션마다 다른 값(코드 A, 코드 B...)을 가져야 하는 Reader 같은 빈에 붙인다. 이 표시가 없으면 모든 파티션이 같은 인스턴스를 공유해서 값이 서로 뒤섞인다.
- @Transactional
- 메서드나 클래스에 붙이는 표시다. 붙은 메서드가 시작될 때 트랜잭션을 열고, 끝나면 커밋하고, 도중에 예외가 나면 되돌린다. 그 일을 하는 코드는 내 클래스가 아니라 프록시 안에 있다.
- AbortController
- 진행 중인 fetch 요청을 중간에 취소하게 해 주는 브라우저 객체다. 만들어서 controller.signal을 fetch에 넘겨 두고, 나중에 controller.abort()를 부르면 그 요청이 멈추고 fetch가 돌려준 Promise는 AbortError로 실패한다. setTimeout과 함께 쓰면 「몇 초 안에 응답이 없으면 포기」를 만들 수 있다.
- Accept
- 요청을 보내는 쪽이 「나는 이런 형식을 받을 수 있다」고 적어 보내는 항목이다. */* 는 아무거나 좋다는 뜻이고, text/html 이면 HTML을 달라는 뜻이다.
자신만의 철학을 만들어가는 중입니다.
최상단으로 이동했습니다!