1 /* <!-- copyright */
2 /*
3  * aria2 - The high speed download utility
4  *
5  * Copyright (C) 2010 Tatsuhiro Tsujikawa
6  *
7  * This program is free software; you can redistribute it and/or modify
8  * it under the terms of the GNU General Public License as published by
9  * the Free Software Foundation; either version 2 of the License, or
10  * (at your option) any later version.
11  *
12  * This program is distributed in the hope that it will be useful,
13  * but WITHOUT ANY WARRANTY; without even the implied warranty of
14  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
15  * GNU General Public License for more details.
16  *
17  * You should have received a copy of the GNU General Public License
18  * along with this program; if not, write to the Free Software
19  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
20  *
21  * In addition, as a special exception, the copyright holders give
22  * permission to link the code of portions of this program with the
23  * OpenSSL library under certain conditions as described in each
24  * individual source file, and distribute linked combinations
25  * including the two.
26  * You must obey the GNU General Public License in all respects
27  * for all of the code used other than OpenSSL.  If you modify
28  * file(s) with this exception, you may extend this exception to your
29  * version of the file(s), but you are not obligated to do so.  If you
30  * do not wish to do so, delete this exception statement from your
31  * version.  If you delete this exception statement from all source
32  * files in the program, then also delete it here.
33  */
34 /* copyright --> */
35 #ifndef D_URI_H
36 #define D_URI_H
37 
38 #include "common.h"
39 
40 #include <string>
41 
42 #include "uri_split.h"
43 
44 namespace aria2 {
45 
46 namespace uri {
47 
48 struct UriStruct {
49   std::string protocol;
50   std::string host;
51   std::string dir;
52   std::string file;
53   std::string query;
54   std::string username;
55   std::string password;
56   uint16_t port;
57   bool hasPassword;
58   bool ipv6LiteralAddress;
59 
60   UriStruct();
61   UriStruct(const UriStruct& c);
62   ~UriStruct();
63 
64   UriStruct& operator=(const UriStruct& c);
65   void swap(UriStruct& other);
66 };
67 
68 void swap(UriStruct& lhs, UriStruct& rhs);
69 
70 // Splits URI uri into components and stores them into result.  On
71 // success returns true. Otherwise returns false and result is
72 // undefined.
73 bool parse(UriStruct& result, const std::string& uri);
74 
75 // Returns string specified by field in res. The base pointer in res
76 // is given as base. If the given field is not stored in res, returns
77 // empty string.
78 std::string getFieldString(const uri_split_result& res, int field,
79                            const char* base);
80 
81 std::string construct(const UriStruct& us);
82 
83 std::string joinUri(const std::string& baseUri, const std::string& uri);
84 
85 std::string joinPath(const std::string& basePath, const std::string& newPath);
86 
87 // Normalizes path so that: 1) it does not contain successive / and 2)
88 // resolve path component '.' and '..'. If there is not enough path
89 // component to resolve '..', those '..' are discarded. The resulting
90 // path starts / only if path starts with /.
91 std::string normalizePath(std::string path);
92 
93 } // namespace uri
94 
95 } // namespace aria2
96 
97 #endif // D_URI_H
98