1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
|
#pragma once
#include <mbgl/util/chrono.hpp>
#include <mbgl/util/optional.hpp>
#include <string>
#include <memory>
namespace mbgl {
class Response {
public:
Response() = default;
Response(const Response&);
Response& operator=(const Response&);
public:
class Error;
// When this object is empty, the response was successful.
std::unique_ptr<const Error> error;
// This is set to true for 204 Not Modified responses, and, for backward compatibility,
// for 404 Not Found responses for tiles.
bool noContent = false;
// This is set to true for 304 Not Modified responses.
bool notModified = false;
// This is set to true when the server requested that no expired resources be used by
// specifying "Cache-Control: must-revalidate".
bool mustRevalidate = false;
// The actual data of the response. Present only for non-error, non-notModified responses.
std::shared_ptr<const std::string> data;
optional<Timestamp> modified;
optional<Timestamp> expires;
optional<std::string> etag;
bool isFresh() const {
return expires ? *expires > util::now() : !error;
}
// Indicates whether we are allowed to use this response according to HTTP caching rules.
// It may or may not be stale.
bool isUsable() const {
return !mustRevalidate || (expires && *expires > util::now());
}
};
class Response::Error {
public:
enum class Reason : uint8_t {
Success = 1,
NotFound = 2,
Server = 3,
Connection = 4,
RateLimit = 5,
Other = 6,
} reason = Reason::Other;
// An error message from the request handler, e.g. a server message or a system message
// informing the user about the reason for the failure.
std::string message;
optional<Timestamp> retryAfter;
public:
Error(Reason, std::string = "", optional<Timestamp> = {});
};
} // namespace mbgl
|