]>
Commit | Line | Data |
---|---|---|
1 | // -*- mode: cpp; mode: fold -*- | |
2 | // Description /*{{{*/ | |
3 | /* ###################################################################### | |
4 | ||
5 | Classes dealing with the abstraction of talking to a end via a text | |
6 | protocol like HTTP (which is used by the http and https methods) | |
7 | ||
8 | ##################################################################### */ | |
9 | /*}}}*/ | |
10 | ||
11 | #ifndef APT_SERVER_H | |
12 | #define APT_SERVER_H | |
13 | ||
14 | #include <apt-pkg/strutl.h> | |
15 | #include <apt-pkg/acquire-method.h> | |
16 | #include "aptmethod.h" | |
17 | ||
18 | #include <time.h> | |
19 | #include <iostream> | |
20 | #include <string> | |
21 | #include <memory> | |
22 | ||
23 | using std::cout; | |
24 | using std::endl; | |
25 | ||
26 | class Hashes; | |
27 | class ServerMethod; | |
28 | class FileFd; | |
29 | ||
30 | struct ServerState | |
31 | { | |
32 | // This is the last parsed Header Line | |
33 | unsigned int Major; | |
34 | unsigned int Minor; | |
35 | unsigned int Result; | |
36 | char Code[360]; | |
37 | ||
38 | // These are some statistics from the last parsed header lines | |
39 | ||
40 | // total size of the usable content (aka: the file) | |
41 | unsigned long long TotalFileSize; | |
42 | // size we actually download (can be smaller than Size if we have partial content) | |
43 | unsigned long long DownloadSize; | |
44 | // size of junk content (aka: server error pages) | |
45 | unsigned long long JunkSize; | |
46 | // The start of the data (for partial content) | |
47 | unsigned long long StartPos; | |
48 | ||
49 | time_t Date; | |
50 | bool HaveContent; | |
51 | enum {Chunked,Stream,Closes} Encoding; | |
52 | enum {Header, Data} State; | |
53 | bool Persistent; | |
54 | bool PipelineAllowed; | |
55 | std::string Location; | |
56 | ||
57 | // This is a Persistent attribute of the server itself. | |
58 | bool Pipeline; | |
59 | URI ServerName; | |
60 | URI Proxy; | |
61 | unsigned long TimeOut; | |
62 | ||
63 | unsigned long long MaximumSize; | |
64 | ||
65 | protected: | |
66 | ServerMethod *Owner; | |
67 | ||
68 | virtual bool ReadHeaderLines(std::string &Data) = 0; | |
69 | virtual bool LoadNextResponse(bool const ToFile, FileFd * const File) = 0; | |
70 | ||
71 | public: | |
72 | bool HeaderLine(std::string Line); | |
73 | ||
74 | /** \brief Result of the header acquire */ | |
75 | enum RunHeadersResult { | |
76 | /** \brief Header ok */ | |
77 | RUN_HEADERS_OK, | |
78 | /** \brief IO error while retrieving */ | |
79 | RUN_HEADERS_IO_ERROR, | |
80 | /** \brief Parse error after retrieving */ | |
81 | RUN_HEADERS_PARSE_ERROR | |
82 | }; | |
83 | /** \brief Get the headers before the data */ | |
84 | RunHeadersResult RunHeaders(FileFd * const File, const std::string &Uri); | |
85 | bool AddPartialFileToHashes(FileFd &File); | |
86 | ||
87 | bool Comp(URI Other) const {return Other.Host == ServerName.Host && Other.Port == ServerName.Port;}; | |
88 | virtual void Reset() {Major = 0; Minor = 0; Result = 0; Code[0] = '\0'; TotalFileSize = 0; JunkSize = 0; | |
89 | StartPos = 0; Encoding = Closes; time(&Date); HaveContent = false; | |
90 | State = Header; Persistent = false; Pipeline = false; MaximumSize = 0; PipelineAllowed = true;}; | |
91 | virtual bool WriteResponse(std::string const &Data) = 0; | |
92 | ||
93 | /** \brief Transfer the data from the socket */ | |
94 | virtual bool RunData(FileFd * const File) = 0; | |
95 | ||
96 | virtual bool Open() = 0; | |
97 | virtual bool IsOpen() = 0; | |
98 | virtual bool Close() = 0; | |
99 | virtual bool InitHashes(HashStringList const &ExpectedHashes) = 0; | |
100 | virtual Hashes * GetHashes() = 0; | |
101 | virtual bool Die(FileFd &File) = 0; | |
102 | virtual bool Flush(FileFd * const File) = 0; | |
103 | virtual bool Go(bool ToFile, FileFd * const File) = 0; | |
104 | ||
105 | ServerState(URI Srv, ServerMethod *Owner); | |
106 | virtual ~ServerState() {}; | |
107 | }; | |
108 | ||
109 | class ServerMethod : public aptMethod | |
110 | { | |
111 | protected: | |
112 | virtual bool Fetch(FetchItem *) APT_OVERRIDE; | |
113 | ||
114 | std::unique_ptr<ServerState> Server; | |
115 | std::string NextURI; | |
116 | FileFd *File; | |
117 | ||
118 | unsigned long PipelineDepth; | |
119 | bool AllowRedirect; | |
120 | ||
121 | // Find the biggest item in the fetch queue for the checking of the maximum | |
122 | // size | |
123 | unsigned long long FindMaximumObjectSizeInQueue() const APT_PURE; | |
124 | ||
125 | public: | |
126 | bool Debug; | |
127 | ||
128 | /** \brief Result of the header parsing */ | |
129 | enum DealWithHeadersResult { | |
130 | /** \brief The file is open and ready */ | |
131 | FILE_IS_OPEN, | |
132 | /** \brief We got a IMS hit, the file has not changed */ | |
133 | IMS_HIT, | |
134 | /** \brief The server reported a unrecoverable error */ | |
135 | ERROR_UNRECOVERABLE, | |
136 | /** \brief The server reported a error with a error content page */ | |
137 | ERROR_WITH_CONTENT_PAGE, | |
138 | /** \brief An error on the client side */ | |
139 | ERROR_NOT_FROM_SERVER, | |
140 | /** \brief A redirect or retry request */ | |
141 | TRY_AGAIN_OR_REDIRECT | |
142 | }; | |
143 | /** \brief Handle the retrieved header data */ | |
144 | DealWithHeadersResult DealWithHeaders(FetchResult &Res); | |
145 | ||
146 | // In the event of a fatal signal this file will be closed and timestamped. | |
147 | static std::string FailFile; | |
148 | static int FailFd; | |
149 | static time_t FailTime; | |
150 | static APT_NORETURN void SigTerm(int); | |
151 | ||
152 | virtual bool Flush() { return Server->Flush(File); }; | |
153 | ||
154 | int Loop(); | |
155 | ||
156 | virtual void SendReq(FetchItem *Itm) = 0; | |
157 | virtual std::unique_ptr<ServerState> CreateServerState(URI const &uri) = 0; | |
158 | virtual void RotateDNS() = 0; | |
159 | ||
160 | ServerMethod(char const * const Binary, char const * const Ver,unsigned long const Flags); | |
161 | virtual ~ServerMethod() {}; | |
162 | }; | |
163 | ||
164 | #endif |