Skip to content

Latest commit

 

History

History
51 lines (30 loc) · 1.84 KB

README.md

File metadata and controls

51 lines (30 loc) · 1.84 KB

This is an example Ratpack app, based on the Vert.x version. It is a subset port of http://groovyconsole.appspot.com/.

It is also using the Ratpack Gradle plugin as the development environment.

About

This app shows off some of the ratpack features, and the Gradle integration.

Getting Started

Check this project out, cd into the directory and run:

./gradlew run

This will start the ratpack app. In your browser go to http://localhost:5050.

The Gradle Ratpack plugin builds on the Gradle Application plugin. This means it's easy to create a standalone distribution for your app.

Run:

./gradlew installApp
cd build/install/groovy-web-console/
bin/groovy-web-console

Your app should now be running (see http://gradle.org/docs/current/userguide/application_plugin.html) for more on what the Gradle application plugin can do for you.

Development time reloading

One of the key Ratpack features is support for runtime reloading. The src/ratpack/ratpack.groovy file (which defines the request routes and handlers) can be changed at runtime.

Furthermore, full reloading of supporting classes (i.e. src/main/groovy) is enabled via SpringSource's SpringLoaded library.

See src/ratpack/ratpack.groovy and src/main/groovy/groovywebconsole/ReloadingThing.groovy for instructions on how to test the SpringLoaded based reloading.

IDEA integration

The Ratpack Gradle plugin has special support for IntelliJ IDEA. To open the project in IDEA, run:

./gradlew idea

If you have the idea command line tool installed you can then run:

idea groovy-web-console.ipr

In the “Run” menu, you will find a run configuration for launching the Ratpack app from within your IDE. Hot reloading is supported in this mode. See src/main/groovy/groovywebconsole/ReloadingThing.groovy for details.