123456789_123456789_123456789_123456789_123456789_

Class: WEBrick::HTTPServlet::ERBHandler

Relationships & Source Files
Super Chains via Extension / Inclusion / Inheritance
Class Chain:
Instance Chain:
Inherits: WEBrick::HTTPServlet::AbstractServlet
Defined in: lib/webrick/httpservlet/erbhandler.rb

Overview

ERBHandler evaluates an ERB file and returns the result. This handler is automatically used if there are .rhtml files in a directory served by the FileHandler.

ERBHandler supports GET and POST methods.

The ERB file is evaluated with the local variables servlet_request and servlet_response which are a ::WEBrick::HTTPRequest and ::WEBrick::HTTPResponse respectively.

Example .rhtml file:

Request to <%= servlet_request.request_uri %>

Query params <%= servlet_request.query.inspect %>

Class Method Summary

AbstractServlet - Inherited

.get_instance

Factory for servlet instances that will handle a request from server using options from the mount point.

.new

Initializes a new servlet for server using options which are stored as-is in @options.

Instance Method Summary

AbstractServlet - Inherited

#do_GET

Raises a NotFound exception.

#do_HEAD

Dispatches to do_GET.

#do_OPTIONS

Returns the allowed HTTP request methods.

#service

Dispatches to a do_ method based on req if such a method is available.

#redirect_to_directory_uri

Redirects to a path ending in /.

Constructor Details

.new(server, name) ⇒ ERBHandler

Creates a new ERBHandler on server that will evaluate and serve the ERB file name

[ GitHub ]

  
# File 'lib/webrick/httpservlet/erbhandler.rb', line 42

def initialize(server, name)
  super(server, name)
  @script_filename = name
end

Instance Method Details

#do_GET(req, res) Also known as: #do_POST

Handles GET requests

[ GitHub ]

  
# File 'lib/webrick/httpservlet/erbhandler.rb', line 50

def do_GET(req, res)
  unless defined?(ERB)
    @logger.warn "#{self.class}: ERB not defined."
    raise HTTPStatus::Forbidden, "ERBHandler cannot work."
  end
  begin
    data = File.open(@script_filename, &:read)
    res.body = evaluate(ERB.new(data), req, res)
    res['content-type'] ||=
      HTTPUtils::mime_type(@script_filename, @config[:MimeTypes])
  rescue StandardError
    raise
  rescue Exception => ex
    @logger.error(ex)
    raise HTTPStatus::InternalServerError, ex.message
  end
end

#do_POST(req, res)

Handles POST requests

[ GitHub ]

  
# File 'lib/webrick/httpservlet/erbhandler.rb', line 71

alias do_POST do_GET

#evaluate(erb, servlet_request, servlet_response) (private)

Evaluates erb providing servlet_request and servlet_response as local variables.

[ GitHub ]

  
# File 'lib/webrick/httpservlet/erbhandler.rb', line 79

def evaluate(erb, servlet_request, servlet_response)
  Module.new.module_eval{
    servlet_request.meta_vars
    servlet_request.query
    erb.result(binding)
  }
end