#reader(lib "docreader.ss" "scribble")
@require["../web-server.ss"]

@title[#:tag "servlet-env.ss"
       #:style 'toc]{Servlet Environment}

The @file{web-server} provides a means of running Scheme servlets
from within DrScheme, or any other REPL.

@file{servlet-env.ss} provides the servlet API from @file{servlet.ss}
as well as the following special forms:

@defform[(on-web servlet-expr)]{This expands to @scheme[(on-web 8000 servlet-expr)].}

@defform[(on-web port servlet-expr)]{
 This constructs a small servlet, where the body of the @scheme[start] procedure is
 @scheme[servlet-expr], runs the @file{web-server} on port @scheme[port], and opens
 a browser to a URL accessing the constructed servlet. The call blocks until the
 servlet finishes its computation, i.e. @scheme[servlet-expr] is evaluated, and
 returns its result.
}