1 /* <!-- copyright */
2 /*
3  * aria2 - The high speed download utility
4  *
5  * Copyright (C) 2006 Tatsuhiro Tsujikawa
6  *
7  * This program is free software; you can redistribute it and/or modify
8  * it under the terms of the GNU General Public License as published by
9  * the Free Software Foundation; either version 2 of the License, or
10  * (at your option) any later version.
11  *
12  * This program is distributed in the hope that it will be useful,
13  * but WITHOUT ANY WARRANTY; without even the implied warranty of
14  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
15  * GNU General Public License for more details.
16  *
17  * You should have received a copy of the GNU General Public License
18  * along with this program; if not, write to the Free Software
19  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
20  *
21  * In addition, as a special exception, the copyright holders give
22  * permission to link the code of portions of this program with the
23  * OpenSSL library under certain conditions as described in each
24  * individual source file, and distribute linked combinations
25  * including the two.
26  * You must obey the GNU General Public License in all respects
27  * for all of the code used other than OpenSSL.  If you modify
28  * file(s) with this exception, you may extend this exception to your
29  * version of the file(s), but you are not obligated to do so.  If you
30  * do not wish to do so, delete this exception statement from your
31  * version.  If you delete this exception statement from all source
32  * files in the program, then also delete it here.
33  */
34 /* copyright --> */
35 #ifndef D_DHT_PEER_ANNOUNCE_ENTRY_H
36 #define D_DHT_PEER_ANNOUNCE_ENTRY_H
37 
38 #include "common.h"
39 
40 #include <vector>
41 #include <memory>
42 
43 #include "DHTConstants.h"
44 #include "PeerAddrEntry.h"
45 #include "TimerA2.h"
46 
47 namespace aria2 {
48 
49 class Peer;
50 
51 class DHTPeerAnnounceEntry {
52 private:
53   unsigned char infoHash_[DHT_ID_LENGTH];
54 
55   std::vector<PeerAddrEntry> peerAddrEntries_;
56 
57   Timer lastUpdated_;
58 
59 public:
60   DHTPeerAnnounceEntry(const unsigned char* infoHash);
61 
62   ~DHTPeerAnnounceEntry();
63 
64   // add peer addr entry.
65   // if it already exists, update "Last Updated" property.
66   void addPeerAddrEntry(const PeerAddrEntry& entry);
67 
68   size_t countPeerAddrEntry() const;
69 
getPeerAddrEntries()70   const std::vector<PeerAddrEntry>& getPeerAddrEntries() const
71   {
72     return peerAddrEntries_;
73   }
74 
75   void removeStalePeerAddrEntry(const std::chrono::seconds& timeout);
76 
77   bool empty() const;
78 
getLastUpdated()79   const Timer& getLastUpdated() const { return lastUpdated_; }
80 
81   void notifyUpdate();
82 
getInfoHash()83   const unsigned char* getInfoHash() const { return infoHash_; }
84 
85   void getPeers(std::vector<std::shared_ptr<Peer>>& peers) const;
86 };
87 
88 } // namespace aria2
89 
90 #endif // D_DHT_PEER_ANNOUNCE_ENTRY_H
91