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>
DoCanonicalizePathComponent(const CHAR * source,const Component & component,CHAR seperator,CanonOutput * output,Component * new_component)20 bool DoCanonicalizePathComponent(const CHAR* source,
21 const Component& component,
22 CHAR seperator,
23 CanonOutput* output,
24 Component* new_component) {
25 bool success = true;
26 if (component.is_valid()) {
27 if (seperator)
28 output->push_back(seperator);
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>
DoCanonicalizePathURL(const URLComponentSource<CHAR> & source,const Parsed & parsed,CanonOutput * output,Parsed * new_parsed)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
CanonicalizePathURL(const char * spec,int spec_len,const Parsed & parsed,CanonOutput * output,Parsed * new_parsed)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
CanonicalizePathURL(const base::char16 * spec,int spec_len,const Parsed & parsed,CanonOutput * output,Parsed * new_parsed)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
ReplacePathURL(const char * base,const Parsed & base_parsed,const Replacements<char> & replacements,CanonOutput * output,Parsed * new_parsed)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
ReplacePathURL(const char * base,const Parsed & base_parsed,const Replacements<base::char16> & replacements,CanonOutput * output,Parsed * new_parsed)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
122