Play 2 Javascript Router Setup in 4 Steps with Java

Setting up the javascript routing portion of Play is extremely simple, yet there isn't a simple doc to go along with it.

Step 1

Create a method that will be exposed via javascript.

controllers/Application.java

package controllers;

import play.Routes;
import play.mvc.Controller;
import play.mvc.Result;

public class Application extends Controller {
 public static Result kickTheDog() {
 return Controller.ok();
 }
}

Step 2

Create a route to the method that will be exposed via javascript.

conf/routes

GET /kickTheDog @controllers.Application.kickTheDog()

Step 3

Create a javascript routes generator for the new method.

controllers/Application.java

package controllers;

import play.Routes;
import play.mvc.Controller;
import play.mvc.Result;

public class Application extends Controller {
 public static Result jsRoutes() {
 response().setContentType("text/javascript");
 return ok(Routes.javascriptRouter("jsRoutes",
 controllers.routes.javascript.Application.kickTheDog()
 )
 );
 }

 public static Result kickTheDog() {
 return Controller.ok();
 }
}

conf/routes

GET /kickTheDog @controllers.Application.kickTheDog()
GET /jsRoutes @controllers.Application.jsRoutes()

Step 4

Use the javascript router by including the dynamic javascript generated stub file in your scala template.

<script type="text/javascript" src="@routes.Application.jsRoutes"></script>

Now the method can be accessed via javascript like:

jsRoutes.controllers.Application.kickTheDog().ajax({
 success: function() {

 },
 error: function() {

 }
});

Related protips

Have a fresh tip? Share with Coderwall community!