/src/logging-log4cxx/src/main/cpp/domconfigurator.cpp

Source (jump to first uncovered line)
/*
 * Licensed to the Apache Software Foundation (ASF) under one or more
 * contributor license agreements.  See the NOTICE file distributed with
 * this work for additional information regarding copyright ownership.
 * The ASF licenses this file to You under the Apache License, Version 2.0
 * (the "License"); you may not use this file except in compliance with
 * the License.  You may obtain a copy of the License at
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
#include <log4cxx/private/string_c11.h>
#include <log4cxx/logstring.h>
#include <log4cxx/xml/domconfigurator.h>
#include <log4cxx/appender.h>
#include <log4cxx/layout.h>
#include <log4cxx/logger.h>
#include <log4cxx/logmanager.h>
#include <log4cxx/level.h>
#include <log4cxx/spi/filter.h>
#include <log4cxx/helpers/loglog.h>
#include <log4cxx/helpers/stringhelper.h>
#include <log4cxx/helpers/loader.h>
#include <log4cxx/helpers/optionconverter.h>
#include <log4cxx/config/propertysetter.h>
#include <log4cxx/spi/errorhandler.h>
#include <log4cxx/spi/loggerfactory.h>
#if LOG4CXX_ABI_VERSION <= 15
#include <log4cxx/defaultloggerfactory.h>
#else
#include <log4cxx/spi/loggerfactory.h>
#endif
#include <log4cxx/helpers/filewatchdog.h>
#include <log4cxx/spi/loggerrepository.h>
#include <log4cxx/spi/loggingevent.h>
#include <log4cxx/helpers/pool.h>
#include <sstream>
#include <log4cxx/helpers/transcoder.h>
#include <log4cxx/rolling/rollingfileappender.h>
#include <log4cxx/rolling/filterbasedtriggeringpolicy.h>
#include <apr_xml.h>
#include <log4cxx/helpers/bytebuffer.h>
#include <log4cxx/helpers/charsetdecoder.h>
#include <log4cxx/net/smtpappender.h>
#include <log4cxx/helpers/messagebuffer.h>
#include <log4cxx/helpers/threadutility.h>

#define LOG4CXX 1
#include <log4cxx/helpers/aprinitializer.h>

using namespace LOG4CXX_NS;
using namespace LOG4CXX_NS::xml;
using namespace LOG4CXX_NS::helpers;
using namespace LOG4CXX_NS::spi;
using namespace LOG4CXX_NS::config;
using namespace LOG4CXX_NS::rolling;

#define MAX_ATTRIBUTE_NAME_LEN 2000

struct DOMConfigurator::DOMConfiguratorPrivate
{
  helpers::Properties props;
  spi::LoggerRepositoryPtr repository;
  spi::LoggerFactoryPtr loggerFactory;
};

namespace LOG4CXX_NS
{
namespace xml
{
class XMLWatchdog  : public FileWatchdog
{
  public:
    XMLWatchdog(const File& filename) : FileWatchdog(filename)
    {
    }

    /**
    Call DOMConfigurator#doConfigure with the
    <code>filename</code> to reconfigure log4cxx.
    */
    void doOnChange()
    {
      DOMConfigurator().doConfigure(file(),
        LogManager::getLoggerRepository());
    }
};
}
}
XMLWatchdog* DOMConfigurator::xdog = NULL;


IMPLEMENT_LOG4CXX_OBJECT(DOMConfigurator)

#define CONFIGURATION_TAG "log4j:configuration"
#define OLD_CONFIGURATION_TAG "configuration"
#define APPENDER_TAG "appender"
#define APPENDER_REF_TAG "appender-ref"
#define PARAM_TAG "param"
#define LAYOUT_TAG "layout"
#define ROLLING_POLICY_TAG "rollingPolicy"
#define TRIGGERING_POLICY_TAG "triggeringPolicy"
#define CATEGORY "category"
#define LOGGER "logger"
#define LOGGER_REF "logger-ref"
#define CATEGORY_FACTORY_TAG "categoryFactory"
#define NAME_ATTR "name"
#define CLASS_ATTR "class"
#define VALUE_ATTR "value"
#define ROOT_TAG "root"
#define ROOT_REF "root-ref"
#define LEVEL_TAG "level"
#define PRIORITY_TAG "priority"
#define FILTER_TAG "filter"
#define ERROR_HANDLER_TAG "errorHandler"
#define REF_ATTR "ref"
#define ADDITIVITY_ATTR "additivity"
#define THRESHOLD_ATTR "threshold"
#define STRINGSTREAM_ATTR "stringstream"
#define CONFIG_DEBUG_ATTR "configDebug"
#define INTERNAL_DEBUG_ATTR "debug"
#define THREAD_CONFIG_ATTR "threadConfiguration"

DOMConfigurator::DOMConfigurator()
  : m_priv(std::make_unique<DOMConfiguratorPrivate>())
{
}

DOMConfigurator::~DOMConfigurator() {}

/**
Used internally to parse appenders by IDREF name.
*/
AppenderPtr DOMConfigurator::findAppenderByName(LOG4CXX_NS::helpers::Pool& p,
  LOG4CXX_NS::helpers::CharsetDecoderPtr& utf8Decoder,
  apr_xml_elem* element,
  apr_xml_doc* doc,
  const LogString& appenderName,
  AppenderMap& appenders)
{
  AppenderPtr appender;
  std::string tagName(element->name);

  if (tagName == APPENDER_TAG)
  {
    if (appenderName == getAttribute(utf8Decoder, element, NAME_ATTR))
    {
      appender = parseAppender(p, utf8Decoder, element, doc, appenders);
    }
  }

  if (element->first_child && !appender)
  {
    appender = findAppenderByName(p, utf8Decoder, element->first_child, doc, appenderName, appenders);
  }

  if (element->next && !appender)
  {
    appender = findAppenderByName(p, utf8Decoder, element->next, doc, appenderName, appenders);
  }

  return appender;
}

/**
 Used internally to parse appenders by IDREF element.
*/
AppenderPtr DOMConfigurator::findAppenderByReference(
  LOG4CXX_NS::helpers::Pool& p,
  LOG4CXX_NS::helpers::CharsetDecoderPtr& utf8Decoder,
  apr_xml_elem* appenderRef,
  apr_xml_doc* doc,
  AppenderMap& appenders)
{
  LogString appenderName(subst(getAttribute(utf8Decoder, appenderRef, REF_ATTR)));
  AppenderMap::const_iterator match = appenders.find(appenderName);
  AppenderPtr appender;

  if (match != appenders.end())
  {
    appender = match->second;
  }
  else if (doc)
  {
    appender = findAppenderByName(p, utf8Decoder, doc->root, doc, appenderName, appenders);

    if (appender)
    {
      appenders.insert(AppenderMap::value_type(appenderName, appender));
    }
  }

  if (!appender)
  {
    LogLog::error(LOG4CXX_STR("No appender named [") +
      appenderName + LOG4CXX_STR("] could be found."));
  }

  return appender;
}

/**
Used internally to parse an appender element.
*/
AppenderPtr DOMConfigurator::parseAppender(Pool& p,
  LOG4CXX_NS::helpers::CharsetDecoderPtr& utf8Decoder,
  apr_xml_elem* appenderElement,
  apr_xml_doc* doc,
  AppenderMap& appenders)
{

  LogString className(subst(getAttribute(utf8Decoder, appenderElement, CLASS_ATTR)));
  if (LogLog::isDebugEnabled())
  {
    LogLog::debug(LOG4CXX_STR("Class name: [") + className + LOG4CXX_STR("]"));
  }

  try
  {
    ObjectPtr instance = ObjectPtr(Loader::loadClass(className).newInstance());
    AppenderPtr appender = LOG4CXX_NS::cast<Appender>(instance);
    if(!appender){
      LogLog::error(LOG4CXX_STR("Could not cast class of type [") + className + LOG4CXX_STR("] to appender"));
      return AppenderPtr();
    }
    PropertySetter propSetter(appender);

    appender->setName(subst(getAttribute(utf8Decoder, appenderElement, NAME_ATTR)));

    for (apr_xml_elem* currentElement = appenderElement->first_child;
      currentElement;
      currentElement = currentElement->next)
    {

      std::string tagName(currentElement->name);

      // Parse appender parameters
      if (tagName == PARAM_TAG)
      {
        setParameter(p, utf8Decoder, currentElement, propSetter);
      }
      // Set appender layout
      else if (tagName == LAYOUT_TAG)
      {
        appender->setLayout(parseLayout(p, utf8Decoder, currentElement));
      }
      // Add filters
      else if (tagName == FILTER_TAG)
      {
        std::vector<LOG4CXX_NS::spi::FilterPtr> filters;
        parseFilters(p, utf8Decoder, currentElement, filters);

        for (auto& item : filters)
        {
          appender->addFilter(item);
        }
      }
      else if (tagName == ERROR_HANDLER_TAG)
      {
        parseErrorHandler(p, utf8Decoder, currentElement, appender, doc, appenders);
      }
      else if (tagName == ROLLING_POLICY_TAG)
      {
        RollingPolicyPtr rollPolicy(parseRollingPolicy(p, utf8Decoder, currentElement));
        RollingFileAppenderPtr rfa = LOG4CXX_NS::cast<RollingFileAppender>(appender);

        if (rfa != NULL)
        {
          rfa->setRollingPolicy(rollPolicy);
        }
      }
      else if (tagName == TRIGGERING_POLICY_TAG)
      {
        ObjectPtr policy(parseTriggeringPolicy(p, utf8Decoder, currentElement));
        RollingFileAppenderPtr rfa = LOG4CXX_NS::cast<RollingFileAppender>(appender);
        TriggeringPolicyPtr policyPtr = LOG4CXX_NS::cast<TriggeringPolicy>(policy);

        if (rfa != NULL)
        {
          rfa->setTriggeringPolicy(policyPtr);
        }
        else
        {
          auto smtpa = LOG4CXX_NS::cast<LOG4CXX_NS::net::SMTPAppender>(appender);

          if (smtpa != NULL)
          {
            auto evaluator = LOG4CXX_NS::cast<TriggeringEventEvaluator>(policy);
            smtpa->setEvaluator(evaluator);
          }
        }
      }
      else if (tagName == APPENDER_REF_TAG)
      {
        LogString refName = subst(getAttribute(utf8Decoder, currentElement, REF_ATTR));

        if (!refName.empty() && appender->instanceof(AppenderAttachable::getStaticClass()))
        {
          AppenderAttachablePtr aa = LOG4CXX_NS::cast<AppenderAttachable>(appender);
          if (LogLog::isDebugEnabled())
          {
            LogLog::debug(LOG4CXX_STR("Attaching appender named [") +
              refName + LOG4CXX_STR("] to appender named [") +
              appender->getName() + LOG4CXX_STR("]."));
          }
          aa->addAppender(findAppenderByReference(p, utf8Decoder, currentElement, doc, appenders));
        }
        else if (refName.empty())
        {
          LogLog::error(LOG4CXX_STR("Can't add appender with empty ref attribute"));
        }
        else
        {
          LogLog::error(LOG4CXX_STR("Requesting attachment of appender named [") +
            refName + LOG4CXX_STR("] to appender named [") + appender->getName() +
            LOG4CXX_STR("] which does not implement AppenderAttachable."));
        }
      }
    }

    propSetter.activate(p);
    return appender;
  }
  /* Yes, it's ugly.  But all of these exceptions point to the same
      problem: we can't create an Appender */
  catch (Exception& oops)
  {
    LogLog::error(LOG4CXX_STR("Could not create an Appender. Reported error follows."),
      oops);
    return 0;
  }
}

/**
Used internally to parse an {@link ErrorHandler} element.
*/
void DOMConfigurator::parseErrorHandler(Pool& p,
  LOG4CXX_NS::helpers::CharsetDecoderPtr& utf8Decoder,
  apr_xml_elem* element,
  AppenderPtr& appender,
  apr_xml_doc* doc,
  AppenderMap& appenders)
{

  ErrorHandlerPtr eh;
  std::shared_ptr<Object> obj = OptionConverter::instantiateByClassName(
      subst(getAttribute(utf8Decoder, element, CLASS_ATTR)),
      ErrorHandler::getStaticClass(),
      0);
  eh = LOG4CXX_NS::cast<ErrorHandler>(obj);

  if (eh != 0)
  {
    eh->setAppender(appender);

    PropertySetter propSetter(eh);

    for (apr_xml_elem* currentElement = element->first_child;
      currentElement;
      currentElement = currentElement->next)
    {
      std::string tagName(currentElement->name);

      if (tagName == PARAM_TAG)
      {
        setParameter(p, utf8Decoder, currentElement, propSetter);
      }
      else if (tagName == APPENDER_REF_TAG)
      {
        eh->setBackupAppender(findAppenderByReference(p, utf8Decoder, currentElement, doc, appenders));
      }
      else if (tagName == LOGGER_REF)
      {
        LogString loggerName(getAttribute(utf8Decoder, currentElement, REF_ATTR));
        LoggerPtr logger = m_priv->repository->getLogger(loggerName, m_priv->loggerFactory);
        eh->setLogger(logger);
      }
      else if (tagName == ROOT_REF)
      {
        LoggerPtr root = m_priv->repository->getRootLogger();
        eh->setLogger(root);
      }
    }

    propSetter.activate(p);
    std::shared_ptr<AppenderSkeleton> appSkeleton = LOG4CXX_NS::cast<AppenderSkeleton>(appender);

    if (appSkeleton != 0)
    {
      appSkeleton->setErrorHandler(eh);
    }
  }
}

/**
 Used internally to parse a filter element.
*/
void DOMConfigurator::parseFilters(Pool& p,
  LOG4CXX_NS::helpers::CharsetDecoderPtr& utf8Decoder,
  apr_xml_elem* element,
  std::vector<LOG4CXX_NS::spi::FilterPtr>& filters)
{
  LogString clazz = subst(getAttribute(utf8Decoder, element, CLASS_ATTR));
  FilterPtr filter;
  std::shared_ptr<Object> obj = OptionConverter::instantiateByClassName(clazz,
      Filter::getStaticClass(), 0);
  filter = LOG4CXX_NS::cast<Filter>(obj);

  if (filter != 0)
  {
    PropertySetter propSetter(filter);

    for (apr_xml_elem* currentElement = element->first_child;
      currentElement;
      currentElement = currentElement->next)
    {
      std::string tagName(currentElement->name);

      if (tagName == PARAM_TAG)
      {
        setParameter(p, utf8Decoder, currentElement, propSetter);
      }
    }

    propSetter.activate(p);
    filters.push_back(filter);
  }
}

/**
Used internally to parse an category or logger element.
*/
void DOMConfigurator::parseLogger(
  LOG4CXX_NS::helpers::Pool& p,
  LOG4CXX_NS::helpers::CharsetDecoderPtr& utf8Decoder,
  apr_xml_elem* loggerElement,
  apr_xml_doc* doc,
  AppenderMap& appenders)
{
  // Create a new Logger object from the <category> element.
  LogString loggerName = subst(getAttribute(utf8Decoder, loggerElement, NAME_ATTR));

  if (LogLog::isDebugEnabled())
  {
    LogLog::debug(LOG4CXX_STR("Retreiving an instance of ") + loggerName);
  }
  LoggerPtr logger = m_priv->repository->getLogger(loggerName, m_priv->loggerFactory);

  // Setting up a logger needs to be an atomic operation, in order
  // to protect potential log operations while logger
  // configuration is in progress.
  bool additivity = OptionConverter::toBoolean(
      subst(getAttribute(utf8Decoder, loggerElement, ADDITIVITY_ATTR)),
      true);

  if (LogLog::isDebugEnabled())
  {
    LogLog::debug(LOG4CXX_STR("Setting [") + logger->getName() + LOG4CXX_STR("] additivity to [") +
      (additivity ? LogString(LOG4CXX_STR("true")) : LogString(LOG4CXX_STR("false"))) + LOG4CXX_STR("]."));
  }
  logger->setAdditivity(additivity);
  parseChildrenOfLoggerElement(p, utf8Decoder, loggerElement, logger, false, doc, appenders);
}

/**
 Used internally to parse the logger factory element.
*/
void DOMConfigurator::parseLoggerFactory(
  LOG4CXX_NS::helpers::Pool& p,
  LOG4CXX_NS::helpers::CharsetDecoderPtr& utf8Decoder,
  apr_xml_elem* factoryElement)
{
  LogString className(subst(getAttribute(utf8Decoder, factoryElement, CLASS_ATTR)));

  if (className.empty())
  {
    LogLog::error(LOG4CXX_STR("Logger Factory tag class attribute not found."));
  }
  else
  {
    if (LogLog::isDebugEnabled())
    {
      LogLog::debug(LOG4CXX_STR("Desired logger factory: [") + className + LOG4CXX_STR("]"));
    }
    std::shared_ptr<Object> obj = OptionConverter::instantiateByClassName(
        className,
        LoggerFactory::getStaticClass(),
        0);
    m_priv->loggerFactory = LOG4CXX_NS::cast<LoggerFactory>(obj);
    PropertySetter propSetter(m_priv->loggerFactory);

    for (apr_xml_elem* currentElement = factoryElement->first_child;
      currentElement;
      currentElement = currentElement->next)
    {
      std::string tagName(currentElement->name);

      if (tagName == PARAM_TAG)
      {
        setParameter(p, utf8Decoder, currentElement, propSetter);
      }
    }
  }
}

/**
 Used internally to parse the root logger element.
*/
void DOMConfigurator::parseRoot(
  LOG4CXX_NS::helpers::Pool& p,
  LOG4CXX_NS::helpers::CharsetDecoderPtr& utf8Decoder,
  apr_xml_elem* rootElement,
  apr_xml_doc* doc,
  AppenderMap& appenders)
{
  LoggerPtr root = m_priv->repository->getRootLogger();
  parseChildrenOfLoggerElement(p, utf8Decoder, rootElement, root, true, doc, appenders);
}

/**
 Used internally to parse the children of a logger element.
*/
void DOMConfigurator::parseChildrenOfLoggerElement(
  LOG4CXX_NS::helpers::Pool& p,
  LOG4CXX_NS::helpers::CharsetDecoderPtr& utf8Decoder,
  apr_xml_elem* loggerElement, LoggerPtr logger, bool isRoot,
  apr_xml_doc* doc,
  AppenderMap& appenders)
{
  PropertySetter propSetter(logger);
  std::vector<AppenderPtr> newappenders;

  for (apr_xml_elem* currentElement = loggerElement->first_child;
    currentElement;
    currentElement = currentElement->next)
  {
    std::string tagName(currentElement->name);

    if (tagName == APPENDER_REF_TAG)
    {
      AppenderPtr appender = findAppenderByReference(p, utf8Decoder, currentElement, doc, appenders);
      LogString refName =  subst(getAttribute(utf8Decoder, currentElement, REF_ATTR));

      if (appender)
      {
        if (LogLog::isDebugEnabled())
          LogLog::debug(LOG4CXX_STR("Adding appender named [") + refName +
            LOG4CXX_STR("] to logger [") + logger->getName() + LOG4CXX_STR("]."));
        newappenders.push_back(appender);
      }
      else
      {
        LogLog::debug(LOG4CXX_STR("Appender named [") + refName +
          LOG4CXX_STR("] not found."));
      }

    }
    else if (tagName == LEVEL_TAG)
    {
      parseLevel(p, utf8Decoder, currentElement, logger, isRoot);
    }
    else if (tagName == PRIORITY_TAG)
    {
      parseLevel(p, utf8Decoder, currentElement, logger, isRoot);
    }
    else if (tagName == PARAM_TAG)
    {
      setParameter(p, utf8Decoder, currentElement, propSetter);
    }
  }
  if (newappenders.empty())
    logger->removeAllAppenders();
  else
    logger->replaceAppenders(newappenders);

  propSetter.activate(p);
}

/**
 Used internally to parse a layout element.
*/
LayoutPtr DOMConfigurator::parseLayout (
  LOG4CXX_NS::helpers::Pool& p,
  LOG4CXX_NS::helpers::CharsetDecoderPtr& utf8Decoder,
  apr_xml_elem* layout_element)
{
  LogString className(subst(getAttribute(utf8Decoder, layout_element, CLASS_ATTR)));
  if (LogLog::isDebugEnabled())
  {
    LogLog::debug(LOG4CXX_STR("Parsing layout of class: \"") + className + LOG4CXX_STR("\""));
  }

  try
  {
    ObjectPtr instance = ObjectPtr(Loader::loadClass(className).newInstance());
    LayoutPtr layout = LOG4CXX_NS::cast<Layout>(instance);
    PropertySetter propSetter(layout);

    for (apr_xml_elem* currentElement = layout_element->first_child;
      currentElement;
      currentElement = currentElement->next)
    {
      std::string tagName(currentElement->name);

      if (tagName == PARAM_TAG)
      {
        setParameter(p, utf8Decoder, currentElement, propSetter);
      }
    }

    propSetter.activate(p);
    return layout;
  }
  catch (Exception& oops)
  {
    LogLog::error(LOG4CXX_STR("Could not create the Layout. Reported error follows."),
      oops);
    return 0;
  }
}

/**
 Used internally to parse a triggering policy
*/
ObjectPtr DOMConfigurator::parseTriggeringPolicy (
  LOG4CXX_NS::helpers::Pool& p,
  LOG4CXX_NS::helpers::CharsetDecoderPtr& utf8Decoder,
  apr_xml_elem* layout_element)
{
  LogString className = subst(getAttribute(utf8Decoder, layout_element, CLASS_ATTR));
  if (LogLog::isDebugEnabled())
  {
    LogLog::debug(LOG4CXX_STR("Parsing triggering policy of class: \"") + className + LOG4CXX_STR("\""));
  }

  try
  {
    ObjectPtr instance = ObjectPtr(Loader::loadClass(className).newInstance());
    PropertySetter propSetter(instance);

    for (apr_xml_elem* currentElement = layout_element->first_child;
      currentElement;
      currentElement = currentElement->next)
    {
      std::string tagName(currentElement->name);

      if (tagName == PARAM_TAG)
      {
        setParameter(p, utf8Decoder, currentElement, propSetter);
      }
      else if (tagName == FILTER_TAG)
      {
        std::vector<LOG4CXX_NS::spi::FilterPtr> filters;
        parseFilters(p, utf8Decoder, currentElement, filters);
        FilterBasedTriggeringPolicyPtr fbtp = LOG4CXX_NS::cast<FilterBasedTriggeringPolicy>(instance);

        if (fbtp != NULL)
        {
          for (auto& item : filters)
          {
            fbtp->addFilter(item);
          }
        }
      }
    }

    propSetter.activate(p);
    return instance;
  }
  catch (Exception& oops)
  {
    LogLog::error(LOG4CXX_STR("Could not create the TriggeringPolicy. Reported error follows."),
      oops);
    return 0;
  }
}

/**
 Used internally to parse a triggering policy
*/
RollingPolicyPtr DOMConfigurator::parseRollingPolicy (
  LOG4CXX_NS::helpers::Pool& p,
  LOG4CXX_NS::helpers::CharsetDecoderPtr& utf8Decoder,
  apr_xml_elem* layout_element)
{
  LogString className = subst(getAttribute(utf8Decoder, layout_element, CLASS_ATTR));
  if (LogLog::isDebugEnabled())
  {
    LogLog::debug(LOG4CXX_STR("Parsing rolling policy of class: \"") + className + LOG4CXX_STR("\""));
  }

  try
  {
    ObjectPtr instance = ObjectPtr(Loader::loadClass(className).newInstance());
    RollingPolicyPtr layout = LOG4CXX_NS::cast<RollingPolicy>(instance);
    PropertySetter propSetter(layout);

    for (apr_xml_elem* currentElement = layout_element->first_child;
      currentElement;
      currentElement = currentElement->next)
    {
      std::string tagName(currentElement->name);

      if (tagName == PARAM_TAG)
      {
        setParameter(p, utf8Decoder, currentElement, propSetter);
      }
    }

    propSetter.activate(p);
    return layout;
  }
  catch (Exception& oops)
  {
    LogLog::error(LOG4CXX_STR("Could not create the RollingPolicy. Reported error follows."),
      oops);
    return 0;
  }
}



/**
 Used internally to parse a level  element.
*/
void DOMConfigurator::parseLevel(
  LOG4CXX_NS::helpers::Pool& p,
  LOG4CXX_NS::helpers::CharsetDecoderPtr& utf8Decoder,
  apr_xml_elem* element, LoggerPtr logger, bool isRoot)
{
  LogString loggerName = logger->getName();

  if (isRoot)
  {
    loggerName = LOG4CXX_STR("root");
  }

  LogString levelStr(subst(getAttribute(utf8Decoder, element, VALUE_ATTR)));
  if (LogLog::isDebugEnabled())
  {
    LogLog::debug(LOG4CXX_STR("Level value for ") + loggerName + LOG4CXX_STR(" is [") + levelStr + LOG4CXX_STR("]."));
  }

  if (StringHelper::equalsIgnoreCase(levelStr, LOG4CXX_STR("INHERITED"), LOG4CXX_STR("inherited"))
    || StringHelper::equalsIgnoreCase(levelStr, LOG4CXX_STR("NULL"), LOG4CXX_STR("null")))
  {
    if (isRoot)
    {
      LogLog::error(LOG4CXX_STR("Root level cannot be inherited. Ignoring directive."));
    }
    else
    {
      logger->setLevel(0);
    }
  }
  else
  {
    LogString className(subst(getAttribute(utf8Decoder, element, CLASS_ATTR)));

    if (className.empty())
    {
      logger->setLevel(OptionConverter::toLevel(levelStr, Level::getDebug()));
    }
    else
    {
      if (LogLog::isDebugEnabled())
      {
        LogLog::debug(LOG4CXX_STR("Desired Level sub-class: [") + className + LOG4CXX_STR("]"));
      }

      try
      {
        Level::LevelClass& levelClass =
          (Level::LevelClass&)Loader::loadClass(className);
        LevelPtr level = levelClass.toLevel(levelStr);
        logger->setLevel(level);
      }
      catch (Exception& oops)
      {
        LogLog::error(
          LOG4CXX_STR("Could not create level [") + levelStr +
          LOG4CXX_STR("]. Reported error follows."),
          oops);

        return;
      }
      catch (...)
      {
        LogLog::error(
          LOG4CXX_STR("Could not create level [") + levelStr);

        return;
      }
    }
  }

  if (LogLog::isDebugEnabled())
  {
    LogLog::debug(loggerName + LOG4CXX_STR(" level set to ") +
      logger->getEffectiveLevel()->toString());
  }
}

void DOMConfigurator::setParameter(LOG4CXX_NS::helpers::Pool& p,
  LOG4CXX_NS::helpers::CharsetDecoderPtr& utf8Decoder,
  apr_xml_elem* elem,
  PropertySetter& propSetter)
{
  LogString name(subst(getAttribute(utf8Decoder, elem, NAME_ATTR)));
  LogString value(subst(getAttribute(utf8Decoder, elem, VALUE_ATTR)));
  value = subst(value);
  propSetter.setProperty(name, value, p);
}

spi::ConfigurationStatus DOMConfigurator::doConfigure
  ( const File&                     filename
#if LOG4CXX_ABI_VERSION <= 15
  , spi::LoggerRepositoryPtr        repository
#else
  , const spi::LoggerRepositoryPtr& repository
#endif
  )
{
  m_priv->repository = repository ? repository : LogManager::getLoggerRepository();
  m_priv->repository->setConfigured(true);
  if (LogLog::isDebugEnabled())
  {
    LogString msg(LOG4CXX_STR("DOMConfigurator configuring file "));
    msg.append(filename.getPath());
    msg.append(LOG4CXX_STR("..."));
    LogLog::debug(msg);
  }

#if LOG4CXX_ABI_VERSION <= 15
  m_priv->loggerFactory = std::make_shared<DefaultLoggerFactory>();
#else
  m_priv->loggerFactory = std::make_shared<LoggerFactory>();
#endif

  Pool p;
  apr_file_t* fd;

  log4cxx_status_t rv = filename.open(&fd, APR_READ, APR_OS_DEFAULT, p);

  if (rv != APR_SUCCESS)
  {
    // There is not technically an exception thrown here, but this behavior matches
    // what the PropertyConfigurator does
    IOException io(rv);
    LogString msg2(LOG4CXX_STR("Could not read configuration file ["));
    msg2.append(filename.getPath());
    msg2.append(LOG4CXX_STR("]. "));
    LOG4CXX_DECODE_CHAR(msg, io.what());
    msg2.append(msg);
    LogLog::error(msg2);
    return spi::ConfigurationStatus::NotConfigured;
  }
  else
  {
    apr_xml_parser* parser = NULL;
    apr_xml_doc* doc = NULL;

    if (LogLog::isDebugEnabled())
    {
      LogString debugMsg = LOG4CXX_STR("Loading configuration file [")
          + filename.getPath() + LOG4CXX_STR("].");
      LogLog::debug(debugMsg);
    }

    rv = apr_xml_parse_file(p.getAPRPool(), &parser, &doc, fd, 2000);

    if (rv != APR_SUCCESS)
    {
      char errbuf[2000];
      char errbufXML[2000];
      LogString msg2(LOG4CXX_STR("Error parsing file ["));
      msg2.append(filename.getPath());
      msg2.append(LOG4CXX_STR("], "));
      apr_strerror(rv, errbuf, sizeof(errbuf));
      LOG4CXX_DECODE_CHAR(lerrbuf, std::string(errbuf));
      msg2.append(lerrbuf);

      if (parser)
      {
        apr_xml_parser_geterror(parser, errbufXML, sizeof(errbufXML));
        LOG4CXX_DECODE_CHAR(lerrbufXML, std::string(errbufXML));
        msg2.append(lerrbufXML);
      }

      LogLog::error(msg2);
      return spi::ConfigurationStatus::NotConfigured;
    }
    else
    {
      AppenderMap appenders;
      CharsetDecoderPtr utf8Decoder(CharsetDecoder::getUTF8Decoder());
      parse(p, utf8Decoder, doc->root, doc, appenders);
    }
  }

  return spi::ConfigurationStatus::Configured;
}

// Read configuration options from \c filename.
spi::ConfigurationStatus DOMConfigurator::configure(const File& filename)
{
  return DOMConfigurator().doConfigure(filename, LogManager::getLoggerRepository());
}

#if LOG4CXX_ABI_VERSION <= 15
spi::ConfigurationStatus DOMConfigurator::configure(const std::string& filename)
{
  File file(filename);
  return DOMConfigurator().doConfigure(file, LogManager::getLoggerRepository());
}

#if LOG4CXX_WCHAR_T_API
spi::ConfigurationStatus DOMConfigurator::configure(const std::wstring& filename)
{
  File file(filename);
  return DOMConfigurator().doConfigure(file, LogManager::getLoggerRepository());
}
#endif

#if LOG4CXX_UNICHAR_API || LOG4CXX_LOGCHAR_IS_UNICHAR
spi::ConfigurationStatus DOMConfigurator::configure(const std::basic_string<UniChar>& filename)
{
  File file(filename);
  return DOMConfigurator().doConfigure(file, LogManager::getLoggerRepository());
}
#endif

#if LOG4CXX_CFSTRING_API
spi::ConfigurationStatus DOMConfigurator::configure(const CFStringRef& filename)
{
  File file(filename);
  return DOMConfigurator().doConfigure(file, LogManager::getLoggerRepository());
}
#endif


spi::ConfigurationStatus DOMConfigurator::configureAndWatch(const std::string& filename)
{
  return configureAndWatch(filename, FileWatchdog::DEFAULT_DELAY);
}

#if LOG4CXX_WCHAR_T_API
spi::ConfigurationStatus DOMConfigurator::configureAndWatch(const std::wstring& filename)
{
  return configureAndWatch(filename, FileWatchdog::DEFAULT_DELAY);
}
#endif

#if LOG4CXX_UNICHAR_API || LOG4CXX_LOGCHAR_IS_UNICHAR
spi::ConfigurationStatus DOMConfigurator::configureAndWatch(const std::basic_string<UniChar>& filename)
{
  return configureAndWatch(filename, FileWatchdog::DEFAULT_DELAY);
}
#endif

#if LOG4CXX_CFSTRING_API
spi::ConfigurationStatus DOMConfigurator::configureAndWatch(const CFStringRef& filename)
{
  return configureAndWatch(filename, FileWatchdog::DEFAULT_DELAY);
}
#endif

spi::ConfigurationStatus DOMConfigurator::configureAndWatch(const std::string& filename, long delay)
{
  return configureAndWatch(File(filename), delay);
}
#endif // LOG4CXX_ABI_VERSION <= 15

spi::ConfigurationStatus DOMConfigurator::configureAndWatch(const File& file, long delay)
{
  if ( xdog )
  {
    APRInitializer::unregisterCleanup(xdog);
    delete xdog;
  }

  spi::ConfigurationStatus status = DOMConfigurator().doConfigure(file, LogManager::getLoggerRepository());

  xdog = new XMLWatchdog(file);
  APRInitializer::registerCleanup(xdog);
  xdog->setDelay(0 < delay ? delay : FileWatchdog::DEFAULT_DELAY);
  xdog->start();

  return status;
}

#if LOG4CXX_ABI_VERSION <= 15
#if LOG4CXX_WCHAR_T_API
spi::ConfigurationStatus DOMConfigurator::configureAndWatch(const std::wstring& filename, long delay)
{
  File file(filename);
  if ( xdog )
  {
    APRInitializer::unregisterCleanup(xdog);
    delete xdog;
  }

  spi::ConfigurationStatus status = DOMConfigurator().doConfigure(file, LogManager::getLoggerRepository());

  xdog = new XMLWatchdog(file);
  APRInitializer::registerCleanup(xdog);
  xdog->setDelay(delay);
  xdog->start();

  return status;
}
#endif

#if LOG4CXX_UNICHAR_API || LOG4CXX_LOGCHAR_IS_UNICHAR
spi::ConfigurationStatus DOMConfigurator::configureAndWatch(const std::basic_string<UniChar>& filename, long delay)
{
  File file(filename);
  if ( xdog )
  {
    APRInitializer::unregisterCleanup(xdog);
    delete xdog;
  }

  spi::ConfigurationStatus status = DOMConfigurator().doConfigure(file, LogManager::getLoggerRepository());

  xdog = new XMLWatchdog(file);
  APRInitializer::registerCleanup(xdog);
  xdog->setDelay(delay);
  xdog->start();

  return status;
}
#endif

#if LOG4CXX_CFSTRING_API
spi::ConfigurationStatus DOMConfigurator::configureAndWatch(const CFStringRef& filename, long delay)
{
  File file(filename);
  if ( xdog )
  {
    APRInitializer::unregisterCleanup(xdog);
    delete xdog;
  }

  spi::ConfigurationStatus status = DOMConfigurator().doConfigure(file, LogManager::getLoggerRepository());

  xdog = new XMLWatchdog(file);
  APRInitializer::registerCleanup(xdog);
  xdog->setDelay(delay);
  xdog->start();

  return status;
}
#endif
#endif // LOG4CXX_ABI_VERSION <= 15

void DOMConfigurator::parse(
  Pool& p,
  LOG4CXX_NS::helpers::CharsetDecoderPtr& utf8Decoder,
  apr_xml_elem* element,
  apr_xml_doc* doc,
  AppenderMap& appenders)
{
  std::string rootElementName(element->name);

  if (rootElementName != CONFIGURATION_TAG)
  {
    if (rootElementName == OLD_CONFIGURATION_TAG)
    {
      //LogLog::warn(LOG4CXX_STR("The <")+String(OLD_CONFIGURATION_TAG)+
      // LOG4CXX_STR("> element has been deprecated."));
      //LogLog::warn(LOG4CXX_STR("Use the <")+String(CONFIGURATION_TAG)+
      // LOG4CXX_STR("> element instead."));
    }
    else
    {
      LogLog::error(LOG4CXX_STR("DOM element is - not a <configuration> element."));
      return;
    }
  }

  LogString debugAttrib = subst(getAttribute(utf8Decoder, element, INTERNAL_DEBUG_ATTR));

  static const WideLife<LogString> NULL_STRING(LOG4CXX_STR("NULL"));
  if (LogLog::isDebugEnabled())
  {
    LogLog::debug(LOG4CXX_STR("debug attribute= \"") + debugAttrib + LOG4CXX_STR("\"."));
  }

  // if the log4j.dtd is not specified in the XML file, then the
  // "debug" attribute is returned as the empty string.
  if (!debugAttrib.empty() && debugAttrib != NULL_STRING.value())
  {
    LogLog::setInternalDebugging(OptionConverter::toBoolean(debugAttrib, true));
  }
  else if (LogLog::isDebugEnabled())
  {
    LogLog::debug(LOG4CXX_STR("Ignoring internalDebug attribute."));
  }


  LogString confDebug = subst(getAttribute(utf8Decoder, element, CONFIG_DEBUG_ATTR));

  if (!confDebug.empty() && confDebug != NULL_STRING.value())
  {
    LogLog::warn(LOG4CXX_STR("The \"configDebug\" attribute is deprecated."));
    LogLog::warn(LOG4CXX_STR("Use the \"internalDebug\" attribute instead."));
    LogLog::setInternalDebugging(OptionConverter::toBoolean(confDebug, true));
  }

  LogString thresholdStr = subst(getAttribute(utf8Decoder, element, THRESHOLD_ATTR));
  if (LogLog::isDebugEnabled())
  {
    LogLog::debug(LOG4CXX_STR("Threshold =\"") + thresholdStr + LOG4CXX_STR("\"."));
  }

  if (!thresholdStr.empty() && thresholdStr != NULL_STRING.value())
  {
    m_priv->repository->setThreshold(thresholdStr);
  }

  LogString threadSignalValue = subst(getAttribute(utf8Decoder, element, THREAD_CONFIG_ATTR));

  if ( !threadSignalValue.empty() && threadSignalValue != NULL_STRING.value() )
  {
    if ( threadSignalValue == LOG4CXX_STR("NoConfiguration") )
    {
      helpers::ThreadUtility::configure( ThreadConfigurationType::NoConfiguration );
    }
    else if ( threadSignalValue == LOG4CXX_STR("BlockSignalsOnly") )
    {
      helpers::ThreadUtility::configure( ThreadConfigurationType::BlockSignalsOnly );
    }
    else if ( threadSignalValue == LOG4CXX_STR("NameThreadOnly") )
    {
      helpers::ThreadUtility::configure( ThreadConfigurationType::NameThreadOnly );
    }
    else if ( threadSignalValue == LOG4CXX_STR("BlockSignalsAndNameThread") )
    {
      helpers::ThreadUtility::configure( ThreadConfigurationType::BlockSignalsAndNameThread );
    }
  }

  apr_xml_elem* currentElement;

  for (currentElement = element->first_child;
    currentElement;
    currentElement = currentElement->next)
  {
    std::string tagName(currentElement->name);

    if (tagName == CATEGORY_FACTORY_TAG)
    {
      parseLoggerFactory(p, utf8Decoder, currentElement);
    }
  }

  for (currentElement = element->first_child;
    currentElement;
    currentElement = currentElement->next)
  {
    std::string tagName(currentElement->name);

    if (tagName == CATEGORY || tagName == LOGGER)
    {
      parseLogger(p, utf8Decoder, currentElement, doc, appenders);
    }
    else if (tagName == ROOT_TAG)
    {
      parseRoot(p, utf8Decoder, currentElement, doc, appenders);
    }
  }
}

LogString DOMConfigurator::subst(const LogString& value)
{
  try
  {
    return OptionConverter::substVars(value, m_priv->props);
  }
  catch (IllegalArgumentException& e)
  {
    LogLog::warn(LOG4CXX_STR("Could not perform variable substitution."), e);
    return value;
  }
}


LogString DOMConfigurator::getAttribute(
  LOG4CXX_NS::helpers::CharsetDecoderPtr& utf8Decoder,
  apr_xml_elem* element,
  const std::string& attrName)
{
  LogString attrValue;

  for (apr_xml_attr* attr = element->attr;
    attr;
    attr = attr->next)
  {
    if (attrName == attr->name)
    {
      ByteBuffer buf((char*) attr->value, strnlen_s(attr->value, MAX_ATTRIBUTE_NAME_LEN));
      utf8Decoder->decode(buf, attrValue);
    }
  }

  return attrValue;
}

Coverage Report

Created: 2025-07-01 06:08