Skip to content
This repository

Fetching latest commit…


Cannot retrieve the latest commit at this time

Octocat-spinner-32 output
Octocat-spinner-32 templates
Octocat-spinner-32 ScalatraServerGenerator.scala

Swagger generated server


Using the swagger-codegen, you can not only generate clients but servers as well! The same spec can be used to drive your development both ways. This is an example of generating a server for scalatra.


You need the following installed and available in your $PATH:

- sbt 0.12 (

- Scala 2.9.1 available here

You also need to add both the sbt and scala binary to your PATH.

Generating a server

You first need to build the swagger-codegen project--this is done by running this command at the root of the swagger-codegen project:

sbt assembly

You can now generate a server from any valid** swagger spec:

./bin/ samples/server-generator/scalatra/ScalatraServerGenerator.scala special-key

After executing this script, you will have an output directory with the server-generated files:

$ cd samples/server-generator/scalatra/output
$ find  -type f

To run the server, cd to the samples/server-generator/scalatra/output folder and run:


> container:start

You can now load the swagger-ui against http://localhost:8080/api-docs. Of course this isn't a fully runnable server! You have to add the logic in the apis/*.scala files. But that's the easy part.

Making it your own

Running the sample is easy, but how about making your own server? Easy! Just modify the samples/server-generator/scalatra/ScalatraServerGenerator.scala file.

Don't like the templates? Don't worry, we're not offended! They're mustache templates and are easy to modify. Take a look at the sample templates here:

- Generator for your api classes: api.mustache

- Generator for your models: model.mustache

- The main class to run your server: ServletApp.mustache

Sound easy? It is!

Something went wrong with that request. Please try again.