Lightbend Activator

Play Framework + HBase

Activator will be EOL-ed on May 24, 2017.

We’re making it easier and simpler for developers to get started with Lightbend technologies. This unfortunately means that future releases of Play, Akka and Scala will no longer include Activator support, and Lightbend’s Activator server will be decommissioned by the end of 2017. Instead of supporting Activator to create and set up development projects, we'll be supporting standard Giter8 templates for sbt users and Maven archetypes for Maven users. So going forward,

To create new Lightbend projects

Instead of using the Activator command, make sure you have sbt 0.13.13 (or higher), and use the “sbt new” command, providing the name of the template. For example, “$ sbt new akka/hello-akka.g8”. You can find a list of templates here.

Also, as a convenience, the Lightbend Project Starter allows you to quickly create a variety of example projects that you just unzip and run.

To create new templates

If you want to create new templates, you can now do that in Giter8.

To migrate templates from Activator to Giter8

If you created Activator templates in the past, please consider migrating them to Giter8 with this simple process.

Play Framework + HBase

September 16, 2013
starter play java hbase

This template is an easy way to get started with Play Framework and HBase.

How to get "Play Framework + HBase" on your computer

There are several ways to get this template.

Option 1: Choose play-hbase in the Lightbend Activator UI.

Already have Lightbend Activator (get it here)? Launch the UI then search for play-hbase in the list of templates.

Option 2: Download the play-hbase project as a zip archive

If you haven't installed Activator, you can get the code by downloading the template bundle for play-hbase.

  1. Download the Template Bundle for "Play Framework + HBase"
  2. Extract the downloaded zip file to your system
  3. The bundle includes a small bootstrap script that can start Activator. To start Lightbend Activator's UI:

    In your File Explorer, navigate into the directory that the template was extracted to, right-click on the file named "activator.bat", then select "Open", and if prompted with a warning, click to continue:

    Or from a command line:

     C:\Users\typesafe\play-hbase> activator ui 
    This will start Lightbend Activator and open this template in your browser.

Option 3: Create a play-hbase project from the command line

If you have Lightbend Activator, use its command line mode to create a new project from this template. Type activator new PROJECTNAME play-hbase on the command line.

Option 4: View the template source

The creator of this template maintains it at

Option 5: Preview the tutorial below

We've included the text of this template's tutorial below, but it may work better if you view it inside Activator on your computer. Activator tutorials are often designed to be interactive.

Preview the tutorial

Setup HBase

You've just created a simple Play Framework + HBase application! Before we dive into the code and run the app you will need to install and start HBase on your system. First setup the CDH4 repository, then Install HBase, and Start HBase in Standalone mode.

Verify that HBase has started by running:

hbase shell
You should see something like:
HBase Shell; enter 'help<RETURN>' for list of supported commands.
Type "exit<RETURN>" to leave the HBase Shell
Version 0.94.6-cdh4.4.0, rUnknown, Tue Sep  3 20:11:37 PDT 2013


Run the App

Once the application has been compiled and the server started, your application can be accessed at: http://localhost:9000
Check in Run to see the server status.

The app has a simple web UI for listing and displaying "bars". Try to add a new "bar". Once added it should be displayed in the list.

Code Overview

Opening http://localhost:9000 in your browser renders a web page by first looking up the routing in the conf/routes file. A GET handler for / calls the index method in app/Application.scala file. This method renders a webpage using the app/views/index.scala.html server-side template. That webpage loads in the UI for the application which uses jQuery and Bootstrap. The main UI is driven through JavaScript which is compiled from the source file. That file handles making RESTful JSON requests to get the list of "bars" and add a new "bar".

In the Application.scala file, there is a lazy val hbaseConfig which configures the connection to HBase and if needed creates the table to store the "bars" in. The addBar() method adds a new row consisting of the JSON from the client. The getBars method queries the table for "bars" and then transforms them into a JSON list and returns them. You can see the JSON directly at: http://localhost:9000/bars

The application dependencies are defined in the build.sbt file.

Further Learning

To learn more about Play Framework, try out the hello-play template in Activator. (Hint: Click the Typesafe logo in the top-right to go create a new app.)

Learn more about Play Framework:

Learn more about Apache HBase: