face: Extending Face interface to support ``put`` call
Also, this commit includes Face/Node/Transport enhancement in regard to
the error processing: io_service thread will be stopped and Node::Error
exception will be thrown)
Change-Id: Ibec2f75e7b7d2e9a221a857fdc63295dd7da16e0
diff --git a/include/ndn-cpp/face.hpp b/include/ndn-cpp/face.hpp
index c7e0826..4071501 100644
--- a/include/ndn-cpp/face.hpp
+++ b/include/ndn-cpp/face.hpp
@@ -142,19 +142,36 @@
{
node_.removeRegisteredPrefix(registeredPrefixId);
}
+
+ /**
+ * @brief Publish data packet
+ *
+ * This method can be called to satisfy the incoming Interest or to put Data packet into the cache
+ * of the local NDN forwarder
+ */
+ void
+ put(const Data &data)
+ {
+ node_.put(data);
+ }
/**
* Process any data to receive or call timeout callbacks.
- * This is non-blocking and will return immediately if there is no data to receive.
- * You should repeatedly call this from an event loop, with calls to sleep as needed so that the loop doesn't use 100% of the CPU.
+ *
+ * This call will block forever (default timeout == 0) to process IO on the face.
+ * To exit, one expected to call face.shutdown() from one of the callback methods.
+ *
+ * If timeout is specified, then processEvents will exit after this timeout, if not stopped earlier with face.shutdown().
+ * The call can be called repeatedly, if desired.
+ *
* @throw This may throw an exception for reading data or in the callback for processing the data. If you
* call this from an main event loop, you may want to catch and log/disregard all exceptions.
*/
void
- processEvents()
+ processEvents(Milliseconds timeout = 0)
{
// Just call Node's processEvents.
- node_.processEvents();
+ node_.processEvents(timeout);
}
/**