e800605ad3
This URL library ends up being a relatively fundamental base library of the system, as LibCore depends on LibURL. This change has two main benefits: * Moving AK back more towards being an agnostic library that can be used between the kernel and userspace. URL has never really fit that description - and is not used in the kernel. * URL _should_ depend on LibUnicode, as it needs punnycode support. However, it's not really possible to do this inside of AK as it can't depend on any external library. This change brings us a little closer to being able to do that, but unfortunately we aren't there quite yet, as the code generators depend on LibCore.
102 lines
2.5 KiB
C++
102 lines
2.5 KiB
C++
/*
|
|
* Copyright (c) 2018-2020, Andreas Kling <kling@serenityos.org>
|
|
* Copyright (c) 2022, the SerenityOS developers.
|
|
*
|
|
* SPDX-License-Identifier: BSD-2-Clause
|
|
*/
|
|
|
|
#pragma once
|
|
|
|
#include <AK/ByteBuffer.h>
|
|
#include <AK/ByteString.h>
|
|
#include <AK/Optional.h>
|
|
#include <AK/Vector.h>
|
|
#include <LibCore/Forward.h>
|
|
#include <LibURL/URL.h>
|
|
|
|
namespace HTTP {
|
|
|
|
class HttpRequest {
|
|
public:
|
|
enum class ParseError {
|
|
RequestTooLarge,
|
|
RequestIncomplete,
|
|
OutOfMemory,
|
|
UnsupportedMethod,
|
|
InvalidURL
|
|
};
|
|
|
|
static StringView parse_error_to_string(ParseError error)
|
|
{
|
|
switch (error) {
|
|
case ParseError::RequestTooLarge:
|
|
return "Request too large"sv;
|
|
case ParseError::RequestIncomplete:
|
|
return "Request is incomplete"sv;
|
|
case ParseError::OutOfMemory:
|
|
return "Out of memory"sv;
|
|
case ParseError::UnsupportedMethod:
|
|
return "Unsupported method"sv;
|
|
default:
|
|
VERIFY_NOT_REACHED();
|
|
}
|
|
}
|
|
|
|
enum Method {
|
|
Invalid,
|
|
HEAD,
|
|
GET,
|
|
POST,
|
|
DELETE,
|
|
PATCH,
|
|
OPTIONS,
|
|
TRACE,
|
|
CONNECT,
|
|
PUT,
|
|
};
|
|
|
|
struct Header {
|
|
ByteString name;
|
|
ByteString value;
|
|
};
|
|
|
|
struct BasicAuthenticationCredentials {
|
|
ByteString username;
|
|
ByteString password;
|
|
};
|
|
|
|
HttpRequest() = default;
|
|
~HttpRequest() = default;
|
|
|
|
ByteString const& resource() const { return m_resource; }
|
|
Vector<Header> const& headers() const { return m_headers; }
|
|
|
|
URL::URL const& url() const { return m_url; }
|
|
void set_url(URL::URL const& url) { m_url = url; }
|
|
|
|
Method method() const { return m_method; }
|
|
void set_method(Method method) { m_method = method; }
|
|
|
|
ByteBuffer const& body() const { return m_body; }
|
|
void set_body(ByteBuffer&& body) { m_body = move(body); }
|
|
|
|
StringView method_name() const;
|
|
ErrorOr<ByteBuffer> to_raw_request() const;
|
|
|
|
void set_headers(HashMap<ByteString, ByteString> const&);
|
|
|
|
static ErrorOr<HttpRequest, HttpRequest::ParseError> from_raw_request(ReadonlyBytes);
|
|
static Optional<Header> get_http_basic_authentication_header(URL::URL const&);
|
|
static Optional<BasicAuthenticationCredentials> parse_http_basic_authentication_header(ByteString const&);
|
|
|
|
private:
|
|
URL::URL m_url;
|
|
ByteString m_resource;
|
|
Method m_method { GET };
|
|
Vector<Header> m_headers;
|
|
ByteBuffer m_body;
|
|
};
|
|
|
|
StringView to_string_view(HttpRequest::Method);
|
|
|
|
}
|