mirror of
https://github.com/valitydev/osquery-1.git
synced 2024-11-07 18:08:53 +00:00
a67525fae1
Summary: Pull Request resolved: https://github.com/facebook/osquery/pull/5375 LICENSE is now defined in a single file on the root of the project, update the header to contain that information. **Project LICENSE did not change.** Reviewed By: akindyakov Differential Revision: D13750575 fbshipit-source-id: 1e608a81b260b8395f9d008fc67f463160c1fc2b
122 lines
3.5 KiB
C++
122 lines
3.5 KiB
C++
/**
|
|
* Copyright (c) 2014-present, Facebook, Inc.
|
|
* All rights reserved.
|
|
*
|
|
* This source code is licensed as defined on the LICENSE file found in the
|
|
* root directory of this source tree.
|
|
*/
|
|
|
|
#pragma once
|
|
|
|
#include <string>
|
|
#include <vector>
|
|
|
|
namespace osquery {
|
|
|
|
/**
|
|
* Class representing a URI.
|
|
* This URI class is from folly/uri.
|
|
*
|
|
* Consider http://www.facebook.com/foo/bar?key=foo#anchor
|
|
*
|
|
* The URI is broken down into its parts: scheme ("http"), authority
|
|
* (ie. host and port, in most cases: "www.facebook.com"), path
|
|
* ("/foo/bar"), query ("key=foo") and fragment ("anchor"). The scheme is
|
|
* lower-cased.
|
|
*
|
|
* If this Uri represents a URL, note that, to prevent ambiguity, the component
|
|
* parts are NOT percent-decoded; you should do this yourself with
|
|
* uriUnescape() (for the authority and path) and uriUnescape(...,
|
|
* UriEscapeMode::QUERY) (for the query, but probably only after splitting at
|
|
* '&' to identify the individual parameters).
|
|
*/
|
|
class Uri {
|
|
public:
|
|
/**
|
|
* Parse a Uri from a string. Throws std::invalid_argument on parse error.
|
|
*/
|
|
explicit Uri(const std::string& str);
|
|
|
|
const std::string& scheme() const {
|
|
return scheme_;
|
|
}
|
|
const std::string& username() const {
|
|
return username_;
|
|
}
|
|
const std::string& password() const {
|
|
return password_;
|
|
}
|
|
/**
|
|
* Get host part of URI. If host is an IPv6 address, square brackets will be
|
|
* returned, for example: "[::1]".
|
|
*/
|
|
const std::string& host() const {
|
|
return host_;
|
|
}
|
|
/**
|
|
* Get host part of URI. If host is an IPv6 address, square brackets will not
|
|
* be returned, for example "::1"; otherwise it returns the same thing as
|
|
* host().
|
|
*
|
|
* hostname() is what one needs to call if passing the host to any other tool
|
|
* or API that connects to that host/port; e.g. getaddrinfo() only understands
|
|
* IPv6 host without square brackets
|
|
*/
|
|
std::string hostname() const;
|
|
uint16_t port() const {
|
|
return port_;
|
|
}
|
|
const std::string& path() const {
|
|
return path_;
|
|
}
|
|
const std::string& query() const {
|
|
return query_;
|
|
}
|
|
const std::string& fragment() const {
|
|
return fragment_;
|
|
}
|
|
|
|
std::string authority() const;
|
|
|
|
void setPort(uint16_t port) {
|
|
hasAuthority_ = true;
|
|
port_ = port;
|
|
}
|
|
|
|
/**
|
|
* Get query parameters as key-value pairs.
|
|
* e.g. for URI containing query string: key1=foo&key2=&key3&=bar&=bar=
|
|
* In returned list, there are 3 entries:
|
|
* "key1" => "foo"
|
|
* "key2" => ""
|
|
* "key3" => ""
|
|
* Parts "=bar" and "=bar=" are ignored, as they are not valid query
|
|
* parameters. "=bar" is missing parameter name, while "=bar=" has more than
|
|
* one equal signs, we don't know which one is the delimiter for key and
|
|
* value.
|
|
*
|
|
* Note, this method is not thread safe, it might update internal state, but
|
|
* only the first call to this method update the state. After the first call
|
|
* is finished, subsequent calls to this method are thread safe.
|
|
*
|
|
* @return query parameter key-value pairs in a vector, each element is a
|
|
* pair of which the first element is parameter name and the second
|
|
* one is parameter value
|
|
*/
|
|
const std::vector<std::pair<std::string, std::string>>& getQueryParams();
|
|
|
|
private:
|
|
std::string scheme_;
|
|
std::string username_;
|
|
std::string password_;
|
|
std::string host_;
|
|
bool hasAuthority_;
|
|
uint16_t port_;
|
|
std::string path_;
|
|
std::string query_;
|
|
std::string fragment_;
|
|
std::vector<std::pair<std::string, std::string>> queryParams_;
|
|
};
|
|
|
|
} // namespace osquery
|