Study · Spring Boot · STEP 2 / 8 · 올릴 때

자동 구성은 마법이 아니라, 후보 271개에 붙은 조건을 하나씩 검사한 결과다

장면

설정 파일을 한 줄도 안 썼는데 DB도 붙고 웹 서버도 뜬다. 스프링 부트는 무엇을 켜고 무엇을 끌지 어떻게 정했을까?

먼저 알아야 할 말

자동 구성: 내가 설정을 안 적어도 스프링 부트가 지금 클래스패스에 무엇이 있는지 보고 알아서 켜 주는 설정이다. 2단계가 이것만 다룬다.
클래스패스: 자바가 클래스를 찾는 곳의 목록이다. 내가 만든 클래스와 build.gradle 에 적어 받아 온 jar 들이 전부 여기 들어간다. 「클래스패스에 있다」는 「그 클래스를 쓸 수 있다」는 뜻이다.
jar: 여러 클래스 파일을 하나로 묶은 압축 파일이다. 압축 파일이라 안에 폴더와 파일이 들어 있고, 클래스 말고 설정 파일도 같이 넣을 수 있다. 남이 만든 라이브러리는 보통 jar 하나로 받는다. 이 페이지에서 「모듈」이라고 부르는 것도 jar 하나를 말한다.
의존성: 내 프로그램이 돌아가려면 있어야 하는 남의 코드다. build.gradle 에 한 줄 적으면 그 jar 를 받아 클래스패스에 넣어 준다. 이 실측에서 적은 것은 다섯 줄이다 — webmvc(웹 서버와 컨트롤러) · actuator(상태 확인용 주소) · thymeleaf(HTML 만들기) · jdbc(DB 연결) · h2(작은 DB).
애너테이션: @ 로 시작해 클래스나 메서드에 붙이는 표시다. 그 자체로는 아무 일도 하지 않는다. 여기서 읽는 쪽은 스프링이다 — 스프링이 기동할 때 내 클래스들을 훑으며 이 표시를 찾아 보고 무엇을 할지 정한다.
조건 애너테이션: 자동 구성 클래스에 붙어 「언제 켤지」를 적어 두는 표시다. @ConditionalOnClass 는 그 클래스가 클래스패스에 있을 때, @ConditionalOnMissingClass 는 없을 때 켠다. @ConditionalOnMissingBean 은 「내가 같은 종류의 빈을 이미 만들어 뒀으면 켜지 않는다」는 뜻이다 — 내가 직접 만든 것이 자동 구성에 덮이지 않게 해 준다.
빈: 스프링이 대신 만들어서 들고 있다가 필요한 곳에 넣어 주는 객체다. 내가 new 로 만들지 않고 「이게 필요하다」고만 적으면 스프링이 찾아서 넣는다.
aspectj: 메서드를 감싸는 일을 하는 다른 라이브러리다. 이것이 클래스패스에 있으면 스프링은 감쌀 대상을 더 잘게 고를 수 있는 그쪽 장치를 함께 쓰고, 없으면 상속만으로 감싼다(CGLIB). 이 실측에서는 넣지 않았다.
--debug: 프로그램을 돌릴 때 붙이는 옵션이다. 붙이면 스프링 부트가 자동 구성 판정 결과를 로그 끝에 전부 찍어 준다. 이 페이지의 271 · 157 · 114 가 거기서 나왔다.
중첩 클래스: 클래스 안에 또 클래스를 넣은 것이다. AopAutoConfiguration.ClassProxyingConfiguration 처럼 점으로 이어 부르는데, 점 앞이 바깥 클래스이고 점 뒤가 그 안에 든 클래스다. 그래서 둘이 같은 파일에 나란히 있다.
기동: 프로그램을 띄워서 요청을 받을 수 있는 상태가 되기까지를 말한다. 「기동 시간」은 그 사이에 걸린 시간이고, 「기동 로그」는 그동안 프로그램이 찍어 낸 글이다.

아래 재생기의 ▶를 누르면 한 스텝씩 진행된다. 금색 테두리가 방금 바뀐 곳이고, 캡션이 무슨 일이 일어났는지 말해 준다. 굵게 밑줄 친 말은 누르면 뜻이 나온다.

장면 · 무엇을 켤지 정한다 0 / 10

▶를 누르면 설정 파일을 한 줄도 안 쓴 앱에서 무엇이 켜지고 무엇이 꺼지는지, 그것을 누가 정하는지 본다.

키보드 · ← → 한 스텝 · Space 재생/멈춤 · Home 처음

후보 271개에 각자 「언제 켠다」가 미리 적혀 있고, 그 조건을 클래스패스에 비춰 검사한 결과가 157 : 114다. 내가 build.gradle 에 무엇을 적었는지가 그대로 켜짐과 꺼짐을 가른다. 그리고 aspectj 가 없어야 켜지는 쪽과 있어야 켜지는 쪽, 그 한 쌍이 4단계에서 무엇으로 감쌀지를 정한다 — 조건 검사의 결과가 다음 단계의 입력이 된다.

어떻게 확인했나

271 · 157 · 114 는 --debug 를 붙였을 때 로그 끝에 찍히는 CONDITIONS EVALUATION REPORT 에서 센 값이다. Positive matches 와 Negative matches 의 항목 수다.
6 · 7번의 두 클래스(ClassProxyingConfiguration · AspectJAutoProxyingConfiguration)와 그 조건 줄도 같은 보고서에서 그대로 옮겼다.
후보 목록이 모듈 jar 안의 META-INF/spring 아래 imports 파일에 흩어져 있다는 것은 보고서가 아니라 스프링 부트 문서와 jar 안의 파일에서 확인했다.

‹ 이전 다음 단계 ›