A giter8 template for a web application using Scalatra, Casbah and MongoDB
Scala Shell
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
src/main/g8
.gitignore
README.md

README.md

Scalatra MongoDB project

g8 template to get a Scalatra web service up and running quickly with MongoDB support using Casbah. The template generates a project that uses SBT 0.11.1. It will not build under 0.7.x or 0.10.x versions of SBT. There is a branch for 0.10.x if you like.

Usage

Install giter8 (g8) - readme for more information.

Install SBT 0.11.2 - Setup for more information.

In a shell, run the following:

g8 JanxSpirit/scalatra-mongodb
cd <name-of-app>
sbt
> update
> container:start

You should be able to browse to a test resource

What's inside

The servlet provides two resources:

  1. 'test' - a 'Hello World' type resource just to make sure everything is working.
  2. 'msgs' - GET msgs to see all records currently in the database and a form to add another record - the form issues a POST to the same resource to add records

The project includes a few basic tests to get you started. Run 'sbt test' to see the test output.

The template allows you to configure where your MongoDB server is running, the name of your servlet and other parameters.

Executable Jar

At the SBT prompt you can run 'assembly' to generate an executable jar in the /target directory, It bundles Jetty and Scala and takes an optional argument for port (default is 8080).

java -jar /target/myproject-assembly.jar

Standalone Shell Script

In the root of the project, run something like

cat src/main/resources/execute_jar.sh target/scalatra-mongodb-project-assembly-1.0.jar > target/scalatra_mongo

That will make a handy standalone shell command called target/scalatra_mongo that wraps the executable jar created above. chmod +x that script and you can run your app with no 'java -jar ...'

Thanks

Thanks to Nathan Hamblen for giter8, Brendan McAdams for the Casbah MongoDB Driver, Ross Baker for Scalatra and Coda Hale and Eugene Yokota for the SBT Assembly Plugin.