Apache Log4cxx  Version 2.0.0
Loading...
Searching...
No Matches
hierarchy.h
Go to the documentation of this file.
1/*
2 * Licensed to the Apache Software Foundation (ASF) under one or more
3 * contributor license agreements. See the NOTICE file distributed with
4 * this work for additional information regarding copyright ownership.
5 * The ASF licenses this file to You under the Apache License, Version 2.0
6 * (the "License"); you may not use this file except in compliance with
7 * the License. You may obtain a copy of the License at
8 *
9 * http://www.apache.org/licenses/LICENSE-2.0
10 *
11 * Unless required by applicable law or agreed to in writing, software
12 * distributed under the License is distributed on an "AS IS" BASIS,
13 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14 * See the License for the specific language governing permissions and
15 * limitations under the License.
16 */
17
18#ifndef _LOG4CXX_HIERARCHY_H
19#define _LOG4CXX_HIERARCHY_H
20
21
26
27namespace LOG4CXX_NS
28{
29
30class Hierarchy;
32
51class LOG4CXX_EXPORT Hierarchy : public spi::LoggerRepository
52{
53 private:
54 LOG4CXX_DECLARE_PRIVATE_MEMBER_PTR(HierarchyPrivate, m_priv)
55
56 public:
59 LOG4CXX_CAST_ENTRY(Hierarchy)
62
63 private:
67 Hierarchy();
68
69 public:
70 static HierarchyPtr create();
71
73
74 void addHierarchyEventListener(const spi::HierarchyEventListenerPtr& listener) override;
75
80 void removeHierarchyEventListener(const spi::HierarchyEventListenerPtr& listener) override;
81
88 void ensureIsConfigured(std::function<void()> configurator) override;
89
98 void clear();
99
100 void emitNoAppenderWarning(const Logger* logger) override;
101
109 LoggerPtr exists(const LogString& name) override;
110
114 void setThreshold(const LogString& levelStr) override;
115
122 void setThreshold(const LevelPtr& newLevel) override;
123
124 void fireAddAppenderEvent(const Logger* logger, const Appender* appender) override;
125
126 void fireRemoveAppenderEvent(const Logger* logger, const Appender* appender) override;
127
132 LevelPtr getThreshold() const override;
133
145 LoggerPtr getLogger(const LogString& name) override;
146
161 const spi::LoggerFactoryPtr& factory) override;
162
170
174 LoggerPtr getRootLogger() const override;
175
181 bool isDisabled(int level) const override;
182
196 void resetConfiguration() override;
197
215 void shutdown() override;
216
217
218 virtual bool isConfigured() override;
219 virtual void setConfigured(bool configured) override;
220
224 void updateChildren(const Logger* parent);
225
237 bool removeLogger(const LogString& name, bool ifNotUsed = true) override;
238
239 private:
240
244 void setThresholdInternal(const LevelPtr& l);
245
249 void shutdownInternal();
250
274 void updateParents(const LoggerPtr& logger, const LoggerPtr& root);
275
290 void updateChildren(ProvisionNode& pn, const LoggerPtr& logger);
291
292 Hierarchy(const Hierarchy&);
293 Hierarchy& operator=(const Hierarchy&);
294
295};
296
297} //namespace log4cxx
298
299#endif //_LOG4CXX_HIERARCHY_H
Implement this interface for your own strategies for outputting log statements.
Definition appender.h:51
This class is specialized in retrieving loggers by name and also maintaining the logger hierarchy.
Definition hierarchy.h:52
void ensureIsConfigured(std::function< void()> configurator) override
Call configurator if not yet configured and configurator has not already been tried.
bool removeLogger(const LogString &name, bool ifNotUsed=true) override
Remove the name Logger from the hierarchy.
LoggerList getCurrentLoggers() const override
Returns all the currently defined loggers in this hierarchy as a LoggerList.
void emitNoAppenderWarning(const Logger *logger) override
LoggerPtr getRootLogger() const override
Get the root of this hierarchy.
void resetConfiguration() override
Reset all values contained in this hierarchy instance to their default.
LevelPtr getThreshold() const override
Returns a Level representation of the enable state.
LoggerPtr exists(const LogString &name) override
Check if the named logger exists in the hierarchy.
void removeHierarchyEventListener(const spi::HierarchyEventListenerPtr &listener) override
Remove a previously added HierarchyEventListener.
LoggerPtr getLogger(const LogString &name) override
Retrieve the name Logger instance using the default factory to create it if required.
void setThreshold(const LevelPtr &newLevel) override
Enable logging for logging requests with level newLevel or higher.
virtual void setConfigured(bool configured) override
void fireAddAppenderEvent(const Logger *logger, const Appender *appender) override
static HierarchyPtr create()
bool isDisabled(int level) const override
This method will return true if this repository is disabled for level object passed as parameter and ...
void updateChildren(const Logger *parent)
Refresh the threshold in children of parent.
virtual bool isConfigured() override
void addHierarchyEventListener(const spi::HierarchyEventListenerPtr &listener) override
void clear()
This call will clear all logger definitions from the internal hashtable.
void setThreshold(const LogString &levelStr) override
The string form of setThreshold.
LoggerPtr getLogger(const LogString &name, const spi::LoggerFactoryPtr &factory) override
Retrieve the name Logger instance using factory to create it if required.
void fireRemoveAppenderEvent(const Logger *logger, const Appender *appender) override
void shutdown() override
Used by subclasses to add a renderer to the hierarchy passed as parameter.
This is the central class in the log4cxx package.
Definition log4cxx/logger.h:51
A LoggerRepository is used to create and retrieve Loggers.
Definition loggerrepository.h:43
std::shared_ptr< LoggerFactory > LoggerFactoryPtr
Definition logmanager.h:34
std::vector< LoggerPtr > ProvisionNode
Definition provisionnode.h:31
std::basic_string< logchar > LogString
Definition logstring.h:51
std::shared_ptr< Level > LevelPtr
Definition optionconverter.h:28
LOG4CXX_PTR_DEF(Appender)
std::shared_ptr< Logger > LoggerPtr
Definition logmanager.h:28
std::vector< LoggerPtr > LoggerList
Definition logmanager.h:29
#define LOG4CXX_CAST_ENTRY(Interface)
Definition object.h:154
#define DECLARE_ABSTRACT_LOG4CXX_OBJECT(object)
Definition object.h:37
#define END_LOG4CXX_CAST_MAP()
Definition object.h:148
#define LOG4CXX_CAST_ENTRY_CHAIN(Interface)
Definition object.h:160
#define BEGIN_LOG4CXX_CAST_MAP()
Definition object.h:142