Table Of ContentPlay Framework Essentials
Table of Contents
Play Framework Essentials
Credits
About the Author
About the Reviewers
www.PacktPub.com
Support files, eBooks, discount offers, and more
Why subscribe?
Free access for Packt account holders
Preface
What this book covers
What you need for this book
Who this book is for
Conventions
Reader feedback
Customer support
Downloading the example code
Errata
Piracy
Questions
1. Building a Web Service
Play – a framework used to write web applications
Bootstrapping a Play application
Play applications’ layout
URL routing
Route path parameters
Parameters type coercion
Parameters with fixed values
Query string parameters
Default values of query string parameters
Trying the routes
Building HTTP responses
Serializing application data in JSON
Reading JSON requests
Validating JSON data
Handling optional values and recursive types
Summary
2. Persisting Data and Testing
Testing your web service
Writing and running tests
Testing the HTTP layer
Using the reverse router to generate URLs
Running a fake Play application
Effectively writing HTTP tests
Persisting data
Using a relational database
Getting a reference to the currently running application
Using a database management library
Using Slick in Scala
Using JPA in Java
Integrating with other persistence technologies
Populating the database with fixtures
The application’s Global object
Managing database schema evolutions
Using an in-memory database for tests
Summary
3. Turning a Web Service into a Web Application
Delta between a web service and a web application
Using the template engine to build web pages
Inserting dynamic values
Looping and branching
Reusing document fragments
Comments
Import statements
Generating HTML forms
Repeated and nested fields
Reading and validating HTML form data
Handling the HTML form submission
Validating the HTML form data
The Scala form validation API
The Java form validation API
Optional and mandatory fields
Sharing JSON validation and HTML form validation rules
Handling content negotiation
Putting things together
Writing web user interface tests
Summary
4. Integrating with Client-side Technologies
Philosophy of Play regarding client-side technologies
Serving static assets
Sprinkling some JavaScript and CSS
Using the JavaScript reverse router
Managing assets from the build system
Producing web assets
Pipelining web assets’ transformations
Concatenating and minifying JavaScript files
Gzipping assets
Fingerprinting assets
Managing JavaScript dependencies
Running JavaScript tests
Summary
5. Reactively Handling Long-running Requests
Play application’s execution model
Scaling up your server
Embracing non-blocking APIs
Managing execution contexts
Writing incremental computations using iteratees
Streaming results using enumerators
Manipulating data streams by combining iteratees, enumerators, and enumeratees
Unidirectional streaming with server-sent events
Preparing the ground
Transforming streams of data using enumeratees
Implementing a publish/subscribe system using Akka
Bidirectional streaming with WebSockets
Controlling the data flow
Summary
6. Leveraging the Play Stack – Security, Internationalization, Cache, and the HTTP Client
Handling security concerns
Authentication
Cross-site scripting
Cross-site request forgery
HTTP request filters
Using the CSRF filter
Enabling HTTPS
Saving computation time using cache
Serving content in several languages
Calling remote web services
Background – the OAuth 2.0 protocol
Integrating your application with your preferred social network
Implementing the OAuth client
Calling the HTTP API of your preferred social network
Summary
7. Scaling Your Codebase and Deploying Your Application
Making an action’s logic reusable and composable with action builders
Capturing the logic of actions that use blocking APIs
Capturing the logic of actions that require authentication
Combining action builders
Modularizing your code
Applying the inversion of control principle
Using dynamic calls in route definitions
Setting up a dependency injection system
Making your code injectable
Mocking components
Splitting your code into several artifacts
Splitting your controller layer into several artifacts
Application deployment
Deploying to your dedicated infrastructure
Deploying to the cloud
Handling per environment configuration
Overriding configuration settings using Java system properties
Using different configuration files
Summary
Index
Play Framework Essentials
