mirror of
https://github.com/SerenityOS/serenity
synced 2024-10-06 16:09:30 +00:00
8464da1439
`Stream` will be qualified as `AK::Stream` until we remove the `Core::Stream` namespace. `IODevice` now reuses the `SeekMode` that is defined by `SeekableStream`, since defining its own would require us to qualify it with `AK::SeekMode` everywhere.
75 lines
2 KiB
C++
75 lines
2 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/Function.h>
|
|
#include <LibCore/Forward.h>
|
|
#include <LibCore/Object.h>
|
|
#include <LibCore/Stream.h>
|
|
|
|
namespace Core {
|
|
|
|
class NetworkJob : public Object {
|
|
C_OBJECT_ABSTRACT(NetworkJob)
|
|
public:
|
|
enum class Error {
|
|
None,
|
|
ConnectionFailed,
|
|
TransmissionFailed,
|
|
ProtocolFailed,
|
|
Cancelled,
|
|
};
|
|
virtual ~NetworkJob() override = default;
|
|
|
|
// Could fire twice, after Headers and after Trailers!
|
|
Function<void(HashMap<DeprecatedString, DeprecatedString, CaseInsensitiveStringTraits> const& response_headers, Optional<u32> response_code)> on_headers_received;
|
|
Function<void(bool success)> on_finish;
|
|
Function<void(Optional<u32>, u32)> on_progress;
|
|
|
|
bool is_cancelled() const { return m_error == Error::Cancelled; }
|
|
bool has_error() const { return m_error != Error::None; }
|
|
Error error() const { return m_error; }
|
|
NetworkResponse* response() { return m_response.ptr(); }
|
|
NetworkResponse const* response() const { return m_response.ptr(); }
|
|
|
|
enum class ShutdownMode {
|
|
DetachFromSocket,
|
|
CloseSocket,
|
|
};
|
|
virtual void start(Core::Stream::Socket&) = 0;
|
|
virtual void shutdown(ShutdownMode) = 0;
|
|
virtual void fail(Error error) { did_fail(error); }
|
|
|
|
void cancel()
|
|
{
|
|
shutdown(ShutdownMode::DetachFromSocket);
|
|
m_error = Error::Cancelled;
|
|
}
|
|
|
|
protected:
|
|
NetworkJob(AK::Stream&);
|
|
void did_finish(NonnullRefPtr<NetworkResponse>&&);
|
|
void did_fail(Error);
|
|
void did_progress(Optional<u32> total_size, u32 downloaded);
|
|
|
|
ErrorOr<size_t> do_write(ReadonlyBytes bytes) { return m_output_stream.write(bytes); }
|
|
|
|
private:
|
|
RefPtr<NetworkResponse> m_response;
|
|
AK::Stream& m_output_stream;
|
|
Error m_error { Error::None };
|
|
};
|
|
|
|
char const* to_string(NetworkJob::Error);
|
|
|
|
}
|
|
|
|
template<>
|
|
struct AK::Formatter<Core::NetworkJob> : Formatter<Core::Object> {
|
|
};
|