= Dispatcher

The +Dispatcher+ module defines a simple and consistent interface between Ruby and most webserver
configurations. This library provides a very restrictive set of features, and as such is generally
not meant to be directly used by web-application authors, but instead targets implementors of
frameworks and web-libraries.

== Basic Usage

The following is a very basic example of relaying a "Hello World" type response back to the
webserver. Notice that we rely on the +autodetection+ facilities of +Dispatcher+ here, by not
defining or configuring which webserver interface the script is to utilize.

require 'dispatcher'

Dispatcher.dispatch do |request|
header 'Status', '200 OK'
header 'Content-Type', 'text/plain'

print 'Hello World'
end

However, in some instances, we may wish to use a webserver that cannot be necessairly
+autodetected+, such as a standalone server like +Mongrel+.

require 'dispatcher/mongrel'

Dispatcher.dispatch(:port => 8081) do |request|
header 'Status', '200 OK'
header 'Content-Type', 'text/plain'

print 'Hello World'
end