Class: ActionDispatch::Journey::Router::Utils

Inherits:
Object
  • Object
show all
Defined in:
actionpack/lib/action_dispatch/journey/router/utils.rb

Overview

:nodoc:

Defined Under Namespace

Classes: UriEncoder

Constant Summary collapse

ENCODER =
UriEncoder.new

Class Method Summary collapse

Class Method Details

.escape_fragment(fragment) ⇒ Object



90
91
92
# File 'actionpack/lib/action_dispatch/journey/router/utils.rb', line 90

def self.escape_fragment(fragment)
  ENCODER.escape_fragment(fragment.to_s)
end

.escape_path(path) ⇒ Object



82
83
84
# File 'actionpack/lib/action_dispatch/journey/router/utils.rb', line 82

def self.escape_path(path)
  ENCODER.escape_path(path.to_s)
end

.escape_segment(segment) ⇒ Object



86
87
88
# File 'actionpack/lib/action_dispatch/journey/router/utils.rb', line 86

def self.escape_segment(segment)
  ENCODER.escape_segment(segment.to_s)
end

.normalize_path(path) ⇒ Object

Normalizes URI path.

Strips off trailing slash and ensures there is a leading slash. Also converts downcase URL encoded string to uppercase.

normalize_path("/foo")  # => "/foo"
normalize_path("/foo/") # => "/foo"
normalize_path("foo")   # => "/foo"
normalize_path("")      # => "/"
normalize_path("/%ab")  # => "/%AB"


17
18
19
20
21
22
23
24
25
26
27
28
29
# File 'actionpack/lib/action_dispatch/journey/router/utils.rb', line 17

def self.normalize_path(path)
  path ||= ""
  encoding = path.encoding
  path = +"/#{path}"
  path.squeeze!("/")

  unless path == "/"
    path.delete_suffix!("/")
    path.gsub!(/(%[a-f0-9]{2})/) { $1.upcase }
  end

  path.force_encoding(encoding)
end

.unescape_uri(uri) ⇒ Object

Replaces any escaped sequences with their unescaped representations.

uri = "/topics?title=Ruby%20on%20Rails"
unescape_uri(uri)  #=> "/topics?title=Ruby on Rails"


98
99
100
# File 'actionpack/lib/action_dispatch/journey/router/utils.rb', line 98

def self.unescape_uri(uri)
  ENCODER.unescape_uri(uri)
end