JPA Repository and Spring-data-rest baseURi is /profile

Question

Just learning springboot (and newish to java: from .NET world)

Too PS course on spring-data and spring-data-rest. All went well

Made a test project connection to MS SQlServer. Created a few JPA Repos and unit tests pass for FindAll

I don't have a base-uri set in app properties and when explore the rest interface (with Postman) everything appears under /profile.

{
    "_links": {
        "self": {
            "href": "http://localhost:8080/profile"
        },
        "users": {
            "href": "http://localhost:8080/profile/users"
        },
        "tasks": {
            "href": "http://localhost:8080/profile/tasks"
        }
    }
}

first question is, where does /profile come from?

Answer 1

It's not a base path (url). It's a normal work of SDR:

A profile link, as defined in RFC 6906, is a place to include application-level details. The ALPS draft spec is meant to define a particular profile format, which we explore later in this section.

If you navigate into the profile link at localhost:8080/profile, you see content resembling the following:

{
  "_links" : {
    "self" : {
      "href" : "http://localhost:8080/profile"
    },
    "persons" : {
      "href" : "http://localhost:8080/profile/persons"
    },
    "addresses" : {
      "href" : "http://localhost:8080/profile/addresses"
    }
  }
}

To work with your entities you have to use these links:

• http://localhost:8080/users
• http://localhost:8080/tasks

By the way you can set 'base path' in three ways:

1. In 'application.properties`

   spring.data.rest.basePath=/api

2. Registering a bean

   @Bean
   public RepositoryRestConfigurer repositoryRestConfigurer() {
   
     return new RepositoryRestConfigurerAdapter() {
   
       @Override
       public void configureRepositoryRestConfiguration(RepositoryRestConfiguration config) {
         config.setBasePath("/api");
       }
     };
   }
   

3. With a custom implementation of RepositoryRestConfigurer

   @Component
   public class CustomizedRestMvcConfiguration extends RepositoryRestConfigurerAdapter {
   
     @Override
     public void configureRepositoryRestConfiguration(RepositoryRestConfiguration config) {
       config.setBasePath("/api");
     }
   }