HATEOS a brief note<\/strong><\/h3>\n\n\n\nHATEOAS (Hypermedia as the Engine of Application State) is a principle that allows REST APIs to evolve over time without breaking the client. Add a layer of discoverability to your RESTful APIs by allowing clients to dynamically navigate your APIs via links included in response payloads. Hypermedia is an essential area of REST that allows one to set up services that continue to develop independently of each other, with significant separation between client and server. The representation returned for a REST resource contains not only data but also links to related resources. The representation design is therefore crucial to the service’s overall design of the service.<\/p>\n\n\n\n
Setup Requirements<\/strong><\/h2>\n\n\n\n\n- Maven <\/li>\n\n\n\n
- Spring Boot 2.7.8<\/li>\n\n\n\n
- JDK 1.8 and above<\/li>\n\n\n\n
- Spring HATEOS<\/li>\n\n\n\n
- Spring Data JPA<\/li>\n<\/ol>\n\n\n\n
Adding HATEOS to pom.xml<\/strong><\/h3>\n\n\n\nTo enable our application the ability to use HATEOS, we have to add the spring boot dependency support for HATEOS in our pom.xml file. <\/p>\n\n\n\n
Our Model<\/strong><\/h3>\n\n\n\n<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<project xmlns=\"http:\/\/maven.apache.org\/POM\/4.0.0\" xmlns:xsi=\"http:\/\/www.w3.org\/2001\/XMLSchema-instance\"\n\txsi:schemaLocation=\"http:\/\/maven.apache.org\/POM\/4.0.0 https:\/\/maven.apache.org\/xsd\/maven-4.0.0.xsd\">\n\t<modelVersion>4.0.0<\/modelVersion>\n\t<parent>\n\t\t<groupId>org.springframework.boot<\/groupId>\n\t\t<artifactId>spring-boot-starter-parent<\/artifactId>\n\t\t<version>2.7.8<\/version>\n\t\t<relativePath\/> <!-- lookup parent from repository -->\n\t<\/parent>\n\t<groupId>com.valerio.nu<\/groupId>\n\t<artifactId>spring-data-jpa<\/artifactId>\n\t<version>0.0.1-SNAPSHOT<\/version>\n\t<name>spring-data-jpa<\/name>\n\t<description>Develop a simple restful service with spring data jpa<\/description>\n\t<properties>\n\t\t<java.version>1.8<\/java.version>\n\t<\/properties>\n\t<dependencies>\n\t\t<dependency>\n\t\t\t<groupId>org.springframework.boot<\/groupId>\n\t\t\t<artifactId>spring-boot-starter-actuator<\/artifactId>\n\t\t<\/dependency>\n\t\t<dependency>\n\t\t\t<groupId>org.springframework.boot<\/groupId>\n\t\t\t<artifactId>spring-boot-starter-data-jpa<\/artifactId>\n\t\t<\/dependency>\n\t\t<dependency>\n\t\t\t<groupId>org.springframework.boot<\/groupId>\n\t\t\t<artifactId>spring-boot-starter-web<\/artifactId>\n\t\t<\/dependency>\n\t\t<!-- https:\/\/mvnrepository.com\/artifact\/com.h2database\/h2 -->\n\t\t<dependency>\n\t\t\t<groupId>com.h2database<\/groupId>\n\t\t\t<artifactId>h2<\/artifactId>\n\t\t\t<version>2.1.214<\/version>\n\t\t<\/dependency>\n\n\t\t<dependency>\n\t\t\t<groupId>org.springframework.boot<\/groupId>\n\t\t\t<artifactId>spring-boot-devtools<\/artifactId>\n\t\t\t<scope>runtime<\/scope>\n\t\t\t<optional>true<\/optional>\n\t\t<\/dependency>\n\t\t<dependency>\n\t\t\t<groupId>com.mysql<\/groupId>\n\t\t\t<artifactId>mysql-connector-j<\/artifactId>\n\t\t\t<scope>runtime<\/scope>\n\t\t<\/dependency>\n\n\t\t<dependency>\n\t\t\t<groupId>org.springframework.boot<\/groupId>\n\t\t\t<artifactId>spring-boot-starter-hateoas<\/artifactId>\n\t\t<\/dependency>\n\t\t<dependency>\n\t\t\t<groupId>org.springframework.boot<\/groupId>\n\t\t\t<artifactId>spring-boot-starter-test<\/artifactId>\n\t\t\t<scope>test<\/scope>\n\t\t<\/dependency>\n\t\t<dependency>\n\t\t\t<groupId>org.springframework.boot<\/groupId>\n\t\t\t<artifactId>spring-boot-starter-hateoas<\/artifactId>\n\t\t\t<version>2.7.8<\/version>\n\t\t<\/dependency>\n\t\t<dependency>\n\t\t\t<groupId>org.springframework.hateoas<\/groupId>\n\t\t\t<artifactId>spring-hateoas<\/artifactId>\n\t\t\t<version>1.4.0<\/version>\n\t\t<\/dependency>\n\t<\/dependencies>\n\n\t<build>\n\t\t<plugins>\n\t\t\t<plugin>\n\t\t\t\t<groupId>org.springframework.boot<\/groupId>\n\t\t\t\t<artifactId>spring-boot-maven-plugin<\/artifactId>\n\t\t\t<\/plugin>\n\t\t<\/plugins>\n\t<\/build>\n\n<\/project>\n<\/code><\/pre>\n\n\n\nIn this tutorial, we have created a User model with properties such as firstname, lastname and username. <\/p>\n\n\n\n
The Service and interface implementation is where our business logic was defined.<\/p>\n\n\n\n
Our REST Controller shows the integration of HATEOS ability. As shown in the code below, EntityModel is used to bind the User model while the linkTo creates a reference to the URL resource desired.<\/p>\n\n\n\n
@GetMapping(value = \"\/users\/{id}\")\n public EntityModel<User> Get(@PathVariable int id) {\n\n\n User result = userService.Get(id);\n if(result == null){\n throw new ObjectNotFoundException(\"no user exist with such id: \" , String.valueOf(id));\n }\n\n return EntityModel.of(result, \/\/\n WebMvcLinkBuilder.linkTo(WebMvcLinkBuilder.methodOn(this.getClass()).Get(id)).withSelfRel(),\n WebMvcLinkBuilder.linkTo(WebMvcLinkBuilder.methodOn(this.getClass()).Get()).withRel(\"all-users\"));\n\n\n }\n<\/code><\/pre>\n\n\n\nOur goal here in the REST controller is the ability to Implement a method of how to create a link pointing to the controller method and how to add it to the restful representation model. Both linkTo(…) and methodOn(…) are static methods of WebMvcLinkBuilder were used to achieve the reference. The returned LinkBuilder consults the Controller method’s mapping annotations to construct the exact URI that the method maps to. Calling withSelfRel() creates a Link instance to add to the User\u2019s model. <\/p>\n\n\n\n
- \n
- Maven <\/li>\n\n\n\n
- Spring Boot 2.7.8<\/li>\n\n\n\n
- JDK 1.8 and above<\/li>\n\n\n\n
- Spring HATEOS<\/li>\n\n\n\n
- Spring Data JPA<\/li>\n<\/ol>\n\n\n\n
Adding HATEOS to pom.xml<\/strong><\/h3>\n\n\n\n
To enable our application the ability to use HATEOS, we have to add the spring boot dependency support for HATEOS in our pom.xml file. <\/p>\n\n\n\n
Our Model<\/strong><\/h3>\n\n\n\n
<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<project xmlns=\"http:\/\/maven.apache.org\/POM\/4.0.0\" xmlns:xsi=\"http:\/\/www.w3.org\/2001\/XMLSchema-instance\"\n\txsi:schemaLocation=\"http:\/\/maven.apache.org\/POM\/4.0.0 https:\/\/maven.apache.org\/xsd\/maven-4.0.0.xsd\">\n\t<modelVersion>4.0.0<\/modelVersion>\n\t<parent>\n\t\t<groupId>org.springframework.boot<\/groupId>\n\t\t<artifactId>spring-boot-starter-parent<\/artifactId>\n\t\t<version>2.7.8<\/version>\n\t\t<relativePath\/> <!-- lookup parent from repository -->\n\t<\/parent>\n\t<groupId>com.valerio.nu<\/groupId>\n\t<artifactId>spring-data-jpa<\/artifactId>\n\t<version>0.0.1-SNAPSHOT<\/version>\n\t<name>spring-data-jpa<\/name>\n\t<description>Develop a simple restful service with spring data jpa<\/description>\n\t<properties>\n\t\t<java.version>1.8<\/java.version>\n\t<\/properties>\n\t<dependencies>\n\t\t<dependency>\n\t\t\t<groupId>org.springframework.boot<\/groupId>\n\t\t\t<artifactId>spring-boot-starter-actuator<\/artifactId>\n\t\t<\/dependency>\n\t\t<dependency>\n\t\t\t<groupId>org.springframework.boot<\/groupId>\n\t\t\t<artifactId>spring-boot-starter-data-jpa<\/artifactId>\n\t\t<\/dependency>\n\t\t<dependency>\n\t\t\t<groupId>org.springframework.boot<\/groupId>\n\t\t\t<artifactId>spring-boot-starter-web<\/artifactId>\n\t\t<\/dependency>\n\t\t<!-- https:\/\/mvnrepository.com\/artifact\/com.h2database\/h2 -->\n\t\t<dependency>\n\t\t\t<groupId>com.h2database<\/groupId>\n\t\t\t<artifactId>h2<\/artifactId>\n\t\t\t<version>2.1.214<\/version>\n\t\t<\/dependency>\n\n\t\t<dependency>\n\t\t\t<groupId>org.springframework.boot<\/groupId>\n\t\t\t<artifactId>spring-boot-devtools<\/artifactId>\n\t\t\t<scope>runtime<\/scope>\n\t\t\t<optional>true<\/optional>\n\t\t<\/dependency>\n\t\t<dependency>\n\t\t\t<groupId>com.mysql<\/groupId>\n\t\t\t<artifactId>mysql-connector-j<\/artifactId>\n\t\t\t<scope>runtime<\/scope>\n\t\t<\/dependency>\n\n\t\t<dependency>\n\t\t\t<groupId>org.springframework.boot<\/groupId>\n\t\t\t<artifactId>spring-boot-starter-hateoas<\/artifactId>\n\t\t<\/dependency>\n\t\t<dependency>\n\t\t\t<groupId>org.springframework.boot<\/groupId>\n\t\t\t<artifactId>spring-boot-starter-test<\/artifactId>\n\t\t\t<scope>test<\/scope>\n\t\t<\/dependency>\n\t\t<dependency>\n\t\t\t<groupId>org.springframework.boot<\/groupId>\n\t\t\t<artifactId>spring-boot-starter-hateoas<\/artifactId>\n\t\t\t<version>2.7.8<\/version>\n\t\t<\/dependency>\n\t\t<dependency>\n\t\t\t<groupId>org.springframework.hateoas<\/groupId>\n\t\t\t<artifactId>spring-hateoas<\/artifactId>\n\t\t\t<version>1.4.0<\/version>\n\t\t<\/dependency>\n\t<\/dependencies>\n\n\t<build>\n\t\t<plugins>\n\t\t\t<plugin>\n\t\t\t\t<groupId>org.springframework.boot<\/groupId>\n\t\t\t\t<artifactId>spring-boot-maven-plugin<\/artifactId>\n\t\t\t<\/plugin>\n\t\t<\/plugins>\n\t<\/build>\n\n<\/project>\n<\/code><\/pre>\n\n\n\nIn this tutorial, we have created a User model with properties such as firstname, lastname and username. <\/p>\n\n\n\n
The Service and interface implementation is where our business logic was defined.<\/p>\n\n\n\n
Our REST Controller shows the integration of HATEOS ability. As shown in the code below, EntityModel is used to bind the User model while the linkTo creates a reference to the URL resource desired.<\/p>\n\n\n\n
@GetMapping(value = \"\/users\/{id}\")\n public EntityModel<User> Get(@PathVariable int id) {\n\n\n User result = userService.Get(id);\n if(result == null){\n throw new ObjectNotFoundException(\"no user exist with such id: \" , String.valueOf(id));\n }\n\n return EntityModel.of(result, \/\/\n WebMvcLinkBuilder.linkTo(WebMvcLinkBuilder.methodOn(this.getClass()).Get(id)).withSelfRel(),\n WebMvcLinkBuilder.linkTo(WebMvcLinkBuilder.methodOn(this.getClass()).Get()).withRel(\"all-users\"));\n\n\n }\n<\/code><\/pre>\n\n\n\nOur goal here in the REST controller is the ability to Implement a method of how to create a link pointing to the controller method and how to add it to the restful representation model. Both linkTo(…) and methodOn(…) are static methods of WebMvcLinkBuilder were used to achieve the reference. The returned LinkBuilder consults the Controller method’s mapping annotations to construct the exact URI that the method maps to. Calling withSelfRel() creates a Link instance to add to the User\u2019s model. <\/p>\n\n\n\n
![\"\"](\"https:\/\/valerio.nu\/wp-content\/uploads\/2023\/02\/Screenshot-2023-02-11-at-08.43.46-1024x670.png\")