Hypermedia As The Engine Of Application State

• 서버: 현재 리소스와 연관된 링크 정보를 클라이언트에게 제공한다.
• 클라이언트: 연관된 링크 정보를 바탕으로 리소스에 접근한다.
• 연관된 링크 정보
  • Relation
  • Hypertext Reference)

의존성 추가

<dependency>
  <groupId>org.springframework.boot</groupId>
  <artifactId>spring-boot-starter-hateoas</artifactId>
</dependency>

ObjectMapper와 LinkDiscovers 제공

테스트 코드

@RunWith(SpringRunner.class)
@WebMvcTest(SampleController.class)
public class SampleControllerTest {

	@Autowired
	MockMvc mockMvc;

	@Test
	public void hello() throws Exception {
		mockMvc.perform(get("/hello"))
				.andDo(print())
				.andExpect(status().isOk())
				.andExpect(jsonPath("$._links.self").exists());
	}
}

컨트롤러

@RestController
public class SampleController {

	@GetMapping("/hello")
	public Resource<Hello> hello() {
		Hello hello = new Hello();
		hello.setPrefix("Hey,");
		hello.setName("cmlee");

		Resource<Hello> helloResource = new Resource<>(hello);
		helloResource.add(linkTo(methodOn(SampleController.class).hello()).withSelfRel());

		return helloResource;
	}
}

ObjectMapper 제공

• spring.jackson.*
  • properties를 이용해 커스터마이징 가능
    • locale 등등
• Jackson2ObjectMapperBuilder

LinkDiscovers 제공

• 클라이언트 쪽에서 링크 정보를 Rel 이름으로 찾을때 사용할 수 있는 XPath 확장 클래스