Classes
Clusters
Cluster hierarchy
Relations
Contracts
Flat contracts
Go to: 
indexing
	description: "Hierarchy of logging categories."
	project: "Project Goanna <http://sourceforge.net/projects/goanna>"
	library: "log4e"
	date: "$Date$"
	revision: "$Revision$"
	author: "Glenn Maughan <glennmaughan@goanna.info>"
	copyright: "Copyright (c) 2002 Glenn Maughan"
	license: "Eiffel Forum License v1 (see forum.txt)."

class interface
	L4E_HIERARCHY

create 
	make

feature -- Initialisation

	make (priority: L4E_PRIORITY)
			-- Create a logger hierarchy with a
			-- root logger with priority 'priority'.
		ensure
			not_disabled: disabled = disable_off
	
feature -- Logger Factory

	logger (cat_name: STRING): L4E_LOGGER
			-- Return a logger for 'name'. Initialise a new
			-- logger instance if necessary.
		require
			cat_name_exists: cat_name /= void and then not cat_name.is_empty
			no_start_or_end_dots: cat_name.item (1) /= '.' and then cat_name.item (cat_name.count) /= '.'
			no_consecutive_dots: cat_name.substring_index ("..", 1) = 0
		ensure
			logger_exists: has (cat_name)

	all_loggers: DS_LIST [L4E_LOGGER]
			-- Return list of all current categories. Root logger will be first in list
	
feature -- Status Report

	root: L4E_LOGGER
			-- Root logger of this hierarchy

	disabled: INTEGER
			-- Globally disabled priority level. Disable_off if no priorities
			-- are disabled.

	has (name: STRING): BOOLEAN
			-- Does a logger with 'name' exist in this hierarchy?
		require
			name_exists: name /= void

	Disable_off: INTEGER is -1
			-- Priority disabled off

	is_enabled_for (priority: L4E_PRIORITY): BOOLEAN
			-- Is 'priority' level logging enabled for this hierarchy?
	
feature -- Status Setting

	disable (priority: L4E_PRIORITY)
			-- Disable all logging for level 'priority'
		require
			priority_exists: priority /= void
		ensure
			priority_disabled: disabled = priority.level

	disable_debug
			-- Disable debug logging

	disable_info
			-- Disable info logging

	disable_all
			-- Disable all logging

	enable_all
			-- Enable all logging

	clear
			-- Clear all categories from this hierarchy

	close_all
			-- Close all appenders for all categories in this
			-- hierarchy
	
end -- class L4E_HIERARCHY


Classes
Clusters
Cluster hierarchy
Relations
Contracts
Flat contracts
Go to: 

Goanna Log4E -- Copyright © 2002 Glenn Maughan