Borges::Session ^(Class)

In:

lib/Borges/RequestHandler/Session.rb

Parent:

Methods

action_url_for_continuation action_url_for_key active? add_filter add_to_path all_subclasses application application base_path basic_auth_do bookmark_for_expiry current_session default_preferences enter_session enter_session_with error_page_class filter handle_error handle_request handle_request_intern in_thread inherited initialize_with isolate once page_expired path perform_request redirect redirect_to redirect_with_message_in register_for_backtracking remove_filter respond response_for response_for_request return_response start start_handler_thread unknown_request with_error_handler with_escape_continuation wrap_continuation

Public Class methods

all_subclasses()

application(app)

Creates a new session that is attached to application app.

current_session()

HACK This is totally bogus!

default_preferences()

Returns Session’s default preferences.

inherited(klass)

Public Instance methods

action_url_for_continuation(cont)

Registers continuation cont, returning a URL to resume it.

action_url_for_key(str)

Creates a URL for str rooted from the application’s path.

Returns the active state of this Session. A handler is active if it has been accessed within the session expiry time.

add_filter(filter)

Add filter to the filters active for the session.

add_to_path(str)

Adds str after base_path.

Returns the application this session is attached to.

Returns the base path from the Session’s application.

basic_auth_do(auth_block, &block)

bookmark_for_expiry()

enter_session() {|| ...}

Creates an environment for executing code within a session.

enter_session_with(req)

Creates a new session with for req.

error_page_class()

Returns the class to use for error handling from this application’s preferences.

filter(filter) {|| ...}

Wraps a block within filter.

handle_error(e)

Creates and returns an error page for e

handle_request(req)

Creates a Response for req.

handle_request_intern(req)

Does the work of handling the request inside the Session thread.

in_thread(&block)

Passes block into the session’s thread for processing.

initialize_with(application)

TODO Refactor into initialize

HACK Thread.current[:session] is a hack

isolate(&block)

Invokes the expiry continuation.

Returns the path of this application. A synonym for the application’s name.

perform_request(req)

Handles req for valid requests, or passes the request to unknown_request.

Creates a RedirectResponse pointing to a new URL. redirect is used to eliminate the duplicate POST problem.

redirect_to(url)

Creates a RedirectResponse pointing to url.

redirect_with_message_in(message, seconds)

Creates a META refresh with message that refreshes to a new URL in seconds. Used for pages that have expired.

register_for_backtracking(obj)

remove_filter(filter)

Remove filter from the filters active for the session.

respond(&block)

Stores a response point and passes its URL to block. When the action for the URL is invoked, it will pass to the request to a list of filters for processing.

Must be wrapped in with_escape_continuation.

response_for(&block)

Creates a response for block.

response_for_request(req)

Creates a response page for req.

return_response(res)

Invokes the escape continuation, returning res to where with_escape_continuation was called.

start(req = nil)

Abstract method that starts the session.

start_handler_thread()

Starts up the session’s thread.

unknown_request(req)

A new Session is created for a request for an unknown page.

with_error_handler(&block)

Wraps a block with an error handler that will create an error response for any exception.

with_escape_continuation(&block)

Wraps block with a continuation that returns the value of the block to the point of call, and stores the continuation in @escape_continuation.

wrap_continuation(cont)

Wraps cont in a proc that restores the state at time of creation.