FlightPub

FlightClub

Nimbus

Framework  



  • The secret to success - use a Full-Stack framework.

  • Play offers a productive environment for building RESTFUL web apps.

  • Download the play-version.zip , unzip, add the play binary to your $PATH and you're good to go:

 terminal~/dev$  play new FlightClub

  • This generates an intuitive MVC folder hierarchy :

Structure of a   app


app                      → Application sources
 └ assets                → Compiled asset sources
    └ stylesheets        → Typically LESS CSS sources
    └ javascripts        → Typically CoffeeScript sources
 └ controllers           → Application controllers
 └ models                → Application business layer
 └ views                 → Templates
build.sbt                → Application build script
conf                     → Configurations files and other non-compiled resources
 └ application.conf      → Main configuration file
 └ routes                → Routes definition
public                   → Public assets
 └ stylesheets           → CSS files
 └ javascripts           → Javascript files
 └ images                → Image files
project                  → sbt configuration files
lib                      → Unmanaged libraries dependencies
logs                     → Standard logs folder
 └ application.log       → Default log file

REST & ROUTES

  • Play! Framework is Stateless and RESTFUL by default

    • No Servlets == No servlet containers ( Tomcat, Jetty )  

    • All requests enter a Play! app via a { java. nio } Non-Blocking I/O Server called Netty  that never touches HTTP Session ( ever ).

    • Having a static routes file located in the conf directory :
#  HTTP        
# request      URI                     Controller.method
#  type
   
   GET     /                       controllers.Application.index()

   GET     /FlightSearch           controllers.FlightsController.flightSearch()

   POST    /Login/ResetPassword    controllers.SecurityManager.doReset()

   DELETE  /Cart/Remove            controllers.Cart.remove(cartId: Long)
     
    

Application.conf

  • In the conf folder of the application directory, lives a lonely configuration file: application.conf

  • Similar to a Java Properties File:
# Default Routes file: Default to Routes in the root package
#application.router=my.application.Routes
# Database configuration # ~~~~~ # You can declare as many datasources as you want. # By convention, the default datasource is named "default" # Uncomment below or use the H2 in-memory database. db.default.driver=com.mysql.jdbc.Driver db.default.url="jdbc:mysql://localhost:3306/flights" db.default.user=... db.default.password=...

  • Zero XML configuration

  run

  •  This loads the project and compiles all sources, before deploying it to the configured url: 


terminal~/dev/FlightClub$ play run

[info] Loading project definition from /Users/terminal/dev/FlightClub/project

--- (Running the application from SBT, auto-reloading is enabled) ---


[info] play - Listening for HTTP on /0:0:0:0:0:0:0:0:9000


(Server started, use Ctrl+D to stop and go back to the console...)


  • Demo to come later  ;-)

SBT

  • Simple Build Tool  -  the build tool used by 

  • Dependency Management 
    • build.sbt equivalent to maven's pom.xml

name := "FlightClub"

version := "1.0-SNAPSHOT"

libraryDependencies ++= Seq(
  javaJdbc,
  javaEbean,
  cache,
  "mysql" % "mysql-connector-java" % "5.1.18"
)

play.Project.playJavaSettings
	
  • SBT compiles both and  sources.

SBT

  • Reloads code changes on the fly :
--- (Running the application from SBT, auto-reloading is enabled) ---

...

[info] Updating {file:/Users/terminal/dev/Flightclub/}flightclub...

[info] Resolving ...

[info] Done updating.

[info] Compiling 3 Scala sources and 2 Java sources to /Users/terminal/dev/Flightclub/target/scala-2.10/classes...

  • Means that every update to the code only requires a refresh        ( or two ) of the browser.

Relevant Exceptions

  • Exceptions are conveniently displayed in the browser :

Ebean ORMEvolutions


  • Ebean is an ORM similar to Hibernate

      • HTTP Session-less Transactions

      • Highly integrated into Play! 


    • Evolutions help to handle database migrations

      • Auto-generates sql scripts in response to changes to your @Entity models

      • These run at start-up on your database

    Evolutions Example


    Db

    • The Database we were given had no problems at all

    • We changed it :

      • Indexing

      • Normalisation

      • Added additional tables to make searching far easier.
        • Splitting flights
        • Adding routes table

    • Migration Scripts

    ER Diagram BEFORE


    ER Diagram AFTER


    WorkFlow


    Jira Wallboard







    Demo







    Paul

    • Flight Search approach
    • Server vs Client-side templating
    • Views
      • views.scala.html templates
    • Responsive design

    Lachlan

    • Compiled Assets
      • LESS CSS
      • CoffeeScript
    • Forms & Data-Validation

    Coffee vs JS


    Coffee & for-each


    Coffee & Expressions


    Forms & Validation

    Form<User> userForm = form(User.class);
    @Entity public class User { @Constraints.Required @Constraints.Email public String email; @Constraints.MinLength(6) public String password; public String validate() { if(authenticate(email,password) == null) { return "Invalid email or password"; } return null; } }
    
    if(userForm.hasErrors()) {
        return badRequest(form.render(userForm));
    } else {
        User user = userForm.get();
        return ok("Got user " + user);
    }
        

    LESS.CSS

    
    Variables are pretty easy
    @black: #FFCC00
    #header{
        color: @black
    }
    
    Mixins are an easy way of including properties from one rule-set to another.
    .bordered {
      border-top: dotted 1px black;
      border-bottom: solid 2px black;
    }
    
    #menu a {
      color: #111;
      .bordered;
    } 
    
    
    Nesting Rules
    #header {
      color: black;
      .navigation {
        font-size: 12px;
      }
      .logo {
        width: 300px;
      }
    }   

    Previous Designs


    Less Professional; 

    Poor Bootstrap Integration

    Login in Header 

    Poor adaptation for Mobile

    Near completion

    Current


    FlightClub

    By Jonathon Hope

    FlightClub

    A presentation on a software engineering project featuring the technology stack and our workflow.

    • 1,045