독립 실행형 스프링 애플리케이션
스프링 컨테이너 사용
- 스프링 컨테이너는 애플리케이션 로직이 담긴 평범한 자바 오브젝트, 일명 POJO와 구성 정보(Configuration Metadata) 를 런타임에 조합해서 동작하는 최종 애플리케이션을 제작
- 코드로 스프링 컨테이너를 만드는 가장 간단한 방법은 컨테이너를 대표하는 인터페이스인
ApplicationContext를 구현한GenericApplicationContext를 이용하는 것
https://docs.spring.io/spring-framework/docs/5.3.x/javadoc-api/org/springframework/context/support/GenericApplicationContext.html
- 이를 통해서 컨테이너에 등록할 빈 오브젝트 클래스 정보를 직접 등록할 수 있음. 이를 참고해서 컨테이너가 빈 오브젝트를 직접 생성
GenericApplicationContext applicationContext = new GenericApplicationContext();
applicationContext.registerBean(HelloController.class);
applicationContext.refresh();
- 컨테이너에 필요한 정보를 등록하고
refresh()를 이용해서 초기화 작업을 진행 ApplicationContext의getBean()메소드를 이용해서 컨테이너가 관리하는 빈 오브젝트를 가져올 수 있음. 빈의 타입(클래스, 인터페이스) 정보를 이용해서 해당 타입의 빈을 요청
HelloController helloController = applicationContext.getBean(HelloController.class);
의존 오브젝트 추가
- 스프링 컨테이너는 싱글톤 패턴과 유사하게 애플리케이션이 동작하는 동안 딱 하나의 오브젝트만을 만들고 사용함. 이런 면에서 스프링 컨테이너는 싱글톤 레지스트리라고도 함
HelloController가 기능을 의존해서 사용하는SimpleHelloService라는 클래스를 작성. 이 클래스의 오브젝트가 필요한데 일단 이 작업은 HelloController에서 진행
public String hello(String name) {
SimpleHelloService helloService = new SimpleHelloService();
return helloService.sayHello(Objects.requireNonNull(name))
}
Dependency Injection
- 스프링 컨테이너는 DI 컨테이너. 스프링은 DI를 적극적으로 활용해서 만들어져 있고, 스프링을 이용해서 애플리케이션을 개발할 때 DI를 손쉽게 적용할 수 있도록 지원
https://martinfowler.com/articles/injection.html
- Assembler: DI에는 두 개의 오브젝트가 동적으로 의존관계를 가지는 것을 도와주는 제3의 존재
- 스프링 컨테이너는 DI를 가능하게 해주는 어셈블러로 동작
- 이제
SimpleHelloService도 빈으로 등록을 하고 구현한 인터페이스 타입의 의존 오브젝트로HelloController에 주입해서 사용되도록 함. 주입 방식은 컨트롤러의 파라미터를 이용할 수 있음의존 오브젝트 DI 적용
- 의존 오브젝트를 생성자를 통해서 DI 어셈블러인 컨테이너가 주입을 할 수 있게 생성자 파라미터를 정의
- 주입 받은 오브젝트는 내부 멤버 필드로 저장해두고 이용할 수 있음
public class HelloController {
private final HelloService helloService;
public HelloController(HelloService helloService) {
this.helloService = helloService;
}
public String hello(String name) {
return helloService.sayHello(Objects.requireNonNull(name));
}
}
- 주입 받은 의존 오브젝트는 외부에 노출할 필요가 없으니
private으로, 이후 변경될 이유도 없으니final로 정의 - 스프링 컨테이너는 빈 오브젝트 사이의 의존관계를 여러 방법을 통해서 자동으로 파악. 만약 빈 클래스가 단일 생성자를 가지고 있다면 생성자의 파라미터 타입의 빈 오브젝트가 있는지 확인하고, 있다면 이를 생성자 호출시 주입
- 명시적으로 의존 오브젝트를 주입하는 정보를 컨테이너에게 제공하려면
@Autowired와 같은 애노테이션을 지정할 수 있음DispatcherServlet으로 전환
https://docs.spring.io/spring-framework/docs/5.3.x/javadoc-api/org/springframework/web/servlet/DispatcherServlet.html
- 스프링에는 앞에서 만들었던 프론트 컨트롤러와 같은 역할을 담당하는
DispatcherServlet이 있음 DispatcherServlet은 서블릿으로 등록되어서 동작하면서 스프링 컨테이너를 이용해서 요청을 전달할 핸들러인 컨트롤러 오브젝트를 가져와 사용DispatcherServlet이 사용하는 스프링 컨테이너는GenericWebApplicationContext를 이용해서 작성
GenericWebApplicationContext applicationContext = new GenericWebApplicationContext();
applicationContext.registerBean(HelloController.class);
applicationContext.registerBean(SimpleHelloService.class);
applicationContext.refresh();
애노테이션 매핑 정보 사용
DispatcherServlet은 스프링 컨테이너에 등록된 빈 클래스에 있는 매핑 애노테이션 정보를 참고해서 웹 요청을 전달할 오브젝트와 메소드를 선정할 수 있음
@RequestMapping("/hello")
public class HelloController {
...
@GetMapping
@ResponseBody
public String hello(String name) {
return helloService.sayHello(Objects.requireNonNull(name));
}
}
- 클래스 레벨의
@RequestMapping과 메소드 레벨의@GetMapping두 가지의 정보를 조합해서 매핑에 사용할 최종 정보를 생성 - 컨트롤러 메소드의 리턴값을 웹 요청의 바디에 적용하도록
@ResponseBody를 넣어줘야 함. 그렇지 않으면String타입의 응답은 뷰 이름으로 해석하고Thymeleaf와 같은 뷰 템플릿을 찾으려고 하고 404 에러가 나올 수 있음 - 처음 사용한
@RestController는@ResponseBody를 포함하고 있기 때문에 메소드 레벨의@ResponseBody를 넣지 않아도 적용된 것처럼 동작스프링 컨테이너로 통합
- 스프링 컨테이너의 초기화 작업 중에 호출되는 훅 메소드에 서블릿 컨테이너(톰캣)을 초기화하고 띄우는 코드를 삽입
GenericWebApplicationContext applicationContext = new GenericWebApplicationContext() {
@Override
protected void onRefresh() {
super.onRefresh();
ServletWebServerFactory serverFactory = new TomcatServletWebServerFactory();
WebServer webServer = serverFactory.getWebServer(servletContext -> {
servletContext.addServlet("dispatcherServlet",
new DispatcherServlet(this))
.addMapping("/*");
});
webServer.start();
}
};
DispatcherServlet를 생성할 때는 현재 실행중인 메소드가 속한 컨테이너 자체를 전달하면 되기 때문에this를 전달할 수 있음자바 코드 구성 정보 사용
@Bean팩토리 메소드를 사용하면 자바 코드를 이용해서 구성 정보를 만들 수 있음- 자바 코드를 이용하기 때문에 빈 오브젝트를 직접 생성하고 초기화하는 등의 작업을 명시적으로 작성할 수 있음
@Configuration
public class HellobootApplication {
@Bean
public HelloController helloController(HelloService helloService) {
return new HelloController(helloService);
}
@Bean
public HelloService helloService() {
return new SimpleHelloService();
}
@Bean메소드의 리턴 타입은 이 빈을 의존 오브젝트로 주입 받을 다른 빈에서 참조하는 타입(주로 인터페이스)으로 지정하는 것이 좋음- 빈 오브젝트를 생성할 때 주입할 의존 오브젝트는
@Bean메소드의 파라미터로 정의하면 스프링 컨테이너가 이를 전달 @Bean메소드가 있는 클래스에는@Configuration애노테이션을 붙여줘야 함- 자바 코드를 이용한 구성 정보를 사용하려면
AnnotationConfigWebApplicationContext클래스로 컨테이너를 만들어야 함@Component 스캔
- 클래스에 일종의 레이블에 해당하는 애노테이션을 붙여주고, 이를 스캔해서 스프링 컨테이너의 빈으로 자동 등록해주는 방법을 사용할 수 있음
- 애플리케이션의 메인 클래스에는
@ComponentScan애노테이션을 붙임
@Configuration
@ComponentScan
public class HellobootApplication {
- 등록 대상이 될 클래스에는
@Component애노테이션을 붙임 @Component를 메타 애노테이션으로 가지고 있는 애노테이션도 사용할 수 있음- 스프링이 제공하는
@Controller,@RestController,@Service등
- 스프링이 제공하는
@Service
public class SimpleHelloService implements HelloService {
@RestController
public class HelloController {
- 스캔을 통해서 빈을 등록하는 것은 매우 편리하지만 어떤 빈이 등록되는지 확인하려면 번거로울 수 있음
- 메타 애노테이션은 애노테이션에 붙은 애노테이션
- 애노테이션을 정의할 때는
@Retention과@Target을 지정
@Retention과 @Target
@Retention: 애노테이션이 선언된 대상(@Target)의 유지 기간을 결정RetentionPolicy.SOURCE: 자바코드를 컴파일할 때 버림RetentionPolicy.CLASS: JVM이 바이트코드를 해석해서 동작하는 런타임 단계에서 버림RetentionPolicy.RUNTIME: 런타임이 종료되는 시점에서 버림
@Target: 애노테이션이 적용될 대상을 지정TYPE: 클래스, 인터페이스FIELD: 상수 포함 객체 필드METHOD: 메소드PARAMETER: 파라미터
- 메타 애노테이션은 여러 단계로 중첩되기도 함
@RestController은@Controller를 메타 애노테이션으로 가지고 있고,@Controller는@Component를 메타 애노테이션으로 가지고 있음- 이 경우에
@RestController는@Component애노테이션이 붙은 것과 같은 효과를 가짐 @RestController는@Controller외에@ResponseBody도 메타 애노테이션으로 가짐
@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Controller
@ResponseBody
public @interface RestController {
@RestController가 붙은 경우엔DispatcherServlet의 매핑 정보 탐색 대상이 되므로 클래스 레벨에 매핑 애노테이션(@RequestMapping)을 붙이지 않아도 됨Bean의 생명주기 메소드
- 톰캣 서블릿 서버팩토리와
DispatcherServlet도 빈으로 등록한 뒤 가져와 사용할 수 있음 @Bean메소드에서 독립적으로 생성되게 하는 경우DispatcherServlet이 필요로 하는WebApplicationContext타입 컨테이너 오브젝트는 스프링 컨테이너의 빈 생애주기 메소드를 이용해서 주입 받음DispatcherServlet은ApplicationContextAware라는 스프링 컨테이너를 setter 메소드로 주입해주는 메소드를 가진 인터페이스를 구현해놨고, 이런 생애주기 빈 메소드를 가진 빈이 등록되면 스프링은 자신을 직접 주입- 스프링이 제공하는 생애주기 메소드는 다음과 같은 것들이 있음
BeanNameAware's setBeanName BeanClassLoaderAware's setBeanClassLoader BeanFactoryAware's setBeanFactory EnvironmentAware's setEnvironment EmbeddedValueResolverAware's setEmbeddedValueResolver ResourceLoaderAware's setResourceLoader (only applicable when running in an application context) ApplicationEventPublisherAware's setApplicationEventPublisher (only applicable when running in an application context) MessageSourceAware's setMessageSource (only applicable when running in an application context) ApplicationContextAware's setApplicationContext (only applicable when running in an application context) ServletContextAware's setServletContext (only applicable when running in a web application context) postProcessBeforeInitialization methods of BeanPostProcessors InitializingBean's afterPropertiesSet a custom init-method definition postProcessAfterInitialization methods of BeanPostProcessors - 빈 생애주기 메소드를 통해서 주입되는 오브젝트는, 스프링 컨테이너가 스스로 빈으로 등록해서 빈으로 가져와 사용할 수도 있게 함
SpringApplication
- 지금까지 구현한
main()의 코드를MySpringApplication클래스를 만들어run()메소드로 넣고, 메인 클래스를 파라미터로 받아서 사용하도록 만들면, 스프링 부트의main()메소드가 있는 클래스와 유사한 코드가 만들어짐 - 다른 점은 애노테이션이 2개가 붙어있다는 것과 서블릿 컨테이너와
DispatcherServlet을 만드는@Bean메소드가 들어있는 것
@Configuration
@ComponentScan
public class HellobootApplication {
@Bean
public ServletWebServerFactory servletWebServerFactory() {
return new TomcatServletWebServerFactory();
}
@Bean
public DispatcherServlet dispatcherServlet() {
return new DispatcherServlet();
}
public static void main(String[] args) {
MySpringApplication.run(HellobootApplication.class, args);
}
}
MySpringApplication은 스프링 부트의SpringApplication클래스로 교체해도 동일하게 동작