net.loadbang.web

This package is an embedded web server for MaxMSP, written in Java and using Jetty. The system supports static data and JSPs. The server is packaged into an MXJ object, and can serve files from any directory in MaxMSP's search path. It implements two-way communication with Max: the object reports web requests into the Max world, and Max can create attribute bindings for JSPs.

Installation

The following files (there are rather a lot of them) are needed in Max's Cycling '74/java/lib directory:

• net.loadbang.web-0.0.1-SNAPSHOT.jar
• jetty-6.1.26.jar
• jetty-util-6.1.26.jar
• net.loadbang.lib-1.8.0.jar
• jsp-2.1-6.0.2.jar
• jsp-api-2.1-6.0.2.jar
• servlet-api-2.5-20081211.jar
• ant-1.8.4.jar
• ant-launcher-1.8.4.jar
• log4j-1.2.16.jar

These files are all included in distribution.zip in downloads, alongside the test patchers.

Usage

The directory examples contains Max patchers (written originally for Max 4!) which bring up the web server. examples/WebServer.mxt is a good place to start, but the real party is happening in examples/max5/cassiel.JWebFun.maxpat.

Building

The net.loadbang support projects, all hosted in GitHub, are written in Java and can be built in Maven. They need to be built in sequence since they aren't centrally hosted. The max.jar file also needs to be pushed into a local Maven repository. See the README for net.loadbang.lib for details.

Acknowledgements

Thanks to Adam Murray for contributions to the JSP support.

PS

Because somebody is bound to ask: here's what it all looks like in Max for Live, for when you absolutely have to run a web server inside your Live session:

License

Distributed under the GNU General Public License.

Copyright (C) 2012 Nick Rothwell.