class Marten::Handlers::Redirect

Overview

Handler allowing to conveniently return redirect responses.

Defined in:

marten/handlers/redirect.cr

Class Method Summary

Instance Method Summary

Instance methods inherited from class Marten::Handlers::Base

context context, delete delete, dispatch : Marten::HTTP::Response dispatch, get get, head(status : ::HTTP::Status | Int32) : HTTP::Response
head head, json(raw_json : String, status : ::HTTP::Status | Int32 = 200)
json(serializable, status : ::HTTP::Status | Int32 = 200) json, options options, params : Marten::Routing::MatchParameters params, patch patch, post post, put put, redirect(url : String, permanent = false) redirect, render(template_name : String, context : Hash | NamedTuple | Nil | Marten::Template::Context = nil, content_type = HTTP::Response::DEFAULT_CONTENT_TYPE, status : ::HTTP::Status | Int32 = 200) render, request : Marten::HTTP::Request request, respond(streamed_content : Iterator(String), content_type = HTTP::Response::DEFAULT_CONTENT_TYPE, status : ::HTTP::Status | Int32 = 200)
respond(content = "", content_type = HTTP::Response::DEFAULT_CONTENT_TYPE, status : ::HTTP::Status | Int32 = 200) respond, response : Marten::HTTP::Response? response, response! response!, reverse(*args, **options)
reverse(*args, **options, &) reverse, trace trace

Constructor methods inherited from class Marten::Handlers::Base

new(request : HTTP::Request, params : Routing::MatchParameters)
new(request : HTTP::Request, **kwargs) new

Class methods inherited from class Marten::Handlers::Base

content_security_policy_block content_security_policy_block, http_method_names
http_method_names(*method_names : String | Symbol) http_method_names

Instance methods inherited from module Marten::Handlers::Session

session(*args, **options)
session(*args, **options, &) session

Instance methods inherited from module Marten::Handlers::RequestForgeryProtection

get_csrf_token get_csrf_token, referer_trusted? referer_trusted?

Instance methods inherited from module Marten::Handlers::Flash

flash(*args, **options)
flash(*args, **options, &) flash

Instance methods inherited from module Marten::Handlers::Cookies

cookies(*args, **options)
cookies(*args, **options, &) cookies

Class Method Detail

def self.forward_query_string(forward_query_string : Bool) #

Allows to configure whether query strings should be copied into the redirect URL.


[View source]
def self.forward_query_string? : Bool #

Indicates whether query strings should be copied into the redirect URL or not.

Defaults to false.


[View source]
def self.permanent(permanent : Bool) #

Allows to configure whether the redirection is permanent or not.


[View source]
def self.permanent? : Bool #

Indicates whether the redirection is permanent or not.

Defaults to false.


[View source]
def self.route_name(route_name : String | Nil) #

Allows to configure the route name that should be resolved to produce the URL to redirect to.


[View source]
def self.route_name : String | Nil #

Returns the configured route name that should be resolved to produce the URL to redirect to.

Defaults to nil.


[View source]
def self.url(url : String | Nil) #

Allows to configure a raw URL to redirect to.


[View source]
def self.url : String | Nil #

Returns the configured raw URL to redirect to.

Defaults to nil.


[View source]

Instance Method Detail

def delete #
Description copied from class Marten::Handlers::Base

Handles a DELETE HTTP request and returns a Marten::HTTP::Response object.

The default implementation will return a 405 (not allowed) response.


[View source]
def get #
Description copied from class Marten::Handlers::Base

Handles a GET HTTP request and returns a Marten::HTTP::Response object.

The default implementation will return a 405 (not allowed) response.


[View source]
def head #
Description copied from class Marten::Handlers::Base

Handles a HEAD HTTP request and returns a Marten::HTTP::Response object.

The default implementation is to return whatever is returned by the #get method.


[View source]
def options #
Description copied from class Marten::Handlers::Base

Handles an OPTIONS HTTP request and returns a Marten::HTTP::Response object.

The default implementation will return an HTTP response that includes an Allow header populated from the configured allowed HTTP methods.


[View source]
def patch #
Description copied from class Marten::Handlers::Base

Handles a PATCH HTTP request and returns a Marten::HTTP::Response object.

The default implementation will return a 405 (not allowed) response.


[View source]
def post #
Description copied from class Marten::Handlers::Base

Handles a POST HTTP request and returns a Marten::HTTP::Response object.

The default implementation will return a 405 (not allowed) response.


[View source]
def put #
Description copied from class Marten::Handlers::Base

Handles a PUT HTTP request and returns a Marten::HTTP::Response object.

The default implementation will return a 405 (not allowed) response.


[View source]
def redirect_url #

Returns the URL to redirect to.

By default, the URL will be determined from the configured #url and #route_name values. This method can be overridden on subclasses in order to define any arbitrary logics that might be necessary in order to determine the final redirection URL.


[View source]