Component that routes messages from one container to another with filtering. More...

#include <CLogRouterComp.h>

Inheritance diagram for ilog::CLogRouterComp:

Public Types
typedef icomp::CComponentBase	BaseClass
	Base class typedef for component functionality.

typedef imod::CSingleModelObserverBase	BaseClass2
	Base class typedef for observer functionality.

Public Types inherited from imod::CSingleModelObserverBase
typedef imod::IModel	ModelType

Protected Member Functions
virtual void	OnComponentCreated () override

virtual void	OnComponentDestroyed () override

virtual void	OnUpdate (const istd::IChangeable::ChangeSet &changeSet) override
	Called on update of observed model.

Protected Member Functions inherited from icomp::CComponentBase
bool	IsComponentActive () const
	Check if component is active.

virtual const icomp::IRealComponentStaticInfo &	GetComponentStaticInfo () const =0
	Get access to static info of this component.

Protected Member Functions inherited from imod::CSingleModelObserverBase
void	SetModelPtr (imod::IModel *modelPtr)
	Set internal model pointer to specified value.

Additional Inherited Members
Public Member Functions inherited from icomp::CComponentBase
	CComponentBase ()
	Create component and assign it to specific context.

virtual const icomp::IComponent *	GetParentComponent (bool ownerOnly=false) const override
	Get parent of this component.

virtual void *	GetInterface (const istd::CClassInfo &interfaceType, const QByteArray &subId="") override
	Get access to specified component interface.

virtual IComponentContextSharedPtr	GetComponentContext () const override
	Get access to component context describing all application-specified component information loaded from components registry.

virtual void	SetComponentContext (const IComponentContextSharedPtr &contextPtr, const icomp::IComponent *parentPtr, bool isParentOwner) override
	Set component context of this component.

Public Member Functions inherited from istd::IPolymorphic
virtual	~IPolymorphic ()

Public Member Functions inherited from imod::CSingleModelObserverBase
	CSingleModelObserverBase ()

virtual	~CSingleModelObserverBase ()

imod::IModel *	GetObservedModel () const
	Get access to observed model.

imod::IModel *	GetModelPtr () const
	Get access to observed model.

void	EnsureModelDetached ()
	Make sure this observer is detached.

void	SetObservedIds (const istd::IChangeable::ChangeSet &changeMask)
	Set list of ID's beeing observed.

virtual bool	IsModelAttached (const imod::IModel *modelPtr=NULL) const override
	Checks if the specified model is currently attached to this observer.

virtual bool	OnModelAttached (imod::IModel *modelPtr, istd::IChangeable::ChangeSet &changeMask) override
	Callback invoked when an observable model is about to be attached to this observer.

virtual bool	OnModelDetached (imod::IModel *modelPtr) override
	Callback invoked when an observable model is about to be detached from this observer.

virtual void	BeforeUpdate (imod::IModel *modelPtr) override
	Callback invoked before an update of the observer's content occurs.

virtual void	AfterUpdate (imod::IModel *modelPtr, const istd::IChangeable::ChangeSet &changeSet) override
	Callback invoked after an update of the observer's content occurs.

Static Protected Member Functions inherited from icomp::CComponentBase
static const icomp::IRealComponentStaticInfo &	InitStaticInfo (IComponent *componentPtr)

static QByteArray	GetComponentId (const icomp::IComponentContext *componentContextPtr, const QByteArray &contextId=QByteArray())

Static Protected Attributes inherited from imod::CSingleModelObserverBase
static const istd::IChangeable::ChangeSet	s_undoChanges

Detailed Description

Component that routes messages from one container to another with filtering.

CLogRouterComp observes a source message container and automatically forwards new messages to an output message consumer. It can filter messages by minimum severity level, and prevents duplicate forwarding by tracking already-processed messages.

This component is useful for:

Separating errors from general logs
Forwarding critical messages to multiple destinations
Building hierarchical logging systems
Creating filtered log views

Features

Automatic message forwarding when source container changes
Severity-based filtering (forward only messages >= minimum category)
Duplicate detection (won't forward same message twice)
Model-observer integration for reactive updates
Component-based configuration

Configuration

Component references:

InputMessageContainer: Source container to monitor (IMessageContainer)
OutputMessageConsumer: Destination for forwarded messages (IMessageConsumer)

Component attributes:

MinimalCategory: Minimum severity to forward (-1=all, 0=none, 1=info+, 2=warning+, 3=error+, 4=critical only)

Usage Example: // Create source and destination

istd::TSharedInterfacePtr<ilog::CLogComp> mainLog(new ilog::CLogComp);

istd::TSharedInterfacePtr<ilog::CLogComp> errorLog(new ilog::CLogComp);

// Create router

istd::TSharedInterfacePtr<ilog::CLogRouterComp> router(

new ilog::CLogRouterComp);

// Configure via .acc:

// InputMessageContainer -> mainLog

// OutputMessageConsumer -> errorLog

// MinimalCategory -> 3 (errors and critical)

// Add messages to main log

mainLog->AddMessage(infoMsg); // Not forwarded

mainLog->AddMessage(errorMsg); // Forwarded to errorLog

mainLog->AddMessage(criticalMsg);// Forwarded to errorLog

ilog::CLogComp
Complete logging component with message storage and container interface.
Definition CLogComp.h:86

ilog::CLogRouterComp
Component that routes messages from one container to another with filtering.
Definition CLogRouterComp.h:83

istd::TSharedInterfacePtr
Shared ownership smart pointer for interface types.
Definition TInterfacePtr.h:507

Component Configuration: <Component Id="ErrorRouter" Class="ilog::CLogRouterComp">

<Reference Id="InputMessageContainer" Value="MainLog"/>

<Reference Id="OutputMessageConsumer" Value="ErrorLog"/>

<Attribute Id="MinimalCategory" Value="3"/>

</Component>