X-Git-Url: http://g0dil.de/git?a=blobdiff_plain;f=PPI%2FConnectors.hh;h=4f18a785d694f65acc6c2db482d956338f8e6dd4;hb=92f8630b75f3ef50e73c48cde58645dcd1534e27;hp=2750224e2e5d929ea8bf85505a8d633ed5ea2f7a;hpb=a4e14250b78fdbc289e29c5d25dd1444aae7dc3e;p=senf.git diff --git a/PPI/Connectors.hh b/PPI/Connectors.hh index 2750224..4f18a78 100644 --- a/PPI/Connectors.hh +++ b/PPI/Connectors.hh @@ -23,8 +23,8 @@ /** \file \brief Connectors public header */ -#ifndef HH_Connectors_ -#define HH_Connectors_ 1 +#ifndef HH_SENF_PPI_Connectors_ +#define HH_SENF_PPI_Connectors_ 1 // Custom includes #include @@ -36,6 +36,7 @@ #include "predecl.hh" #include "detail/Callback.hh" #include "Queueing.hh" +#include "ModuleManager.hh" //#include "Connectors.mpp" ///////////////////////////////hh.p//////////////////////////////////////// @@ -53,11 +54,11 @@ namespace connector { \li it has an (optional) packet type \e Active connectors are activated from within the module, \e passive connectors are - signaled by the external framework. \e Input modules receive packets, \e output modules send - packets. + signaled by the external framework. \e Input connectors receive packets, \e output + connectors send packets. All passive connectors call some onRequest callback whenever I/O needs to be performed. All - input modules possess a packet queue. + input connectors possess a packet queue. We therefore have 4 connector types each of which is parameterized by the type of packet traversing the connector: @@ -90,7 +91,7 @@ namespace connector { private: void onRequest() { // 'input()' will return a senf::EthernetPacket packet handle - try { output( input().find() ); } + try { output( input().find() ); } catch (senf::InvalidPacketChainException & ex) { ; } } }; @@ -122,18 +123,22 @@ namespace connector { to the containing module) */ class Connector - : boost::noncopyable + : ModuleManager::Initializable, boost::noncopyable { public: Connector & peer() const; ///< Get peer connected to this connector module::Module & module() const; ///< Get this connectors containing module + bool connected() const; ///< \c true, if connector connected, \c false otherwise + + void disconnect(); ///< Disconnect connector from peer + protected: Connector(); virtual ~Connector(); void connect(Connector & target); - + private: virtual std::type_info const & packetTypeID(); @@ -193,6 +198,8 @@ namespace connector { void emit(); private: + virtual void v_init(); + // Called by the routing to change the remote throttling state void notifyThrottle(); ///< Forward a throttle notification to this connector void notifyUnthrottle(); ///< Forward an unthrottle notification to this connector @@ -268,6 +275,8 @@ namespace connector { ActiveConnector(); private: + virtual void v_init(); + // called by the peer() to forward throttling notifications void notifyThrottle(); void notifyUnthrottle(); @@ -281,6 +290,8 @@ namespace connector { typedef std::vector NotifyRoutes; NotifyRoutes notifyRoutes_; + bool throttled_; + friend class senf::ppi::ForwardingRoute; friend class PassiveConnector; }; @@ -339,7 +350,7 @@ namespace connector { InputConnector(); private: - void enqueue(Packet p); + void enqueue(Packet const & p); virtual void v_requestEvent(); virtual void v_enqueueEvent(); @@ -360,9 +371,9 @@ namespace connector { : public virtual Connector { public: - void operator()(Packet p); ///< Send out a packet + void operator()(Packet const & p); ///< Send out a packet - void write(Packet p); ///< Alias for operator()(Packet p) + void write(Packet const & p); ///< Alias for operator()(Packet p) InputConnector & peer() const; @@ -515,7 +526,7 @@ namespace connector { { public: PacketType operator()(); ///< Read packet - /**< \throws std::bad_cast, if the %connector receives a + /**< \throws std::bad_cast if the %connector receives a Packet which is not of type \a PacketType. \returns newly read packet reference. */ PacketType read(); ///< Alias for operator() @@ -538,7 +549,7 @@ namespace connector { { public: PacketType operator()(); ///< Read packet - /**< \throws std::bad_cast, if the %connector receives a + /**< \throws std::bad_cast if the %connector receives a Packet which is not of type \a PacketType. \returns newly read packet reference. */ PacketType read(); ///< Alias for operator() @@ -560,7 +571,7 @@ namespace connector { { public: operator()(PacketType packet); ///< Send out a packet - write(PacketType packet); ///< Alias for operator() + void write(PacketType packet); ///< Alias for operator() }; /** \brief Connector passively providing packets @@ -580,7 +591,7 @@ namespace connector { { public: operator()(PacketType packet); ///< Send out a packet - write(PacketType packet); ///< Alias for operator() + void write(PacketType packet); ///< Alias for operator() }; #endif