Class: Rack::Handler::WEBrick

### Home Classes Methods

### In Files

- lib/rack/handler/webrick.rb

### Parent

WEBrick::HTTPServlet::AbstractServlet

### Methods

- ::new
- ::run
- ::shutdown
- ::valid_options
- #service

### Files

- KNOWN-ISSUES

### Class/Module Index

Quicksearch

- Rack
- Rack::Auth
- Rack::Auth::AbstractHandler
- Rack::Auth::AbstractRequest
- Rack::Auth::Basic
- Rack::Auth::Basic::Request
- Rack::Auth::Digest
- Rack::Auth::Digest::MD5
- Rack::Auth::Digest::Nonce
- Rack::Auth::Digest::Params
- Rack::Auth::Digest::Request
- Rack::BodyProxy
- Rack::Builder
- Rack::Cascade
- Rack::Chunked
- Rack::Chunked::Body
- Rack::CommonLogger
- Rack::ConditionalGet
- Rack::Config
- Rack::ContentLength
- Rack::ContentType
- Rack::Deflater
- Rack::Deflater::DeflateStream
- Rack::Deflater::GzipStream
- Rack::Directory
- Rack::ETag
- Rack::File
- Rack::ForwardRequest
- Rack::Handler
- Rack::Handler::CGI
- Rack::Handler::EventedMongrel
- Rack::Handler::FastCGI
- Rack::Handler::LSWS
- Rack::Handler::Mongrel
- Rack::Handler::SCGI
- Rack::Handler::SwiftipliedMongrel
- Rack::Handler::Thin
- Rack::Handler::WEBrick
- Rack::Head
- Rack::Lint
- Rack::Lobster
- Rack::Lock
- Rack::Logger
- Rack::MethodOverride
- Rack::Mime
- Rack::MockRequest
- Rack::MockRequest::FatalWarner
- Rack::MockRequest::FatalWarning
- Rack::MockResponse
- Rack::Multipart
- Rack::Multipart::Generator
- Rack::Multipart::MultipartPartLimitError
- Rack::Multipart::Parser
- Rack::Multipart::UploadedFile
- Rack::NullLogger
- Rack::Recursive
- Rack::Reloader
- Rack::Reloader::Stat
- Rack::Request
- Rack::Response
- Rack::Response::Helpers
- Rack::RewindableInput
- Rack::RewindableInput::Tempfile
- Rack::Runtime
- Rack::Sendfile
- Rack::Server
- Rack::Server::Options
- Rack::Session
- Rack::Session::Abstract
- Rack::Session::Abstract::ID
- Rack::Session::Abstract::SessionHash
- Rack::Session::Cookie
- Rack::Session::Cookie::Base64
- Rack::Session::Cookie::Base64::JSON
- Rack::Session::Cookie::Base64::Marshal
- Rack::Session::Cookie::Base64::ZipJSON
- Rack::Session::Cookie::Identity
- Rack::Session::Memcache
- Rack::Session::Pool
- Rack::ShowExceptions
- Rack::ShowStatus
- Rack::Static
- Rack::TempfileReaper
- Rack::URLMap
- Rack::Utils
- Rack::Utils::Context
- Rack::Utils::HeaderHash
- Rack::Utils::InvalidParameterError
- Rack::Utils::KeySpaceConstrainedParams
- Rack::Utils::Multipart
- Rack::Utils::OkJson
- Rack::Utils::OkJson::Error
- Rack::Utils::OkJson::Utf8Error
- Rack::Utils::ParameterTypeError
- FCGI
- FCGI::Stream
- WEBrick
- WEBrick::HTTPResponse
- Object

No matching classes.

# Rack::Handler::WEBrick

### Public Class Methods

new(server, app) click to toggle source

    # File lib/rack/handler/webrick.rb, line 52
    def initialize(server, app)
      super server
      @app = app
    end

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

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

      options[:BindAddress] = options.delete(:Host) || default_host
      options[:Port] ||= 8080
      @server = ::WEBrick::HTTPServer.new(options)
      @server.mount "/", Rack::Handler::WEBrick, app
      yield @server  if block_given?
      @server.start
    end

shutdown() click to toggle source

    # File lib/rack/handler/webrick.rb, line 47
    def self.shutdown
      @server.shutdown
      @server = nil
    end

valid_options() click to toggle source

    # File lib/rack/handler/webrick.rb, line 37
    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)",
      }
    end

### Public Instance Methods

service(req, res) click to toggle source

    # File lib/rack/handler/webrick.rb, line 57
    def service(req, res)
      res.rack = true
      env = req.meta_vars
      env.delete_if { |k, v| v.nil? }

      rack_input = StringIO.new(req.body.to_s)
      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",

                   "rack.hijack?" => true,
                   "rack.hijack" => lambda { raise NotImplementedError, "only partial hijack is supported."},
                   "rack.hijack_io" => nil,
                 })

      env["HTTP_VERSION"] ||= env["SERVER_PROTOCOL"]
      env[QUERY_STRING] ||= ""
      unless env[PATH_INFO] == ""
        path, n = req.request_uri.path, env["SCRIPT_NAME"].length
        env[PATH_INFO] = path[n, path.length-n]
      end
      env["REQUEST_PATH"] ||= [env["SCRIPT_NAME"], env[PATH_INFO]].join

      status, headers, body = @app.call(env)
      begin
        res.status = status.to_i
        headers.each { |k, vs|
          next if k.downcase == "rack.hijack"

          if k.downcase == "set-cookie"
            res.cookies.concat vs.split("\n")
          else
            # Since WEBrick won't accept repeated headers,
            # merge the values per RFC 1945 section 4.2.
            res[k] = vs.split("\n").join(", ")
          end
        }

        io_lambda = headers["rack.hijack"]
        if io_lambda
          rd, wr = IO.pipe
          res.body = rd
          res.chunked = true
          io_lambda.call wr
        elsif body.respond_to?(:to_path)
          res.body = ::File.open(body.to_path, 'rb')
        else
          body.each { |part|
            res.body << part
          }
        end
      ensure
        body.close  if body.respond_to? :close
      end
    end

[Validate]

Generated with the Darkfish Rdoc Generator 2.