1. Controller
   1. Java Class
      1. play.mvc.Controller
2. Action
   1. Controller method
      1. play.mvc.Action
   2. in
      1. Parameters
   3. out
      1. HTTP Response
   4. database transactions
      1. @Transactional
3. Result
   1. Java Class
      1. play.mvc.Result
   2. elements
      1. body
      2. headers
      3. cookies
      4. status code
      5. content type
4. Parameters Types
   1. String by default
   2. Scala types
      1. GET /client/:id controllers.Clients.show(id: Long)
      2. public static Result show(Long id) { ... }
   3. With fixed values
      1. GET / controllers.Application.show(page = "home")
      2. GET /:page controllers.Application.show(page)
   4. With default values
      1. GET /clients controllers.Clients.list(page: Integer ?= 1)
   5. To convert string parameters to other types
5. Parameter
   1. Type
   2. value
6. HTTP Request
   1. Request Path
      1. parameters
      2. URL
   2. HTTP Method
      1. GET
      2. POST
      3. DELETE
      4. PUT
      5. UPDATE
   3. Body
7. Results Helpers
   1. Class
      1. play.mvc.Results
   2. built-in helpers
      1. ok
         1. ok("Hello World!");
      2. notFound
         1. notFound();
      3. pageNotFound
         1. notFound("<h1>page not found</h1>").as("text/html");
      4. badRequest
         1. badRequest(views.html.form.render(formWithErrors));
      5. oops
         1. internalServerError("An error occurred");
      6. anyStatus
         1. status(488, "Strange response type");
      7. redirect
         1. redirect("/user/home");
   3. Helpers that produce standard HTTP results
8. Web Client
9. Router
   1. Functions
      1. Resolve params
         1. by URL
         2. query URL
      2. Action Mappings
         1. directly
         2. by order
            1. top to bottom
   2. When
      1. In: Request
         1. Choose: Action
      2. In: Action call
         1. Choose: URL
   3. conf/routes
      1. Examples
         1. HTTPMethod
            1. URI
            2. path.to.Controller.method(args)
         2. GET /clients/:id controllers.Clients.show(id: Long)
         3. GET /clients controllers.Clients.list()
         4. GET /files/*name controllers.Application.download(name)
            1. Dynamic paths
         5. GET /clients/$id<[0-9]+> controllers.Clients.show(id: Long)
            1. Dynamic with RegEx
         6. GET /:page controllers.Application.show(page)
            1. i.e. http://myserver.com/index
   4. Maps URLs to Actions and viceversa
10. User
11. Session scope
    1. availability
       1. whole user session
    2. limitations
       1. 4 KB
       2. signed with a secret key
       3. no time expiration control
          1. when browser closed
       4. only String values
    3. usage
       1. read
          1. String user = session("connected");
       2. write
          1. session("connected", "user@gmail.com");
       3. delete
          1. session.remove("connected");
       4. delete all
          1. session().clear();
    4. To store String values in Session Scope
12. Flash Scope
    1. availability
       1. next request
    2. limitations
       1. 4 KB
       2. signed with a secret key
       3. only String values
       4. non encrypted
       5. non thread safe (race conditions)
       6. better for handling success/error messages
    3. usage
       1. read
          1. String message = flash("success");
       2. write
          1. flash("success", "The item has been created");
    4. To pass String values to the next Request
13. BodyParser
    1. available
       1. application/json
          1. .asJson()
             1. JsonNode
       2. text/plain
          1. .asText()
             1. java.lang.String
       3. text/xml
          1. .asXml()
             1. org.w3c.Document
       4. application/form-url-encoded
          1. asFormUrlEncoded()
             1. Map<String, String[]>
       5. multipart/form-data
          1. asMulipartFormData()
             1. Http.MultipartFormData
       6. any other content type
          1. asRaw()
             1. Http.RawBuffer
    2. custom
       1. example :)
    3. Converts HttpRequests to other, more convenient, representations
14. RequestBody
    1. Java Class
       1. play.mvc.Http.RequestBody
    2. content length
       1. default
          1. 100 KB
             1. 10 * 1024
       2. isMaxSizeExceeded()
          1. boolean
    3. An element present in some HttpRequests
15. Action Composition
    1. Predefined Actions
       1. play.mvc.Security.Authenticated
       2. play.cache.Cached
    2. Implementation
       1. ExampleAction
          1. extends
             1. Action.Simple
          2. implement function
             1. call(Http.Context ctx) throws Throwable
          3. delegate wrapped action
             1. delegate.call(ctx);
          4. returns
             1. Result
       2. Action method
          1. @With(ExampleAction.class, Other.class)
    3. To chain Actions together
16. Ebean ORM
    1. setup
       1. conf/application.conf
          1. one server
             1. ebean.default="models.*"
          2. many servers
             1. ebean.products="models.products.*"
             2. ebean.customers="models.customers.*"
    2. Models
       1. SomeModel.java
          1. extends
             1. play.db.ebean.Model
          2. identifier
             1. @Id
          3. constraints
             1. import play.data.validation.*;
             2. @Constraints.Min(10)
             3. @Constraints.Required
             4. @Constraints.EMail
             5. @Constraints.Max
             6. @Constraints.MaxLength
             7. @Constraints.Min
             8. @Constraints.MinLength
             9. @Constraints.Pattern
          4. formats
             1. import play.data.format.*;
             2. @Formats.DateTime(pattern="dd/MM/yyyy")
             3. @NonEmpty
          5. finders
             1. examples
             2. public static Finder<Long,Task> find = new Finder<Long,Task>( Long.class, Task.class );
             3. Task.find.all();
             4. Task.find.byId(34L);
             5. taskA.delete();
             6. Task.find.where().ilike("name" "%something%").orderBy("dueDate asc");
             7. Task.find.where().ilike("name" "%something%").orderBy("dueDate asc").findPagingList(25).getPage(1);
          6. transactions
             1. with annotations
             2. @Transactional
             3. public static Result save() { ... }
          7. Describes how Models should be implemented
    3. JPA Integration
       1. Steps
          1. Add Dependency
             1. "org.hibernate" % "hibernate-entitymanager" % "3.6.9.Final"
          2. conf/META-INF/persistence.xml
             1. sample :)
          3. JNDI name is required
       2. Usage
          1. Actions
             1. @play.db.jpa.Transactional
          2. Actions (read only)
             1. @play.db.jpa.Transactional(readOnly = true)
          3. Select example
             1. Import: play.db.jpa.JPA
             2. Company c = JPA.em().find(Company.class, id);
             3. JPA.em() returns the EntityManager
       3. Provides JPA Capabilities to your Models
17. DataBase
    1. import the driver
       1. Build.scala
          1. addDependencies Seq
             1. "mysql" % "mysql-connector-java" % "5.1.18"
    2. datasources
       1. conf/application.conf
          1. default
             1. db.default.driver
             2. db.default.url
             3. db.default.jndiName
          2. other
    3. usage
       1. SomeClass.java
          1. import play.db.*;
          2. DataSource ds = DB.getDatasource();
          3. Connection conn = DB.getConnection();
    4. Define your datasource(s) this way
18. Template Engine
    1. Features
       1. compact
          1. minimizes keystrokes
       2. expresive
          1. infers code
       3. fluid
          1. few interruptions
       4. comfortable to front-end developers
       5. doesn't require a specific editor
       6. easy to lern
          1. few concepts to learn
          2. use Scala constructs
          3. not a new language to learn
          4. use your HTML skills
       7. remember
          1. do not write complex code with it
          2. use [] instead of <>
             1. example
             2. List[String] instead of List<String>
    2. generates
       1. XML
       2. HTML
       3. CSV
       4. Any other text
    3. Syntax
       1. file naming
          1. viewName.scala.html
       2. @
          1. marks the beginning of a dynamic statement
          2. imports
             1. @import com.company._
          3. comments
             1. @* ... *@
          4. escape @
             1. use @@
          5. input parameters
             1. @(var1: Type1, var2: Type2 ... var3: Type3)
             2. default values
             3. @(var1: Type1 = "default value")
             4. groups
             5. @(var1: Type1)(var2: Type2)
          6. simple statement
             1. @variable.methodName()
          7. multiple statements
             1. @(var.methodA() + var.methodB())
          8. code blocks
             1. @{val a = var.methodA(); var b = var.methodB();}
          9. for
             1. @for ( element <- collection ) { ... }
          10. if-block
              1. @if ( var.method() ) { ... } else { ... }
          11. functions
          12. functions
          13. escape
              1. @Html(text)
              2. @Xml(text)
    4. example
       1. template
          1. views/Application/index.scala.html
       2. generates
          1. views.html.Application.index Class
       3. usage (java)
          1. Content html = views.html.Application.index.render(customer, orders);
    5. This engines produce front-end code from a given Result