blob: 149c60669b0012159a60c5aac8b43f1b5204cfb1 [file] [log] [blame]
Jeff Thompson47eecfc2013-07-07 22:56:46 -07001/**
2 * @author: Jeff Thompson
3 * See COPYING for copyright and distribution information.
Jeff Thompsonb7f95562013-07-03 18:36:42 -07004 */
5
6#ifndef NDN_INTEREST_HPP
Jeff Thompson2d27e2f2013-08-09 12:55:00 -07007#define NDN_INTEREST_HPP
Jeff Thompsonb7f95562013-07-03 18:36:42 -07008
Jeff Thompson53412192013-08-06 13:35:50 -07009#include "name.hpp"
10#include "publisher-public-key-digest.hpp"
11#include "c/interest.h"
Jeff Thompsonb7f95562013-07-03 18:36:42 -070012
13namespace ndn {
Jeff Thompsonfe556862013-07-09 13:52:55 -070014
Jeff Thompson8238d002013-07-10 11:56:49 -070015/**
16 * An ExcludeEntry holds an ndn_ExcludeType, and if it is a COMPONENT, it holds the component value.
17 */
Jeff Thompsonfe556862013-07-09 13:52:55 -070018class ExcludeEntry {
19public:
20 /**
21 * Create an ExcludeEntry of type ndn_Exclude_ANY
22 */
23 ExcludeEntry()
24 : type_(ndn_Exclude_ANY)
25 {
26 }
27
28 /**
29 * Create an ExcludeEntry of type ndn_Exclude_COMPONENT
30 */
31 ExcludeEntry(unsigned char *component, unsigned int componentLen)
Jeff Thompson38d0e082013-08-12 18:07:44 -070032 : type_(ndn_Exclude_COMPONENT), component_(component, componentLen)
Jeff Thompsonfe556862013-07-09 13:52:55 -070033 {
34 }
35
36 /**
37 * Set the type in the excludeEntryStruct and to point to this component, without copying any memory.
38 * WARNING: The resulting pointer in excludeEntryStruct is invalid after a further use of this object which could reallocate memory.
Jeff Thompson8238d002013-07-10 11:56:49 -070039 * @param excludeEntryStruct the C ndn_NameComponent struct to receive the pointer
Jeff Thompsonfe556862013-07-09 13:52:55 -070040 */
41 void get(struct ndn_ExcludeEntry &excludeEntryStruct) const
42 {
43 excludeEntryStruct.type = type_;
Jeff Thompson38d0e082013-08-12 18:07:44 -070044 if (type_ == ndn_Exclude_COMPONENT)
45 component_.get(excludeEntryStruct.component);
Jeff Thompsonfe556862013-07-09 13:52:55 -070046 }
47
48 ndn_ExcludeType getType() const { return type_; }
49
Jeff Thompson38d0e082013-08-12 18:07:44 -070050 const Name::Component &getComponent() const { return component_; }
Jeff Thompsonfe556862013-07-09 13:52:55 -070051
52private:
53 ndn_ExcludeType type_;
Jeff Thompson38d0e082013-08-12 18:07:44 -070054 Name::Component component_; /**< only used if type_ is ndn_Exclude_COMPONENT */
Jeff Thompsonfe556862013-07-09 13:52:55 -070055};
56
Jeff Thompson8238d002013-07-10 11:56:49 -070057/**
58 * An Exclude holds a vector of ExcludeEntry.
59 */
Jeff Thompsonfe556862013-07-09 13:52:55 -070060class Exclude {
61public:
62 /**
63 * Create a new Exclude with no entries.
64 */
65 Exclude() {
66 }
67
68 unsigned int getEntryCount() const {
69 return entries_.size();
70 }
71
72 const ExcludeEntry &getEntry(unsigned int i) const { return entries_[i]; }
73
74 /**
Jeff Thompson8238d002013-07-10 11:56:49 -070075 * Set the excludeStruct to point to the entries in this Exclude, without copying any memory.
Jeff Thompsonfe556862013-07-09 13:52:55 -070076 * WARNING: The resulting pointers in excludeStruct are invalid after a further use of this object which could reallocate memory.
Jeff Thompson8238d002013-07-10 11:56:49 -070077 * @param excludeStruct a C ndn_Exclude struct where the entries array is already allocated
Jeff Thompsonfe556862013-07-09 13:52:55 -070078 */
79 void get(struct ndn_Exclude &excludeStruct) const;
80
81 /**
Jeff Thompson8238d002013-07-10 11:56:49 -070082 * Clear this Exclude, and set the entries by copying from the ndn_Exclude struct.
Jeff Thompsonfe556862013-07-09 13:52:55 -070083 * @param excludeStruct a C ndn_Exclude struct
84 */
Jeff Thompsondd3d2292013-07-10 11:59:44 -070085 void set(const struct ndn_Exclude &excludeStruct);
Jeff Thompsonfe556862013-07-09 13:52:55 -070086
87 /**
88 * Add a new entry of type ndn_Exclude_ANY
89 */
90 void addAny()
91 {
92 entries_.push_back(ExcludeEntry());
93 }
94
95 /**
96 * Add a new entry of type ndn_Exclude_COMPONENT, copying from component of length compnentLength
97 */
98 void addComponent(unsigned char *component, unsigned int componentLen)
99 {
100 entries_.push_back(ExcludeEntry(component, componentLen));
101 }
102
103 /**
104 * Clear all the entries.
105 */
106 void clear() {
107 entries_.clear();
108 }
109
110private:
Jeff Thompson2d27e2f2013-08-09 12:55:00 -0700111 std::vector<ExcludeEntry> entries_;
Jeff Thompsonfe556862013-07-09 13:52:55 -0700112};
Jeff Thompsonb7f95562013-07-03 18:36:42 -0700113
Jeff Thompson8238d002013-07-10 11:56:49 -0700114/**
115 * An Interest holds a Name and other fields for an interest.
116 */
Jeff Thompsonb7f95562013-07-03 18:36:42 -0700117class Interest {
118public:
Jeff Thompson34238652013-07-10 18:25:00 -0700119 Interest()
120 {
Jeff Thompson2d27e2f2013-08-09 12:55:00 -0700121 construct();
Jeff Thompsonc0486c12013-07-16 14:36:16 -0700122 }
123
124 Interest(const Name &name)
Jeff Thompsonf59a87a2013-07-31 16:55:41 -0700125 : name_(name)
Jeff Thompsonc0486c12013-07-16 14:36:16 -0700126 {
127 name_ = name;
Jeff Thompson2d27e2f2013-08-09 12:55:00 -0700128 construct();
Jeff Thompson34238652013-07-10 18:25:00 -0700129 }
130
Jeff Thompsonf59a87a2013-07-31 16:55:41 -0700131 Interest(const Name &name, int minSuffixComponents, int maxSuffixComponents,
132 const PublisherPublicKeyDigest &publisherPublicKeyDigest, const Exclude &exclude, int childSelector, int answerOriginKind,
133 int scope, double interestLifetimeMilliseconds, const std::vector<unsigned char> &nonce)
134 : name_(name), minSuffixComponents_(minSuffixComponents), maxSuffixComponents_(maxSuffixComponents),
135 publisherPublicKeyDigest_(publisherPublicKeyDigest), exclude_(exclude), childSelector_(childSelector),
136 answerOriginKind_(answerOriginKind), scope_(scope), interestLifetimeMilliseconds_(interestLifetimeMilliseconds),
137 nonce_(nonce)
138 {
139 }
140
Jeff Thompson67e9e0a2013-08-02 19:16:19 -0700141 ptr_lib::shared_ptr<std::vector<unsigned char> > wireEncode(WireFormat &wireFormat) const
Jeff Thompsonb7f95562013-07-03 18:36:42 -0700142 {
Jeff Thompsonb0979fd2013-07-30 15:48:21 -0700143 return wireFormat.encodeInterest(*this);
Jeff Thompsonb7f95562013-07-03 18:36:42 -0700144 }
Jeff Thompson67e9e0a2013-08-02 19:16:19 -0700145 ptr_lib::shared_ptr<std::vector<unsigned char> > wireEncode() const
Jeff Thompsonb7f95562013-07-03 18:36:42 -0700146 {
Jeff Thompson67e9e0a2013-08-02 19:16:19 -0700147 return wireEncode(*WireFormat::getDefaultWireFormat());
Jeff Thompsonb7f95562013-07-03 18:36:42 -0700148 }
Jeff Thompson67e9e0a2013-08-02 19:16:19 -0700149 void wireDecode(const unsigned char *input, unsigned int inputLength, WireFormat &wireFormat)
Jeff Thompsonb7f95562013-07-03 18:36:42 -0700150 {
151 wireFormat.decodeInterest(*this, input, inputLength);
152 }
Jeff Thompson67e9e0a2013-08-02 19:16:19 -0700153 void wireDecode(const unsigned char *input, unsigned int inputLength)
Jeff Thompsonb7f95562013-07-03 18:36:42 -0700154 {
Jeff Thompson67e9e0a2013-08-02 19:16:19 -0700155 wireDecode(input, inputLength, *WireFormat::getDefaultWireFormat());
Jeff Thompsonb7f95562013-07-03 18:36:42 -0700156 }
Jeff Thompson67e9e0a2013-08-02 19:16:19 -0700157 void wireDecode(const std::vector<unsigned char> &input, WireFormat &wireFormat)
Jeff Thompsonb7f95562013-07-03 18:36:42 -0700158 {
Jeff Thompson67e9e0a2013-08-02 19:16:19 -0700159 wireDecode(&input[0], input.size(), wireFormat);
Jeff Thompsonb7f95562013-07-03 18:36:42 -0700160 }
Jeff Thompson67e9e0a2013-08-02 19:16:19 -0700161 void wireDecode(const std::vector<unsigned char> &input)
Jeff Thompsonb7f95562013-07-03 18:36:42 -0700162 {
Jeff Thompson67e9e0a2013-08-02 19:16:19 -0700163 wireDecode(&input[0], input.size());
Jeff Thompsonb7f95562013-07-03 18:36:42 -0700164 }
Jeff Thompsond9e278c2013-07-08 15:20:13 -0700165
166 /**
167 * Set the interestStruct to point to the components in this interest, without copying any memory.
168 * WARNING: The resulting pointers in interestStruct are invalid after a further use of this object which could reallocate memory.
169 * @param interestStruct a C ndn_Interest struct where the name components array is already allocated.
170 */
Jeff Thompsond345a5b2013-07-08 16:18:23 -0700171 void get(struct ndn_Interest &interestStruct) const;
Jeff Thompsonb7f95562013-07-03 18:36:42 -0700172
Jeff Thompson12c27762013-07-09 15:05:11 -0700173 Name &getName() { return name_; }
Jeff Thompsond345a5b2013-07-08 16:18:23 -0700174 const Name &getName() const { return name_; }
Jeff Thompsonb7f95562013-07-03 18:36:42 -0700175
Jeff Thompsond345a5b2013-07-08 16:18:23 -0700176 int getMinSuffixComponents() const { return minSuffixComponents_; }
177
178 int getMaxSuffixComponents() const { return maxSuffixComponents_; }
Jeff Thompson0a681722013-07-08 16:21:54 -0700179
Jeff Thompson8238d002013-07-10 11:56:49 -0700180 PublisherPublicKeyDigest &getPublisherPublicKeyDigest() { return publisherPublicKeyDigest_; }
181 const PublisherPublicKeyDigest &getPublisherPublicKeyDigest() const { return publisherPublicKeyDigest_; }
Jeff Thompson0a681722013-07-08 16:21:54 -0700182
Jeff Thompson12c27762013-07-09 15:05:11 -0700183 Exclude &getExclude() { return exclude_; }
Jeff Thompsonfe556862013-07-09 13:52:55 -0700184 const Exclude &getExclude() const { return exclude_; }
Jeff Thompson0a681722013-07-08 16:21:54 -0700185
186 int getChildSelector() const { return childSelector_; }
187
188 int getAnswerOriginKind() const { return answerOriginKind_; }
189
190 int getScope() const { return scope_; }
Jeff Thompsond345a5b2013-07-08 16:18:23 -0700191
Jeff Thompson5a5e8b72013-07-11 14:28:03 -0700192 double getInterestLifetimeMilliseconds() const { return interestLifetimeMilliseconds_; }
Jeff Thompson0a681722013-07-08 16:21:54 -0700193
Jeff Thompson4962c622013-08-13 13:47:21 -0700194 const std::vector<unsigned char> &getNonce() const { return nonce_; }
Jeff Thompson22552902013-07-07 21:26:20 -0700195
Jeff Thompsonb7f95562013-07-03 18:36:42 -0700196 /**
197 * Clear this interest, and set the values by copying from the interest struct.
198 * @param interestStruct a C ndn_Interest struct
199 */
Jeff Thompsondd3d2292013-07-10 11:59:44 -0700200 void set(const struct ndn_Interest &interestStruct);
Jeff Thompsoneb316a82013-07-09 15:11:17 -0700201
202 void setMinSuffixComponents(int value) { minSuffixComponents_ = value; }
203
204 void setMaxSuffixComponents(int value) { maxSuffixComponents_ = value; }
205
Jeff Thompsoneb316a82013-07-09 15:11:17 -0700206 void setChildSelector(int value) { childSelector_ = value; }
207
208 void setAnswerOriginKind(int value) { answerOriginKind_ = value; }
209
210 void setScope(int value) { scope_ = value; }
211
Jeff Thompson5a5e8b72013-07-11 14:28:03 -0700212 void setInterestLifetimeMilliseconds(double value) { interestLifetimeMilliseconds_ = value; }
Jeff Thompsoneb316a82013-07-09 15:11:17 -0700213
214 void setNonce(const std::vector<unsigned char> &value) { nonce_ = value; }
215
Jeff Thompsonb7f95562013-07-03 18:36:42 -0700216private:
Jeff Thompsonc0486c12013-07-16 14:36:16 -0700217 void construct()
218 {
Jeff Thompson2d27e2f2013-08-09 12:55:00 -0700219 minSuffixComponents_ = -1;
220 maxSuffixComponents_ = -1;
221 childSelector_ = -1;
222 answerOriginKind_ = -1;
223 scope_ = -1;
224 interestLifetimeMilliseconds_ = -1.0;
Jeff Thompsonc0486c12013-07-16 14:36:16 -0700225 }
Jeff Thompsonb7f95562013-07-03 18:36:42 -0700226
227 Name name_;
Jeff Thompson2d27e2f2013-08-09 12:55:00 -0700228 int minSuffixComponents_;
229 int maxSuffixComponents_;
230 PublisherPublicKeyDigest publisherPublicKeyDigest_;
Jeff Thompsonfe556862013-07-09 13:52:55 -0700231 Exclude exclude_;
Jeff Thompson2d27e2f2013-08-09 12:55:00 -0700232 int childSelector_;
233 int answerOriginKind_;
234 int scope_;
235 double interestLifetimeMilliseconds_;
236 std::vector<unsigned char> nonce_;
Jeff Thompsonb7f95562013-07-03 18:36:42 -0700237};
238
239}
240
241#endif