Working with Spring Data REST

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

public interface PersonRepository extends JpaRepository<Person, Long> {
  // Auto-exposed at /persons (collection) and /persons/{id} (item)
}

spring:
  data:
    rest:
      base-path: /api
      default-page-size: 20
      max-page-size: 100

@RepositoryRestResource(path="people", collectionResourceRel="people")
public interface PersonRepository extends JpaRepository<Person, Long> {
  @RestResource(path="byEmail", rel="byEmail")
  Optional<Person> findByEmail(@Param("email") String email);

  @RestResource(exported=false) // hide from REST
  void deleteAll();
}

@Projection(name="summary", types=Person.class)
public interface PersonSummary {
  String getFullName();
  @Value("#{target.firstName + ' ' + target.lastName}") String getFullNameComputed();
}
// Use: GET /people/1?projection=summary

@Component
@RepositoryEventHandler(Person.class)
public class PersonEventHandler {
  @HandleBeforeCreate void beforeCreate(Person p) { p.setUuid(UUID.randomUUID()); }
  @HandleAfterDelete void afterDelete(Person p) { /* audit */ }
}

@PreAuthorize("hasRole('ADMIN')")
public interface PersonRepository extends JpaRepository<Person, Long> {
  @Override @PreAuthorize("hasRole('USER')")
  Page<Person> findAll(Pageable p);
}

public interface PersonRepository extends JpaRepository<Person, Long> {
  // Exposed at /persons/search/byLastName?lastName=Doe
  List<Person> findByLastName(@Param("lastName") String lastName);
}