#{} (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을 달라는 뜻이다.

자신만의 철학을 만들어가는 중입니다.
최상단으로 이동했습니다!
확대 이미지

조회수: - · -