#include <PreemptingServer.h>

Inheritance diagram for inet::queueing::PreemptingServer:

Public Member Functions
virtual	~PreemptingServer ()

virtual void	handleCanPushPacketChanged (cGate *gate) override
	Notifies about a change in the possibility of pushing some packet into the passive packet sink at the given gate. More...

virtual void	handleCanPullPacketChanged (cGate *gate) override
	Notifies about a change in the possibility of pulling some packet from the passive packet source at the given gate. More...

virtual void	handlePushPacketProcessed (Packet packet, cGate gate, bool successful) override
	Notifies about the completion of the packet processing for a packet that was pushed earlier independently whether the packet is passed or streamed. More...

Public Member Functions inherited from inet::ClockUserModuleMixin< PacketServerBase >
virtual void	scheduleClockEventAt (clocktime_t time, ClockEvent *msg)

virtual void	scheduleClockEventAfter (clocktime_t delay, ClockEvent *msg)

virtual cMessage *	cancelClockEvent (ClockEvent *msg)

virtual void	cancelAndDeleteClockEvent (ClockEvent *msg)

virtual void	rescheduleClockEventAt (clocktime_t time, ClockEvent *msg)

virtual void	rescheduleClockEventAfter (clocktime_t time, ClockEvent *msg)

virtual clocktime_t	computeClockTimeFromSimTime (simtime_t time) const

virtual simtime_t	computeSimTimeFromClockTime (clocktime_t time) const

virtual clocktime_t	getClockTime () const

virtual clocktime_t	getArrivalClockTime (ClockEvent *msg) const

Public Member Functions inherited from inet::queueing::PacketServerBase
virtual IPassivePacketSource *	getProvider (cGate *gate) override
	Returns the passive packet source from where packets are pulled or nullptr if the connected module doesn't implement the interface. More...

virtual IPassivePacketSink *	getConsumer (cGate *gate) override
	Returns the passive packet sink where packets are pushed or nullptr if the connected module doesn't implement the interface. More...

virtual bool	supportsPacketPushing (cGate *gate) const override
	Returns true if the processor supports pushing packets at the given gate. More...

virtual bool	supportsPacketPulling (cGate *gate) const override
	Returns true if the processor supports pulling packets at the given gate. More...

virtual void	handlePullPacketProcessed (Packet packet, cGate gate, bool successful) override
	Notifies about the completion of the packet processing for a packet that was pulled earlier independently whether the packet is passed or streamed. More...

Public Member Functions inherited from inet::queueing::PacketProcessorBase
virtual bool	supportsPacketSending (cGate *gate) const override
	Returns true if the processor supports sending packets at the given gate. More...

virtual bool	supportsPacketPassing (cGate *gate) const override
	Returns true if the processor supports passing packets as a whole at the given gate. More...

virtual bool	supportsPacketStreaming (cGate *gate) const override
	Returns true if the processor supports streaming packets at the given gate. More...

virtual const char *	resolveDirective (char directive) const override

Public Member Functions inherited from inet::queueing::IPacketProcessor
virtual	~IPacketProcessor ()

Public Member Functions inherited from inet::queueing::IActivePacketSink
virtual	~IActivePacketSink ()

Public Member Functions inherited from inet::queueing::IActivePacketSource
virtual	~IActivePacketSource ()

Protected Member Functions
virtual void	initialize (int stage) override

virtual void	handleMessage (cMessage *message) override

virtual bool	isStreaming () const

virtual bool	canStartStreaming () const

virtual void	startStreaming ()

virtual void	endStreaming ()

Protected Member Functions inherited from inet::queueing::PacketProcessorBase
virtual int	numInitStages () const override

virtual void	refreshDisplay () const override

virtual void	handlePacketProcessed (Packet *packet)

virtual void	checkPacketOperationSupport (cGate *gate) const

virtual void	checkPacketOperationSupport (cGate startGate, cGate endGate) const

virtual void	animate (Packet packet, cGate gate, const SendOptions &sendOptions, Action action) const

virtual void	animatePacket (Packet packet, cGate gate, Action action) const

virtual void	animatePacketStart (Packet packet, cGate gate, bps datarate, long transmissionId, Action action) const

virtual void	animatePacketStart (Packet packet, cGate gate, bps datarate, const SendOptions &sendOptions, Action action) const

virtual void	animatePacketEnd (Packet packet, cGate gate, long transmissionId, Action action) const

virtual void	animatePacketEnd (Packet packet, cGate gate, const SendOptions &sendOptions, Action action) const

virtual void	animatePacketProgress (Packet packet, cGate gate, bps datarate, b position, b extraProcessableLength, long transmissionId, Action action) const

virtual void	animatePacketProgress (Packet packet, cGate gate, bps datarate, b position, b extraProcessableLength, const SendOptions &sendOptions, Action action) const

virtual void	pushOrSendPacket (Packet packet, cGate gate, IPassivePacketSink *consumer)

virtual void	pushOrSendPacketStart (Packet packet, cGate gate, IPassivePacketSink *consumer, bps datarate, int transmissionId)

virtual void	pushOrSendPacketEnd (Packet packet, cGate gate, IPassivePacketSink *consumer, int transmissionId)

virtual void	pushOrSendPacketProgress (Packet packet, cGate gate, IPassivePacketSink *consumer, bps datarate, b position, b extraProcessableLength, int transmissionId)

virtual void	animatePush (Packet packet, cGate gate, const SendOptions &sendOptions) const

virtual void	animatePushPacket (Packet packet, cGate gate) const

virtual void	animatePushPacketStart (Packet packet, cGate gate, bps datarate, long transmissionId) const

virtual void	animatePushPacketStart (Packet packet, cGate gate, bps datarate, const SendOptions &sendOptions) const

virtual void	animatePushPacketEnd (Packet packet, cGate gate, long transmissionId) const

virtual void	animatePushPacketEnd (Packet packet, cGate gate, const SendOptions &sendOptions) const

virtual void	animatePushPacketProgress (Packet packet, cGate gate, bps datarate, b position, b extraProcessableLength, long transmissionId) const

virtual void	animatePushPacketProgress (Packet packet, cGate gate, bps datarate, b position, b extraProcessableLength, const SendOptions &sendOptions) const

virtual void	animatePull (Packet packet, cGate gate, const SendOptions &sendOptions) const

virtual void	animatePullPacket (Packet packet, cGate gate) const

virtual void	animatePullPacketStart (Packet packet, cGate gate, bps datarate, long transmissionId) const

virtual void	animatePullPacketStart (Packet packet, cGate gate, bps datarate, const SendOptions &sendOptions) const

virtual void	animatePullPacketEnd (Packet packet, cGate gate, long transmissionId) const

virtual void	animatePullPacketEnd (Packet packet, cGate gate, const SendOptions &sendOptions) const

virtual void	animatePullPacketProgress (Packet packet, cGate gate, bps datarate, b position, b extraProcessableLength, long transmissionId) const

virtual void	animatePullPacketProgress (Packet packet, cGate gate, bps datarate, b position, b extraProcessableLength, const SendOptions &sendOptions) const

virtual void	dropPacket (Packet *packet, PacketDropReason reason, int limit=-1)

virtual void	updateDisplayString () const

Protected Attributes
bps	datarate = bps(NaN)

Packet *	streamedPacket = nullptr

ClockEvent *	timer = nullptr

Protected Attributes inherited from inet::queueing::PacketServerBase
cGate *	inputGate = nullptr

IPassivePacketSource *	provider = nullptr

cGate *	outputGate = nullptr

IPassivePacketSink *	consumer = nullptr

Protected Attributes inherited from inet::queueing::PacketProcessorBase
const char *	displayStringTextFormat = nullptr

int	numProcessedPackets = -1

b	processedTotalLength = b(-1)

Additional Inherited Members
Protected Types inherited from inet::queueing::PacketProcessorBase
enum	Action { PUSH, PULL }

Constructor & Destructor Documentation

◆ ~PreemptingServer()

virtual inet::queueing::PreemptingServer::~PreemptingServer ( )

inlinevirtual

39 { delete streamedPacket; cancelAndDeleteClockEvent(timer); }

Member Function Documentation

◆ canStartStreaming()

bool inet::queueing::PreemptingServer::canStartStreaming ( ) const

protectedvirtual

 {
     return provider->canPullSomePacket(inputGate->getPathStartGate()) && consumer->canPushSomePacket(outputGate->getPathEndGate());
 }

Referenced by handleCanPullPacketChanged(), and handleCanPushPacketChanged().

◆ endStreaming()

void inet::queueing::PreemptingServer::endStreaming ( )

protectedvirtual

 {
     auto packet = provider->pullPacketEnd(inputGate->getPathStartGate());
     take(packet);
     delete streamedPacket;
     streamedPacket = packet;
     EV_INFO << "Ending streaming packet" << EV_FIELD(packet, *streamedPacket) << EV_ENDL;
     pushOrSendPacketEnd(streamedPacket, outputGate, consumer, packet->getTransmissionId());
     streamedPacket = nullptr;
     updateDisplayString();
 }

Referenced by handleCanPullPacketChanged(), and handleMessage().

◆ handleCanPullPacketChanged()

void inet::queueing::PreemptingServer::handleCanPullPacketChanged ( cGate * gate )

overridevirtual

Notifies about a change in the possibility of pulling some packet from the passive packet source at the given gate.

This method is called, for example, when a new packet is inserted into a queue. It allows the sink to pull a new packet from the queue.

The gate parameter must be a valid gate of this module.

Implements inet::queueing::IActivePacketSink.

 {
     Enter_Method("handleCanPullPacketChanged");
     if (isStreaming()) {
         endStreaming();
         cancelClockEvent(timer);
     }
     else if (canStartStreaming())
         startStreaming();
 }

◆ handleCanPushPacketChanged()

void inet::queueing::PreemptingServer::handleCanPushPacketChanged ( cGate * gate )

overridevirtual

Notifies about a change in the possibility of pushing some packet into the passive packet sink at the given gate.

This method is called, for example, when a new packet can be inserted into a queue. It allows the source to push a new packet into the queue.

The gate parameter must be a valid gate of this module.

Implements inet::queueing::IActivePacketSource.

 {
     Enter_Method("handleCanPushPacketChanged");
     if (!isStreaming() && canStartStreaming())
         startStreaming();
 }

◆ handleMessage()

void inet::queueing::PreemptingServer::handleMessage ( cMessage * message )

overrideprotectedvirtual

 {
     if (message == timer)
         endStreaming();
     else
         PacketServerBase::handleMessage(message);
 }

◆ handlePushPacketProcessed()

void inet::queueing::PreemptingServer::handlePushPacketProcessed	(	Packet *	packet,
		cGate *	gate,
		bool	successful
	)

overridevirtual

Notifies about the completion of the packet processing for a packet that was pushed earlier independently whether the packet is passed or streamed.

This method is called, for example, when a previously pushed packet is failed to be processed successfully. It allows the source to retry the operation.

The gate parameter must be a valid gate of this module. The packet must not be nullptr.

Reimplemented from inet::queueing::PacketServerBase.

 {
     Enter_Method("handlePushPacketProcessed");
     if (isStreaming()) {
         delete streamedPacket;
         streamedPacket = provider->pullPacketEnd(inputGate->getPathStartGate());
         take(streamedPacket);
         EV_INFO << "Ending streaming packet" << EV_FIELD(packet, *streamedPacket) << EV_ENDL;
         delete streamedPacket;
         streamedPacket = nullptr;
     }
 }

◆ initialize()

void inet::queueing::PreemptingServer::initialize ( int stage )

overrideprotectedvirtual

Reimplemented from inet::queueing::PacketServerBase.

 {
     ClockUserModuleMixin::initialize(stage);
     if (stage == INITSTAGE_LOCAL) {
         datarate = bps(par("datarate"));
         timer = new ClockEvent("Timer");
     }
 }

◆ isStreaming()

virtual bool inet::queueing::PreemptingServer::isStreaming ( ) const

inlineprotectedvirtual

32 { return streamedPacket != nullptr; }

Referenced by handleCanPullPacketChanged(), handleCanPushPacketChanged(), and handlePushPacketProcessed().

◆ startStreaming()

void inet::queueing::PreemptingServer::startStreaming ( )

protectedvirtual

 {
     auto packet = provider->pullPacketStart(inputGate->getPathStartGate(), datarate);
     take(packet);
     EV_INFO << "Starting streaming packet" << EV_FIELD(packet) << EV_ENDL;
     streamedPacket = packet;
     pushOrSendPacketStart(streamedPacket->dup(), outputGate, consumer, datarate, packet->getTransmissionId());
     scheduleClockEventAfter(s(streamedPacket->getTotalLength() / datarate).get(), timer);
     handlePacketProcessed(streamedPacket);
     updateDisplayString();
 }

Referenced by handleCanPullPacketChanged(), and handleCanPushPacketChanged().

Member Data Documentation

◆ datarate

bps inet::queueing::PreemptingServer::datarate = bps(NaN)

protected

Referenced by initialize(), and startStreaming().

◆ streamedPacket

Packet* inet::queueing::PreemptingServer::streamedPacket = nullptr

protected

Referenced by endStreaming(), handlePushPacketProcessed(), and startStreaming().

◆ timer

ClockEvent* inet::queueing::PreemptingServer::timer = nullptr

protected

Referenced by handleCanPullPacketChanged(), handleMessage(), initialize(), and startStreaming().

The documentation for this class was generated from the following files:

Public Member Functions

Protected Member Functions

Protected Attributes

Additional Inherited Members

Constructor & Destructor Documentation

◆ ~PreemptingServer()

Member Function Documentation

◆ canStartStreaming()

◆ endStreaming()

◆ handleCanPullPacketChanged()

◆ handleCanPushPacketChanged()

◆ handleMessage()

◆ handlePushPacketProcessed()

◆ initialize()

◆ isStreaming()

◆ startStreaming()

Member Data Documentation

◆ datarate

◆ streamedPacket

◆ timer