class Rack::Handler::Mongrel - rack-1.6.4 Documentation

# class Rack::Handler::Mongrel

### Public Class Methods

new(app) click to toggle source

    # File lib/rack/handler/mongrel.rb, line 57
    def initialize(app)
      @app = app
    end

run(app, options={}) { |server| ... } click to toggle source

    # File lib/rack/handler/mongrel.rb, line 9
    def self.run(app, options={})
      environment  = ENV['RACK_ENV'] || 'development'
      default_host = environment == 'development' ? 'localhost' : '0.0.0.0'

      server = ::Mongrel::HttpServer.new(
        options[:Host]           || default_host,
        options[:Port]           || 8080,
        options[:num_processors] || 950,
        options[:throttle]       || 0,
        options[:timeout]        || 60)
      # Acts like Rack::URLMap, utilizing Mongrel's own path finding methods.
      # Use is similar to #run, replacing the app argument with a hash of
      # { path=>app, ... } or an instance of Rack::URLMap.
      if options[:map]
        if app.is_a? Hash
          app.each do |path, appl|
            path = '/'+path unless path[0] == ?/
            server.register(path, Rack::Handler::Mongrel.new(appl))
          end
        elsif app.is_a? URLMap
          app.instance_variable_get(:@mapping).each do |(host, path, appl)|
           next if !host.nil? && !options[:Host].nil? && options[:Host] != host
           path = '/'+path unless path[0] == ?/
           server.register(path, Rack::Handler::Mongrel.new(appl))
          end
        else
          raise ArgumentError, "first argument should be a Hash or URLMap"
        end
      else
        server.register('/', Rack::Handler::Mongrel.new(app))
      end
      yield server  if block_given?
      server.run.join
    end

valid_options() click to toggle source

    # File lib/rack/handler/mongrel.rb, line 44
    def self.valid_options
      environment  = ENV['RACK_ENV'] || 'development'
      default_host = environment == 'development' ? 'localhost' : '0.0.0.0'

      {
        "Host=HOST" => "Hostname to listen on (default: #{default_host})",
        "Port=PORT" => "Port to listen on (default: 8080)",
        "Processors=N" => "Number of concurrent processors to accept (default: 950)",
        "Timeout=N" => "Time before a request is dropped for inactivity (default: 60)",
        "Throttle=N" => "Throttle time between socket.accept calls in hundredths of a second (default: 0)",
      }
    end

### Public Instance Methods

process(request, response) click to toggle source

    # File lib/rack/handler/mongrel.rb, line 61
    def process(request, response)
      env = Hash[request.params]
      env.delete "HTTP_CONTENT_TYPE"
      env.delete "HTTP_CONTENT_LENGTH"

      env["SCRIPT_NAME"] = ""  if env["SCRIPT_NAME"] == "/"

      rack_input = request.body || StringIO.new('')
      rack_input.set_encoding(Encoding::BINARY) if rack_input.respond_to?(:set_encoding)

      env.update({"rack.version" => Rack::VERSION,
                   "rack.input" => rack_input,
                   "rack.errors" => $stderr,

                   "rack.multithread" => true,
                   "rack.multiprocess" => false, # ???
                   "rack.run_once" => false,

                   "rack.url_scheme" => ["yes", "on", "1"].include?(env["HTTPS"]) ? "https" : "http"
                 })
      env[QUERY_STRING] ||= ""

      status, headers, body = @app.call(env)

      begin
        response.status = status.to_i
        response.send_status(nil)

        headers.each { |k, vs|
          vs.split("\n").each { |v|
            response.header[k] = v
          }
        }
        response.send_header

        body.each { |part|
          response.write part
          response.socket.flush
        }
      ensure
        body.close  if body.respond_to? :close
      end
    end