org.resthub.web.controller

Class RepositoryBasedRestController<T,ID extends Serializable,R extends org.springframework.data.repository.PagingAndSortingRepository>

java.lang.Object

org.resthub.web.controller.RepositoryBasedRestController<T,ID,R>

Type Parameters:

T - Your resource class to manage, maybe an entity or DTO class

ID - Resource id type, usually Long or String

R - The repository class

All Implemented Interfaces:

RestController<T,ID>

public abstract class RepositoryBasedRestController<T,ID extends Serializable,R extends org.springframework.data.repository.PagingAndSortingRepository>
extends Object
implements RestController<T,ID>

Abstract REST controller using a repository implementation

You should extend this class when you want to use a 2 layers pattern : Repository and Controller. This is the default controller implementation to use if you have no service (also called business) layer. You will be able to transform it to a ServiceBasedRestController later easily if needed.

Default implementation uses "id" field (usually a Long) in order to identify resources in web request. If your want to identity resources by a slug (human readable identifier), your should override findById() method with for example :

 
   @Override
   public Sample findById(@PathVariable String id) {
        Sample sample = this.repository.findByName(id);
        if (sample == null) {
            throw new NotFoundException();
        }
        return sample;
   }
   
 

See Also:

ServiceBasedRestController

Field Summary

Fields

Modifier and Type	Field and Description
protected org.slf4j.Logger	logger
protected R	repository

Constructor Summary

Constructors

Constructor and Description
RepositoryBasedRestController()

Method Summary

Methods

Modifier and Type	Method and Description
T	create(T resource) Create a new resource REST webservice published : POST /
void	delete() Delete all resources REST webservice published : DELETE / Return No Content http status code if the request has been correctly processed
void	delete(ID id) Delete a resource by its identifier REST webservice published : DELETE /{id} Return No Content http status code if the request has been correctly processed
Iterable<T>	findAll() Find all resources, and return the full collection (plain list not paginated) REST webservice published : GET /?
T	findById(ID id) Find a resource by its identifier REST webservice published : GET /{id}
Iterable<T>	findByIds(Set<ID> ids) Find multiple resources by their identifiers REST webservice published : GET /?
org.springframework.data.domain.Page<T>	findPaginated(Integer page, Integer size, String direction, String properties) Find all resources, and return a paginated and optionaly sorted collection REST webservice published : GET /search?
void	setRepository(R repository) You should override this setter in order to inject your repository with @Inject annotation
T	update(ID id, T resource) Update an existing resource REST webservice published : PUT /{id}

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

repository

protected R extends org.springframework.data.repository.PagingAndSortingRepository repository

logger

protected org.slf4j.Logger logger

Constructor Detail

RepositoryBasedRestController

public RepositoryBasedRestController()

Method Detail

setRepository

public void setRepository(R repository)

You should override this setter in order to inject your repository with @Inject annotation

Parameters:

repository - The repository to be injected

create

public T create(@RequestBody
       T resource)

Create a new resource
REST webservice published : POST /

Specified by:

create in interface RestController<T,ID extends Serializable>

Parameters:

resource - The resource to create

Returns:

CREATED http status code if the request has been correctly processed, with updated resource enclosed in the body, usually with and additional identifier automatically created by the database

update

public T update(@PathVariable
       ID id,
       @RequestBody
       T resource)

Update an existing resource
REST webservice published : PUT /{id}

Specified by:

update in interface RestController<T,ID extends Serializable>

Parameters:

id - The identifier of the resource to update, usually a Long or String identifier. It is explicitely provided in order to handle cases where the identifier could be changed.

resource - The resource to update

Returns:

OK http status code if the request has been correctly processed, with the updated resource enclosed in the body

findAll

public Iterable<T> findAll()

Find all resources, and return the full collection (plain list not paginated)
REST webservice published : GET /?page=no

Specified by:

findAll in interface RestController<T,ID extends Serializable>

Returns:

OK http status code if the request has been correctly processed, with the list of all resource enclosed in the body. Be careful, this list should be big since it will return ALL resources. In this case, consider using paginated findAll method instead.

findPaginated

public org.springframework.data.domain.Page<T> findPaginated(@RequestParam(value="page",required=false,defaultValue="1")
                                                    Integer page,
                                                    @RequestParam(value="size",required=false,defaultValue="10")
                                                    Integer size,
                                                    @RequestParam(value="direction",required=false,defaultValue="")
                                                    String direction,
                                                    @RequestParam(value="properties",required=false)
                                                    String properties)

Find all resources, and return a paginated and optionaly sorted collection
REST webservice published : GET /search?page=0&size=20 or GET /search?page=0&size=20&direction=desc&properties=name

Specified by:

findPaginated in interface RestController<T,ID extends Serializable>

Parameters:

page - Page number starting from 0. default to 0

size - Number of resources by pages. default to 10

direction - Optional sort direction, could be "asc" or "desc"

properties - Ordered list of comma separeted properies used for sorting resulats. At least one property should be provided if direction is specified

Returns:

OK http status code if the request has been correctly processed, with the a paginated collection of all resource enclosed in the body.

findById

public T findById(@PathVariable
         ID id)

Find a resource by its identifier
REST webservice published : GET /{id}

Specified by:

findById in interface RestController<T,ID extends Serializable>

Parameters:

id - The identifier of the resouce to find

Returns:

OK http status code if the request has been correctly processed, with resource found enclosed in the body

findByIds

public Iterable<T> findByIds(@RequestParam(value="ids[]")
                    Set<ID> ids)

Find multiple resources by their identifiers
REST webservice published : GET /?ids[]=

example : /?ids[]=1&ids[]=2&ids[]=3

Specified by:

findByIds in interface RestController<T,ID extends Serializable>

Parameters:

ids - List of ids to retrieve

Returns:

OK http status code with list of retrieved resources. Not found resources are ignored: no Exception thrown. List is empty if no resource found with any of the given ids.

delete

public void delete()

Delete all resources
REST webservice published : DELETE /
Return No Content http status code if the request has been correctly processed

Specified by:

delete in interface RestController<T,ID extends Serializable>

delete

public void delete(@PathVariable
          ID id)

Delete a resource by its identifier
REST webservice published : DELETE /{id}
Return No Content http status code if the request has been correctly processed

Specified by:

delete in interface RestController<T,ID extends Serializable>

Parameters:

id - The identifier of the resource to delete