br.com.caelum.vraptor.mydvds.controller

Class DvdsController

java.lang.Object

br.com.caelum.vraptor.mydvds.controller.DvdsController

@Resource
public class DvdsController
extends Object

The resource DvdController handles all Dvd operations, such as adding new Dvds, listing all Dvds, and so on. This is a RESTful Resource, so we will explain how to use REST on VRaptor 3 here. POST /dvds -> adds a dvd GET /dvds/{id} -> shows the dvd of given id

Constructor Summary

Constructors

Constructor and Description
DvdsController(DvdDao dao, UserInfo userInfo, Result result, Validator validator) Receives dependencies through the constructor.

Method Summary

Modifier and Type	Method and Description
void	add(Dvd dvd, UploadedFile file) Accepts HTTP POST requests.
void	search(Dvd dvd) Accepts HTTP GET requests.
void	show(Dvd dvd) Accepts HTTP GET requests.

Methods inherited from class java.lang.Object

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

Constructor Detail

DvdsController

public DvdsController(DvdDao dao,
                      UserInfo userInfo,
                      Result result,
                      Validator validator)

Receives dependencies through the constructor.

Parameters:

userInfo - info on the logged user.

result - VRaptor result handler.

validator - VRaptor validator.

factory - dao factory.

Method Detail

add

@Path(value="/dvds")
 @Post
public void add(Dvd dvd,
                                            UploadedFile file)

Accepts HTTP POST requests. URL: /dvds View: /WEB-INF/jsp/dvd/add.jsp The method adds a new dvd and updates the user. We use POST HTTP verb when we want to create some resource. The UploadedFile is automatically handled by VRaptor's MultipartInterceptor.

show

@Path(value="/dvds/{dvd.id}")
 @Get
public void show(Dvd dvd)

Accepts HTTP GET requests. URL: /dvds/{id} View: /WEB-INF/jsp/dvd/show.jsp Shows the page with information about given Dvd We should only use GET HTTP verb for safe operations. For instance, showing a DVD has no side effects, so GET is fine. We can use templates for Paths, so VRaptor will automatically extract variables of the matched URI, and set the fields on parameters. In this case, GET /dvds/15 will execute the method below, and there will be a parameter dvd.id=15 on request, causing dvd.getId() equal to 15.

search

@Path(value="/dvds/search")
 @Get
public void search(Dvd dvd)

Accepts HTTP GET requests. URL: /dvds/search View: /WEB-INF/jsp/dvd/search.jsp Searches are not unique resources, so it is ok to use searches with query parameters.

Parameters:

dvd -