ladybird/Libraries/LibHTTP/HttpRequest.h
Timothy Flynn 9375660b64 LibHTTP+LibWeb+RequestServer: Move Fetch's HTTP header infra to LibHTTP
The end goal here is for LibHTTP to be the home of our RFC 9111 (HTTP
caching) implementation. We currently have one implementation in LibWeb
for our in-memory cache and another in RequestServer for our disk cache.

The implementations both largely revolve around interacting with HTTP
headers. But in LibWeb, we are using Fetch's header infra, and in RS we
are using are home-grown header infra from LibHTTP.

So to give these a common denominator, this patch replaces the LibHTTP
implementation with Fetch's infra. Our existing LibHTTP implementation
was not particularly compliant with any spec, so this at least gives us
a standards-based common implementation.

This migration also required moving a handful of other Fetch AOs over
to LibHTTP. (It turns out these AOs were all from the Fetch/Infra/HTTP
folder, so perhaps it makes sense for LibHTTP to be the implementation
of that entire set of facilities.)
2025-11-27 14:57:29 +01:00

98 lines
2.5 KiB
C++

/*
* Copyright (c) 2018-2020, Andreas Kling <andreas@ladybird.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/Noncopyable.h>
#include <AK/Optional.h>
#include <LibCore/Forward.h>
#include <LibHTTP/HeaderList.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 BasicAuthenticationCredentials {
ByteString username;
ByteString password;
};
explicit HttpRequest(NonnullRefPtr<HeaderList>);
~HttpRequest() = default;
AK_MAKE_DEFAULT_MOVABLE(HttpRequest);
ByteString const& resource() const { return m_resource; }
HeaderList 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;
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 };
NonnullRefPtr<HeaderList> m_headers;
ByteBuffer m_body;
};
StringView to_string_view(HttpRequest::Method);
}