Log component. More...

#include <NLog.hpp>

Inherits QObject, CNode, and LogStringForwarder.

Signals
void	new_message (const QString &message, uiCommon::LogMessage::Type type)
	Signal emitted when a new message arrives. More...

void	new_exception (const QString &message)
	Signal emitted when an exception arrives. More...

Public Member Functions
	NLog ()
	Constructor. More...

	~NLog ()
	Destructor. More...

void	add_message (const QString &message)
	Adds a message to the log. More...

void	add_error (const QString &message)
	Adds an error message to the log. More...

void	add_warning (const QString &message)
	Adds a warning message to the log. More...

void	add_exception (const QString &message)
	Adds an exception message to the log. More...

virtual QString	tool_tip () const
	Gives the text to put on a tool tip. More...

Public Member Functions inherited from CNode
	CNode (const std::string &name, const QString &component_type, Type type)

std::string	derived_type_name () const
	Component::derived_type_name implementation. More...

QString	component_type () const

Handle< CNode >	child (Uint index)

bool	is_local_component () const

Type	type () const

bool	is_root ()

void	set_properties (const common::SignalArgs &node)

void	set_signals (const common::SignalArgs &node)

void	modify_options (const QMap< QString, QString > &options)
	Modifies options. More...

void	list_options (QList< boost::shared_ptr< common::Option > > &list)

void	list_properties (QMap< QString, QString > &props)

void	list_signals (QList< ActionInfo > &actions)

template<class TYPE >
Handle< const TYPE >	castTo () const

template<class TYPE >
Handle< TYPE >	castTo ()

void	connect_notifier (QObject reciever, const char signal, const char *slot)

void	add_node (boost::shared_ptr< CNode > node)
	Adds a sub-node. More...

void	remove_node (const QString &node_name)
	Removes a sub-node. More...

CNodeNotifier *	notifier () const

void	list_child_paths (QStringList &list, bool recursive, bool client_node=true) const
	Lists all children paths in a string list. More...

void	request_signal_signature (const QString &name)

void	local_signature (const QString &name, common::SignalArgs &node)
	Retrieves the signature of a local signal. More...

void	finish_setup ()

virtual void	about_to_be_removed ()

void	reply_update_tree (common::SignalArgs &node)

void	reply_configure (common::SignalArgs &node)

void	reply_list_content (common::SignalArgs &node)

void	reply_signal_signature (common::SignalArgs &node)
	Method called when the server replies to a signal. More...

Public Member Functions inherited from Component
	Component (const std::string &name)

virtual	~Component ()
	Virtual destructor. More...

const std::string &	name () const
	Access the name of the component. More...

void	rename (const std::string &name)
	Rename the component. More...

URI	uri () const
	Construct the full path. More...

void	complete_path (URI &path) const

Handle< Component >	access_component (const URI &path) const

Handle< Component >	access_component_checked (const URI &path)

Handle< Component const >	access_component_checked (const URI &path) const

Handle< Component >	handle ()
	Get a handle to the component. More...

Handle< Component const >	handle () const

template<typename ComponentT >
Handle< ComponentT >	handle ()

template<typename ComponentT >
Handle< ComponentT const >	handle () const

Handle< Component >	parent () const

Handle< Component const >	root () const

Handle< Component >	root ()

Handle< Component >	get_child (const std::string &name)

Handle< Component const >	get_child (const std::string &name) const

Handle< Component >	get_child_checked (const std::string &name)

Handle< Component const >	get_child_checked (const std::string &name) const

Handle< Component >	create_component (const std::string &name, const std::string &builder)
	Build a (sub)component of this component using the extended type_name of the component. More...

template<typename T >
Handle< T >	create_component (const std::string &name)
	Create a (sub)component of this component automatically cast to the specified type. More...

template<typename T >
Handle< T >	create_static_component (const std::string &name)
	Create a static "always there" subcomponent. More...

Component &	add_component (const boost::shared_ptr< Component > &subcomp)
	Add the passed component as a subcomponent. More...

void	add_link (Component &linked_component)

boost::shared_ptr< Component >	remove_component (const std::string &name)
	Remove a (sub)component of this component. More...

boost::shared_ptr< Component >	remove_component (Component &subcomp)
	Remove a (sub)component of this component. More...

void	clear ()
	Remove all sub-components of this component, except for the static ones. More...

void	move_to (Component &to_parent)

std::string	tree (bool basic_mode=false, Uint depth=0, Uint recursion_level=0) const

std::string	info (const std::string &what=std::string("cospt")) const

size_t	count_children () const

PropertyList &	properties ()

const PropertyList &	properties () const

OptionList &	options ()

const OptionList &	options () const

void	reset_options ()
	Reset all options to their default value. More...

void	configure_option_recursively (const std::string &optname, const boost::any &val)

Component &	mark_basic ()
	marks this component as basic. More...

template<typename ComponentT >
void	put_components (std::vector< boost::shared_ptr< ComponentT > > &vec, const bool recurse)

template<typename ComponentT >
void	put_components (std::vector< boost::shared_ptr< ComponentT const > > &vec, const bool recurse) const

template<>
void	put_components (std::vector< boost::shared_ptr< Component > > &vec, const bool recurse)

template<>
void	put_components (std::vector< boost::shared_ptr< Component const > > &vec, const bool recurse) const

Component::iterator	begin ()
	The begin iterator for a range containing Components. More...

Component::iterator	end ()
	The end iterator for a range containing Components. More...

Component::const_iterator	begin () const
	The begin iterator for a range containing Components (const version) More...

Component::const_iterator	end () const
	The end iterator for a range containing Components (const version) More...

Component::iterator	recursive_begin ()
	The begin iterator for a recursive range containing Components. More...

Component::iterator	recursive_end ()
	The end iterator for a recursive range containing Components. More...

Component::const_iterator	recursive_begin () const
	The begin iterator for a recursive range containing Components (const version) More...

Component::const_iterator	recursive_end () const
	The end iterator for a recursive range containing Components (const version) More...

template<typename T >
Handle< T >	create_component (const std::string &name, const std::string &builder)
	Create a component using the reduced builder name. More...

void	signal_configure (SignalArgs &args)
	configures all the options on this class More...

void	signal_create_component (SignalArgs &args)
	creates a component from this component More...

void	signal_delete_component (SignalArgs &args)
	delete this component More...

void	signal_move_component (SignalArgs &args)
	moves a component from this component to another More...

void	signal_list_tree (SignalArgs &args) const
	lists the sub components and puts them on the xml_tree More...

void	signal_list_tree_recursive (SignalArgs &args) const
	prints tree recursively More...

void	signal_list_properties (SignalArgs &args) const
	lists the properties of this component More...

void	signal_list_options (SignalArgs &args) const
	lists the properties of this component More...

void	signal_list_options_recursive (SignalArgs &args) const
	prints all options recursive More...

void	signal_list_signals (SignalArgs &args) const
	lists the signals of this component More...

void	signal_list_signals_recursive (SignalArgs &args) const
	prints all signals recursive More...

void	signal_print_info (SignalArgs &args) const
	gets info on this component More...

void	signal_print_tree (SignalArgs &args) const
	signal to print the tree More...

void	signature_print_tree (SignalArgs &args) const
	signature to signal_print_tree More...

void	signal_rename_component (SignalArgs &args)
	renames this component More...

void	signal_save_tree (SignalArgs &args)
	dumps the tree to a file More...

void	signal_list_content (SignalArgs &args)
	gives information about this component such as options, signals, ... More...

void	signal_signature (SignalArgs &args)
	Gives a signal signature, if any. More...

void	signature_create_component (SignalArgs &args)

void	signature_rename_component (SignalArgs &args)

void	signature_move_component (SignalArgs &args)

void	signal_store_timings (SignalArgs &args)
	Signal to store the timings (if enabled) into properties, i.e. for readout from python or the GUI. More...

void	signal_clear (SignalArgs &args)
	Signal to remove all sub-components. More...

void	signal_reset_options (SignalArgs &args)
	Signal to set all options to their default value. More...

void	signal_add_tag (SignalArgs &args)
	Signal to add a tag. More...

void	signature_add_tag (SignalArgs &args)

Public Member Functions inherited from SignalHandler
	~SignalHandler ()

const storage_t &	signal_list () const

SignalPtr	signal (const SignalID &sname)

SignalCPtr	signal (const SignalID &sname) const

SignalRet	call_signal (const SignalID &sname, SignalArgs &sinput)
	Calls the signal by providing its name and input. More...

SignalRet	call_signal (const SignalID &sname, std::vector< std::string > &sinput)
	Calls the signal by providing its name and input. More...

bool	signal_exists (const SignalID &sname) const
	Checks if a signal exists or not. More...

Signal &	regist_signal (const SignalID &sname)
	Regist signal. More...

void	unregist_signal (const SignalID &sname)
	Unregist signal. More...

Public Member Functions inherited from ConnectionManager
	~ConnectionManager ()
	destructor closes all connections More...

Connection *	connection (const std::string &name)

Connection *	manage_connection (const std::string &name)
	manages a connection (creates if necessary) More...

Public Member Functions inherited from TaggedObject
	TaggedObject ()
	Constructor. More...

bool	has_tag (const std::string &tag) const

void	add_tag (const std::string &tag)

std::vector< std::string >	get_tags () const

void	remove_tag (const std::string &tag)

Public Member Functions inherited from LogStringForwarder
	LogStringForwarder ()
	Empty constructor. More...

virtual	~LogStringForwarder ()

Static Public Member Functions
static Handle< NLog >	global ()

Static Public Member Functions inherited from CNode
static std::string	type_name ()

static boost::shared_ptr< CNode >	create_from_xml (common::XML::XmlNode node)
	Creates an object tree from a given node. More...

Static Public Member Functions inherited from Component
static std::string	type_name ()
	Get the class name. More...

Protected Member Functions
virtual void	disable_local_signals (QMap< QString, bool > &localSignals) const

virtual void	message (const std::string &data)

Protected Member Functions inherited from CNode
virtual void	setup_finished ()

Protected Member Functions inherited from Component
Component &	add_static_component (const boost::shared_ptr< Component > &subcomp)
	Add a static (sub)component of this component. More...

void	raise_tree_updated_event ()
	raise event that the path has changed More...

Private Member Functions
void	signal_message (common::SignalArgs &node)
	Boost slot called when a message comes from the server. More...

void	append_to_log (uiCommon::LogMessage::Type type, bool fromServer, const QString &message)
	Appends a message to the log. More...

Private Attributes
QHash< uiCommon::LogMessage::Type, QString >	m_typeNames
	Hash map that associates a type message to its name in string format. More...

Additional Inherited Members
Public Types inherited from CNode
enum	Type { STANDARD_NODE = 0, LOCAL_NODE = 1, DEBUG_NODE = 2 }
	Defines the sub-node types. More...

Public Types inherited from Component
typedef ComponentIterator< Component >	iterator
	type of the iterator to Component More...

typedef ComponentIterator< Component const >	const_iterator
	type of the iterator to constant Component More...

Public Types inherited from SignalHandler
typedef std::vector< SignalPtr >	storage_t
	storage type for signals More...

Public Attributes inherited from SignalHandler
storage_t	m_signals
	storage of the signals More...

Protected Attributes inherited from CNode
CNodeNotifier *	m_notifier
	This internal notifier. More...

QStringList	m_local_signals
	Lists the names of the local signals. More...

QMutex *	m_mutex

bool	m_content_listed

bool	m_listing_content

bool	m_is_root

QList< ActionInfo >	m_action_sigs
	List of signals that can be remotely executed. More...

Detailed Description

Log component.

Author: Quentin Gasper.

Definition at line 34 of file NLog.hpp.

Constructor & Destructor Documentation

NLog ( )

Constructor.

Definition at line 33 of file NLog.cpp.

~NLog ( )

Destructor.

Frees all allocated memory.

Definition at line 48 of file NLog.cpp.

Member Function Documentation

void add_error ( const QString & message )

Adds an error message to the log.

If the message contains '<' or '>' characters, they will replaced respectively by '<' and '>'.

Parameters

message The error message to add.

Definition at line 64 of file NLog.cpp.

void add_exception ( const QString & message )

Adds an exception message to the log.

Parameters

message The exception message to add.

Definition at line 82 of file NLog.cpp.

void add_message ( const QString & message )

Adds a message to the log.

If the message contains '<' or '>' characters, they will replaced respectively by '<' and '>'.

Parameters

message The message to add.

Definition at line 55 of file NLog.cpp.

void add_warning ( const QString & message )

Adds a warning message to the log.

If the message contains '<' or '>' characters, they will replaced respectively by '<' and '>'.

Parameters

message The warning message to add.

Definition at line 73 of file NLog.cpp.

void append_to_log	(	uiCommon::LogMessage::Type	type,
		bool	fromServer,
		const QString &	message
	)

private

Appends a message to the log.

If the message contains '<' or '>' characters, they will replaced respectively by '<' and '>'.

Parameters

type	Message type
fromServer	If `true`, the message comes from the server; otherwise it comes from the client.
message	Message

Definition at line 91 of file NLog.cpp.

virtual void disable_local_signals ( QMap< QString, bool > & localSignals ) const

inlineprotectedvirtual

Disables the local signals that need to.

Parameters

localSignals Map of local signals. All values are set to true by default.

Implements CNode.

Definition at line 100 of file NLog.hpp.

Handle< NLog > global ( )

static

Definition at line 146 of file NLog.cpp.

void message ( const std::string & str )

protectedvirtual

Todo:: missing API documentation

Implements LogStringForwarder.

Definition at line 134 of file NLog.cpp.

void new_exception ( const QString & message )

signal

Signal emitted when an exception arrives.

Parameters

message Exception message

void new_message	(	const QString &	message,
		uiCommon::LogMessage::Type	type
	)

signal

Signal emitted when a new message arrives.

Parameters

message	Message text
isError	If `true` it is an error message; otherwise it is a "normal" message.

void signal_message ( common::SignalArgs & node )

private

Boost slot called when a message comes from the server.

Parameters

node	Signal node

Definition at line 112 of file NLog.cpp.

QString tool_tip ( ) const

virtual

Gives the text to put on a tool tip.

Returns: The name of the class.

Implements CNode.

Definition at line 127 of file NLog.cpp.

Member Data Documentation

QHash<uiCommon::LogMessage::Type, QString> m_typeNames

private

Hash map that associates a type message to its name in string format.

The key is the type. The value is the name.

Definition at line 110 of file NLog.hpp.

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

cf3/ui/core/NLog.hpp
cf3/ui/core/NLog.cpp

Signals

Public Member Functions

Static Public Member Functions

Protected Member Functions

Private Member Functions

Private Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation