docs: Extending documentation and manpages
Refs: #1462
Change-Id: If33a0f3c623daf3502ed301bcdc63892779463e3
diff --git a/examples/producer.cpp b/examples/producer.cpp
index 1327e94..4defc29 100644
--- a/examples/producer.cpp
+++ b/examples/producer.cpp
@@ -1,8 +1,8 @@
/* -*- Mode:C++; c-file-style:"gnu"; indent-tabs-mode:nil -*- */
/**
- * Copyright (C) 2013 Regents of the University of California.
+ * Copyright (c) 2013-2014 Regents of the University of California.
* @author: Alexander Afanasyev <alexander.afanasyev@ucla.edu>
- * See COPYING for copyright and distribution information.
+ * BSD License, see COPYING for copyright and distribution information.
*/
// correct way to include NDN-CPP headers
@@ -12,61 +12,76 @@
#include "face.hpp"
#include "security/key-chain.hpp"
-using namespace ndn;
+// Enclosing code in ndn simplifies coding (can also use `using namespace ndn`)
+namespace ndn {
+// Additional nested namespace could be used to prevent/limit name contentions
+namespace examples {
class Producer
{
public:
- Producer()
- {}
-
void
onInterest(const Name& name, const Interest& interest)
{
std::cout << "<< I: " << interest << std::endl;
- ndn::Data data(ndn::Name(interest.getName()).append("testApp").appendVersion());
- data.setFreshnessPeriod(ndn::time::seconds(10));
+ // Create new name, based on Interest's name
+ Name dataName(interest.getName());
+ dataName
+ .append("testApp") // add "testApp" component to Interest name
+ .appendVersion(); // add "version" component (current UNIX timestamp in milliseconds)
- data.setContent((const uint8_t*)"HELLO KITTY", sizeof("HELLO KITTY"));
+ static const std::string content = "HELLO KITTY";
- keyChain_.sign(data);
+ // Create Data packet
+ Data data;
+ data.setName(dataName);
+ data.setFreshnessPeriod(time::seconds(10));
+ data.setContent(Block(content.c_str(), content.size()));
+ // Sign Data packet with default identity
+ m_keyChain.sign(data);
+ // m_keyChain.sign(data, <identityName>);
+ // m_keyChain.sign(data, <certificate>);
+
+ // Return Data packet to the requester
std::cout << ">> D: " << data << std::endl;
- face_.put(data);
+ m_face.put(data);
}
void
- onRegisterFailed (const ndn::Name& prefix, const std::string& reason)
+ onRegisterFailed(const Name& prefix, const std::string& reason)
{
std::cerr << "ERROR: Failed to register prefix in local hub's daemon (" << reason << ")" << std::endl;
- face_.shutdown ();
+ m_face.shutdown();
}
void
- listen()
+ run()
{
- face_.setInterestFilter("/localhost/testApp",
- func_lib::bind(&Producer::onInterest, this, _1, _2),
- func_lib::bind(&Producer::onRegisterFailed, this, _1, _2));
- face_.processEvents();
+ m_face.setInterestFilter("/localhost/testApp",
+ bind(&Producer::onInterest, this, _1, _2),
+ bind(&Producer::onRegisterFailed, this, _1, _2));
+ m_face.processEvents();
}
private:
- ndn::Face face_;
- KeyChain keyChain_;
-
- Buffer ndndId_;
+ Face m_face;
+ KeyChain m_keyChain;
};
-int main()
+} // namespace examples
+} // namespace ndn
+
+int
+main(int argc, char** argv)
{
try {
- Producer producer;
- producer.listen();
+ ndn::examples::Producer producer;
+ producer.run();
}
- catch(std::exception &e) {
+ catch (std::exception& e) {
std::cerr << "ERROR: " << e.what() << std::endl;
}
return 0;