Apache Log4cxx  Version 1.8.0
timebasedrollingpolicy.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 
19 #if !defined(_LOG4CXX_ROLLING_TIME_BASED_ROLLING_POLICY_H)
20 #define _LOG4CXX_ROLLING_TIME_BASED_ROLLING_POLICY_H
21 
24 #include <log4cxx/writerappender.h>
26 #include <functional>
27 
28 namespace LOG4CXX_NS
29 {
30 
31 namespace rolling
32 {
33 
34 
35 
140 class LOG4CXX_EXPORT TimeBasedRollingPolicy
141 #if LOG4CXX_ABI_VERSION <= 15
142  : public virtual RollingPolicyBase
143  , public virtual TriggeringPolicy
144 #else
145  : public RollingPolicyBase
146  , public virtual TriggeringPolicy
147 #endif
148 {
155 
156  private:
157  LOG4CXX_DECLARE_PRIVATE_MEMBER_PTR(TimeBasedRollingPolicyPrivate, m_priv)
158 
159  public:
162 
163  using RollingPolicyBase::activateOptions;
172 
173  void setMultiprocess(bool multiprocess);
174 
175  using RollingPolicy::initialize;
180 
181  using RollingPolicy::rollover;
186 
199  Appender* appender,
200  const spi::LoggingEventPtr& event,
201  const LogString& filename,
202  size_t fileLength) override;
203 
213  void setOption(const LogString& option, const LogString& value) override;
214 
219 
224 
225  protected:
232 
233  private:
234 
238  int createMMapFile(const std::string& lastfilename, LOG4CXX_NS::helpers::Pool& pool);
239 
243  bool isMapFileEmpty(LOG4CXX_NS::helpers::Pool& pool);
244 
248  void initMMapFile(const LogString& lastFileName, LOG4CXX_NS::helpers::Pool& pool);
249 
253  int lockMMapFile(int type);
254 
258  int unLockMMapFile();
259 
263  const std::string createFile(const std::string& filename, const std::string& suffix, LOG4CXX_NS::helpers::Pool& pool);
264 
265 };
266 
268 
269 }
270 }
271 
272 #endif
273 
Implement this interface for your own strategies for outputting log statements.
Definition: appender.h:55
Implements methods common to most, it not all, rolling policies.
Definition: rollingpolicybase.h:49
TimeBasedRollingPolicy is both easy to configure and quite powerful.
Definition: timebasedrollingpolicy.h:148
bool isTriggeringEvent(Appender *appender, const spi::LoggingEventPtr &event, const LogString &filename, size_t fileLength) override
Determines if a rollover may be appropriate at this time.
void activateOptions(helpers::Pool &p) override
bool isLastFileNameUnchanged()
Was the name in shared memory set by this process?
RolloverDescriptionPtr rollover(const LogString &currentActiveFile, bool append, helpers::Pool &p) override
The pool parameter is not used and will be removed in a future version.Implement this method for now,...
RolloverDescriptionPtr initialize(const LogString &currentActiveFile, bool append, helpers::Pool &p) override
The pool parameter is not used and will be removed in a future version.Implement this method for now,...
void setOption(const LogString &option, const LogString &value) override
Set option to value.
log4cxx::pattern::PatternMap getFormatSpecifiers() const override
A map from "d" and "date" to a date conversion formatter.
void setMultiprocess(bool multiprocess)
void loadLastFileName()
Load the name (set by some other process) from shared memory.
A TriggeringPolicy controls the conditions under which rollover occurs.
Definition: triggeringpolicy.h:51
std::map< LogString, PatternConstructor > PatternMap
Definition: patternparser.h:35
LOG4CXX_PTR_DEF(TimeBasedRollingPolicy)
std::shared_ptr< LoggingEvent > LoggingEventPtr
Definition: appender.h:31
std::basic_string< logchar > LogString
Definition: logstring.h:60
#define LOG4CXX_CAST_ENTRY(Interface)
Definition: object.h:154
#define END_LOG4CXX_CAST_MAP()
Definition: object.h:148
#define DECLARE_LOG4CXX_OBJECT(object)
Definition: object.h:41
#define LOG4CXX_CAST_ENTRY_CHAIN(Interface)
Definition: object.h:160
#define BEGIN_LOG4CXX_CAST_MAP()
Definition: object.h:142
#define LOG4CXX_ACTIVATE_OPTIONS_FORMAL_PARAMETERS
Activate the options that were previously set with calls to option setters.
Definition: optionhandler.h:53
#define LOG4CXX_ROLLING_POLICY_INITIALIZE_FORMAL_PARAMETERS
Definition: rollingpolicy.h:67
#define LOG4CXX_ROLLING_POLICY_ROLLOVER_FORMAL_PARAMETERS
Definition: rollingpolicy.h:99