src/url/url_canon_pathurl.cc

   1 // Copyright 2013 The Chromium Authors. All rights reserved.
   2 // Use of this source code is governed by a BSD-style license that can be
   3 // found in the LICENSE file.
   4
   5 // Functions for canonicalizing "path" URLs. Not to be confused with the path
   6 // of a URL, these are URLs that have no authority section, only a path. For
   7 // example, "javascript:" and "data:".
   8
   9 #include "url/url_canon.h"
  10 #include "url/url_canon_internal.h"
  11
  12 namespace url {
  13
  14 namespace {
  15
  16 // Canonicalize the given |component| from |source| into |output| and
  17 // |new_component|. If |separator| is non-zero, it is pre-pended to |ouput|
  18 // prior to the canonicalized component; i.e. for the '?' or '#' characters.
  19 template<typename CHAR, typename UCHAR>
  20 bool DoCanonicalizePathComponent(const CHAR* source,
  21                                  const Component& component,
  22                                  char separator,
  23                                  CanonOutput* output,
  24                                  Component* new_component) {
  25   bool success = true;
  26   if (component.is_valid()) {
  27     if (separator)
  28       output->push_back(separator);
  29     // Copy the path using path URL's more lax escaping rules (think for
  30     // javascript:). We convert to UTF-8 and escape non-ASCII, but leave all
  31     // ASCII characters alone. This helps readability of JavaStript.
  32     new_component->begin = output->length();
  33     int end = component.end();
  34     for (int i = component.begin; i < end; i++) {
  35       UCHAR uch = static_cast<UCHAR>(source[i]);
  36       if (uch < 0x20 || uch >= 0x80)
  37         success &= AppendUTF8EscapedChar(source, &i, end, output);
  38       else
  39         output->push_back(static_cast<char>(uch));
  40     }
  41     new_component->len = output->length() - new_component->begin;
  42   } else {
  43     // Empty part.
  44     new_component->reset();
  45   }
  46   return success;
  47 }
  48
  49 template <typename CHAR, typename UCHAR>
  50 bool DoCanonicalizePathURL(const URLComponentSource<CHAR>& source,
  51                            const Parsed& parsed,
  52                            CanonOutput* output,
  53                            Parsed* new_parsed) {
  54   // Scheme: this will append the colon.
  55   bool success = CanonicalizeScheme(source.scheme, parsed.scheme,
  56                                     output, &new_parsed->scheme);
  57
  58   // We assume there's no authority for path URLs. Note that hosts should never
  59   // have -1 length.
  60   new_parsed->username.reset();
  61   new_parsed->password.reset();
  62   new_parsed->host.reset();
  63   new_parsed->port.reset();
  64   // We allow path URLs to have the path, query and fragment components, but we
  65   // will canonicalize each of the via the weaker path URL rules.
  66   success &= DoCanonicalizePathComponent<CHAR, UCHAR>(
  67       source.path, parsed.path, '\0', output, &new_parsed->path);
  68   success &= DoCanonicalizePathComponent<CHAR, UCHAR>(
  69       source.query, parsed.query, '?', output, &new_parsed->query);
  70   success &= DoCanonicalizePathComponent<CHAR, UCHAR>(
  71       source.ref, parsed.ref, '#', output, &new_parsed->ref);
  72
  73   return success;
  74 }
  75
  76 }  // namespace
  77
  78 bool CanonicalizePathURL(const char* spec,
  79                          int spec_len,
  80                          const Parsed& parsed,
  81                          CanonOutput* output,
  82                          Parsed* new_parsed) {
  83   return DoCanonicalizePathURL<char, unsigned char>(
  84       URLComponentSource<char>(spec), parsed, output, new_parsed);
  85 }
  86
  87 bool CanonicalizePathURL(const base::char16* spec,
  88                          int spec_len,
  89                          const Parsed& parsed,
  90                          CanonOutput* output,
  91                          Parsed* new_parsed) {
  92   return DoCanonicalizePathURL<base::char16, base::char16>(
  93       URLComponentSource<base::char16>(spec), parsed, output, new_parsed);
  94 }
  95
  96 bool ReplacePathURL(const char* base,
  97                     const Parsed& base_parsed,
  98                     const Replacements<char>& replacements,
  99                     CanonOutput* output,
 100                     Parsed* new_parsed) {
 101   URLComponentSource<char> source(base);
 102   Parsed parsed(base_parsed);
 103   SetupOverrideComponents(base, replacements, &source, &parsed);
 104   return DoCanonicalizePathURL<char, unsigned char>(
 105       source, parsed, output, new_parsed);
 106 }
 107
 108 bool ReplacePathURL(const char* base,
 109                     const Parsed& base_parsed,
 110                     const Replacements<base::char16>& replacements,
 111                     CanonOutput* output,
 112                     Parsed* new_parsed) {
 113   RawCanonOutput<1024> utf8;
 114   URLComponentSource<char> source(base);
 115   Parsed parsed(base_parsed);
 116   SetupUTF16OverrideComponents(base, replacements, &utf8, &source, &parsed);
 117   return DoCanonicalizePathURL<char, unsigned char>(
 118       source, parsed, output, new_parsed);
 119 }
 120
 121 }  // namespace url