cadorn / jack-servlet

A servlet for running JSGI / Jack compatible server-side JavaScript applications and frameworks on Google AppEngine for Java or other servlet containers

Jack Servlet

Requirements

1. Narwhal: http://github.com/tlrobinson/narwhal
2. Jack: http://github.com/tlrobinson/jack

Quick Start

git clone git://github.com/280north/narwhal.git
export PATH=$PATH:narwhal/bin
tusk install jack
git clone git://github.com/tlrobinson/jack-servlet.git
cd jack-servlet
ant runserver

AppEngine Instructions

1. Set the APPENGINE_JAVA_SDK environment variable to the location of the AppEngine SDK (http://code.google.com/appengine/downloads.html), or change the "sdk.dir" property in the build.xml file.
2. Ensure "war/WEB-INF/narwhal" is a Narwhal distribution (currently symlinked to "narwhal" in the parent directory) and "war/WEB-INF/narwhal/packages/jack" is a Jack distribution.
3. Place your Jack application in "war/WEB-INF" with the main module called "jackconfig.js", which exports the main Jack application as "app".
4. "ant runserver" to run locally.
5. Edit the AppEngine application ID in "war/WEB-INF/appengine-web.xml".
6. "ant update" to deploy.

Other Servlet Container Instructions

Coming soon.

Notes

• You can change the default modules path, module name, application name, environment name using the "modulesPath", "module", "app", and "environment" init-params in web.xml, i.e.:

  jack org.jackjs.JackServlet modulesPath WEB-INF module jackconfig.js app app environment production

• In addition to the "war/WEB-INF/narwhal" symlink, there are relative symlinks to Rhino in "war/WEB-INF/lib/js.jar" and an example application at "war/WEB-INF/jackconfig.js"

Wildfire

You can enable wildfire support with

<servlet>
  <init-param>
    <param-name>wildfire</param-name>
    <param-value>1</param-value>
  </init-param>
</servlet>

and place the wildfire using packages into war/WEB-INF/using.