JUnit4 #1

💙 @RunWith(SpringRunner.class)

JUnit이 테스트를 실행할 때 Spring의 테스트 지원 기능을 사용하도록 설정한다.
@Autowired로 Bean 주입, @SpringBootTest 같은 어노테이션 사용 가능하다.

💙 @SpringBootTest()

실제 내장 톰캣을 랜덤 포트로 띄워서 테스트 환경을 구성한다.
REST API를 TestRestTemplate로 직접 호출해 테스트 할 수 있다.
단순 단위 테스트가 아니라 실제 서버 구동을 포함한 통합 테스트이다.

💙 RestTemplate

Spring에서 제공하는 HTTP 클라이언트

Java 코드에서 다른 서버의 REST API를 호출할 때 쓰는 도구
-> Java 코드로 HTTP 요청 보내고, 응답 받아서 객체로 변환해주는 클래스

REST API 호출 전용

• GET, POST, PUT, DELETE 같은 HTTP 메소드 지원
• 요청 본문과 헤더 설정 가능
• 응답을 바로 Java 객체로 매핑 가능 (Jackson) 사용

동기 방식

• 요청을 보내면 응답이 올 때까지 기다림

Spring에서 기본 제공

• Spring Web 의존성 추가하면 바로 사용 가능

Spring 5부터는 WebClient 권장

• RestTemplate은 유지보수 모드
• 비동기, 리액티브 처리가 필요하면 WebClient 사용

        RestTemplate restTemplate = new RestTemplate();

        // GET 요청
        String url = "https://jsonplaceholder.typicode.com/posts/1";
        ResponseEntity<String> response = restTemplate.getForEntity(url, String.class);

        System.out.println("응답 코드: " + response.getStatusCode());
        System.out.println("응답 본문: " + response.getBody());

💙 TestRestTemplate

Spring Boot의 통합 테스트용 HTTP 클라이언트

일반 RestTemplate과 비슷하게 동작하지만, 테스트 환경에서 사용하기 쉽게 만들어진 특화 버전

Spring Boot에서 자동으로 빈 제공

@SpringBootTest(webEnvironment = SpringBootTest.WebEnvironment.RANDOM_PORT)
같이 설정하면 @Autowired로 바로 주입받아 사용 가능

실제 HTTP 요청처럼 동작

테스트 서버를 띄운 뒤,
GET, POST, PUT, DELETE 같은 HTTP 요청을 보내고 응답을 받을 수 있다.

RestTemplate보다 테스트 친화적

• 인증, 기본 헤더 설정, 직렬화/역직렬화 등을 더 쉽게 적용 가능
• 테스트 서버의 포트 번호를 자동으로 매핑 (@LocalServerPort와 함께 사용)

목적

• 단위 테스트: 서비스나 레포지토리만 테스트
• 통합 테스트: 실제 API 요청/응답 흐름까지 검증
  → TestRestTemplate은 후자인 통합 테스트용

💙 RestTemplate vs TestRestTemplate

구분	RestTemplate	TestRestTemplate
목적	운영·개발 환경에서 외부 API 호출	테스트 환경에서 API 호출 및 검증
사용 위치	일반 서비스 로직	@SpringBootTest 통합 테스트
기본 포트 연결	수동 설정 필요	@LocalServerPort와 연동
특징	단순 HTTP 호출	테스트용 인증·설정이 편리

운영 코드에서 외부 API 부를 때 → RestTemplate
통합 테스트에서 내 API 엔드포인트 호출할 때 → TestRestTemplate

사용 예시

RestTemplate

우리 서비스에서 네이버 날씨 API를 호출해서, 그 결과를 가공해 화면에 보여줘

@Service
public class WeatherService {
    private final RestTemplate restTemplate = new RestTemplate();

    public WeatherInfo getWeather(String city) {
        return restTemplate.getForObject(
            "https://api.weather.com/today?city=" + city,
            WeatherInfo.class
        );
    }
}

TestRestTemplate

우리 서비스 /weather API가 잘 동작하는지 테스트 코드에서 확인해보자

@SpringBootTest(webEnvironment = SpringBootTest.WebEnvironment.RANDOM_PORT)
public class WeatherControllerTest {

    @LocalServerPort
    int port;

    @Autowired
    TestRestTemplate restTemplate;

    @Test
    void 날씨_API_테스트() {
        String url = "http://localhost:" + port + "/weather?city=Seoul";
        ResponseEntity<WeatherInfo> response = restTemplate.getForEntity(url, WeatherInfo.class);

        assertThat(response.getStatusCode()).isEqualTo(HttpStatus.OK);
    }
}

💙 @LocalServerPort

랜덤하게 할당된 서버 포트 번호를 주입

restTemplate 요청 URL에 사용된다 (http://localhost:{port})