Skip to content

Commit

Permalink
ongoing work on model based configuration
Browse files Browse the repository at this point in the history
  • Loading branch information
ceki committed Mar 5, 2019
1 parent a03d70e commit 40af71d
Show file tree
Hide file tree
Showing 9 changed files with 239 additions and 144 deletions.
Expand Up @@ -13,11 +13,24 @@
*/
package ch.qos.logback.classic.joran;

import ch.qos.logback.classic.joran.action.*;
import ch.qos.logback.classic.joran.action.ConfigurationAction;
import ch.qos.logback.classic.joran.action.ConsolePluginAction;
import ch.qos.logback.classic.joran.action.ContextNameAction;
import ch.qos.logback.classic.joran.action.EvaluatorAction;
import ch.qos.logback.classic.joran.action.InsertFromJNDIAction;
import ch.qos.logback.classic.joran.action.JMXConfiguratorAction;
import ch.qos.logback.classic.joran.action.LevelAction;
import ch.qos.logback.classic.joran.action.LoggerAction;
import ch.qos.logback.classic.joran.action.LoggerContextListenerAction;
import ch.qos.logback.classic.joran.action.ReceiverAction;
import ch.qos.logback.classic.joran.action.RootLoggerAction;
import ch.qos.logback.classic.model.ConfigurationModel;
import ch.qos.logback.classic.model.processor.ConfigurationModelHandler;
import ch.qos.logback.classic.sift.SiftAction;
import ch.qos.logback.classic.spi.ILoggingEvent;
import ch.qos.logback.classic.spi.PlatformInfo;
import ch.qos.logback.classic.util.DefaultNestedComponentRules;
import ch.qos.logback.core.Context;
import ch.qos.logback.core.joran.JoranConfiguratorBase;
import ch.qos.logback.core.joran.action.AppenderRefAction;
import ch.qos.logback.core.joran.action.IncludeAction;
Expand All @@ -27,7 +40,9 @@
import ch.qos.logback.core.joran.conditional.ThenAction;
import ch.qos.logback.core.joran.spi.DefaultNestedComponentRegistry;
import ch.qos.logback.core.joran.spi.ElementSelector;
import ch.qos.logback.core.joran.spi.InterpretationContext;
import ch.qos.logback.core.joran.spi.RuleStore;
import ch.qos.logback.core.model.processor.DefaultProcessor;

/**
* JoranConfigurator class adds rules specific to logback-classic.
Expand Down Expand Up @@ -84,5 +99,12 @@ public void addInstanceRules(RuleStore rs) {
protected void addDefaultNestedComponentRegistryRules(DefaultNestedComponentRegistry registry) {
DefaultNestedComponentRules.addDefaultNestedComponentRegistryRules(registry);
}

@Override
protected DefaultProcessor buildDefaultProcessor(Context context, InterpretationContext interpretationContext) {
DefaultProcessor defaultProcessor = super.buildDefaultProcessor(context, interpretationContext);
defaultProcessor.addHandler(ConfigurationModel.class, ConfigurationModelHandler.class);
return defaultProcessor;
}

}
Expand Up @@ -13,133 +13,33 @@
*/
package ch.qos.logback.classic.joran.action;

import java.net.URL;
import java.util.concurrent.ScheduledExecutorService;
import java.util.concurrent.ScheduledFuture;
import java.util.concurrent.TimeUnit;

import org.xml.sax.Attributes;

import ch.qos.logback.classic.LoggerContext;
import ch.qos.logback.classic.joran.ReconfigureOnChangeTask;
import ch.qos.logback.classic.util.EnvUtil;
import ch.qos.logback.core.CoreConstants;
import ch.qos.logback.classic.model.ConfigurationModel;
import ch.qos.logback.core.joran.action.Action;
import ch.qos.logback.core.joran.spi.InterpretationContext;
import ch.qos.logback.core.joran.util.ConfigurationWatchListUtil;
import ch.qos.logback.core.status.OnConsoleStatusListener;
import ch.qos.logback.core.util.ContextUtil;
import ch.qos.logback.core.util.Duration;
import ch.qos.logback.core.util.OptionHelper;
import ch.qos.logback.core.util.StatusListenerConfigHelper;

public class ConfigurationAction extends Action {
static final String INTERNAL_DEBUG_ATTR = "debug";
static final String PACKAGING_DATA_ATTR = "packagingData";
static final String SCAN_ATTR = "scan";
static final String SCAN_PERIOD_ATTR = "scanPeriod";
static final String DEBUG_SYSTEM_PROPERTY_KEY = "logback.debug";
static final Duration SCAN_PERIOD_DEFAULT = Duration.buildByMinutes(1);

long threshold = 0;

public void begin(InterpretationContext ic, String name, Attributes attributes) {
threshold = System.currentTimeMillis();

// See LOGBACK-527 (the system property is looked up first. Thus, it overrides
// the equivalent property in the config file. This reversal of scope priority is justified
// by the use case: the admin trying to chase rogue config file
String debugAttrib = getSystemProperty(DEBUG_SYSTEM_PROPERTY_KEY);
if (debugAttrib == null) {
debugAttrib = ic.subst(attributes.getValue(INTERNAL_DEBUG_ATTR));
}

if (OptionHelper.isEmpty(debugAttrib) || debugAttrib.equalsIgnoreCase("false") || debugAttrib.equalsIgnoreCase("null")) {
addInfo(INTERNAL_DEBUG_ATTR + " attribute not set");
} else {
StatusListenerConfigHelper.addOnConsoleListenerInstance(context, new OnConsoleStatusListener());
}

processScanAttrib(ic, attributes);

LoggerContext lc = (LoggerContext) context;
boolean packagingData = OptionHelper.toBoolean(ic.subst(attributes.getValue(PACKAGING_DATA_ATTR)), LoggerContext.DEFAULT_PACKAGING_DATA);
lc.setPackagingDataEnabled(packagingData);

if (EnvUtil.isGroovyAvailable()) {
ContextUtil contextUtil = new ContextUtil(context);
contextUtil.addGroovyPackages(lc.getFrameworkPackages());
}

// the context is turbo filter attachable, so it is pushed on top of the
// stack
ic.pushObject(getContext());
}

String getSystemProperty(String name) {
/*
* LOGBACK-743: accessing a system property in the presence of a SecurityManager (e.g. applet sandbox) can
* result in a SecurityException.
*/
try {
return System.getProperty(name);
} catch (SecurityException ex) {
return null;
}
}

void processScanAttrib(InterpretationContext ic, Attributes attributes) {
String scanAttrib = ic.subst(attributes.getValue(SCAN_ATTR));
if (!OptionHelper.isEmpty(scanAttrib) && !"false".equalsIgnoreCase(scanAttrib)) {

ScheduledExecutorService scheduledExecutorService = context.getScheduledExecutorService();
URL mainURL = ConfigurationWatchListUtil.getMainWatchURL(context);
if (mainURL == null) {
addWarn("Due to missing top level configuration file, reconfiguration on change (configuration file scanning) cannot be done.");
return;
}
ReconfigureOnChangeTask rocTask = new ReconfigureOnChangeTask();
rocTask.setContext(context);

context.putObject(CoreConstants.RECONFIGURE_ON_CHANGE_TASK, rocTask);

String scanPeriodAttrib = ic.subst(attributes.getValue(SCAN_PERIOD_ATTR));
Duration duration = getDurationOfScanPeriodAttribute(scanPeriodAttrib, SCAN_PERIOD_DEFAULT);

addInfo("Will scan for changes in [" + mainURL + "] ");
// Given that included files are encountered at a later phase, the complete list of files
// to scan can only be determined when the configuration is loaded in full.
// However, scan can be active if mainURL is set. Otherwise, when changes are detected
// the top level config file cannot be accessed.
addInfo("Setting ReconfigureOnChangeTask scanning period to " + duration);

ScheduledFuture<?> scheduledFuture = scheduledExecutorService.scheduleAtFixedRate(rocTask, duration.getMilliseconds(), duration.getMilliseconds(),
TimeUnit.MILLISECONDS);
context.addScheduledFuture(scheduledFuture);
}
}
static final String PACKAGING_DATA_ATTR = "packagingData";

private Duration getDurationOfScanPeriodAttribute(String scanPeriodAttrib, Duration defaultDuration) {
Duration duration = null;

public void begin(InterpretationContext interpretationContext, String name, Attributes attributes) {

if (!OptionHelper.isEmpty(scanPeriodAttrib)) {
try {
duration = Duration.valueOf(scanPeriodAttrib);
} catch(IllegalStateException|IllegalArgumentException e) {
addWarn("Failed to parse 'scanPeriod' attribute ["+scanPeriodAttrib+"]", e);
// default duration will be set below
}
}
ConfigurationModel configurationModel = new ConfigurationModel();
configurationModel.setDebugStr(attributes.getValue(INTERNAL_DEBUG_ATTR));
configurationModel.setScanStr(attributes.getValue(SCAN_ATTR));
configurationModel.setScanPeriodStr(attributes.getValue(SCAN_PERIOD_ATTR));
configurationModel.setPackagingDataStr(attributes.getValue(PACKAGING_DATA_ATTR));

if(duration == null) {
addInfo("No 'scanPeriod' specified. Defaulting to " + defaultDuration.toString());
duration = defaultDuration;
}
return duration;
interpretationContext.pushObject(configurationModel);
}


public void end(InterpretationContext ec, String name) {
addInfo("End of configuration.");
ec.popObject();
// model is at the top of the stack
}
}
@@ -0,0 +1,43 @@
package ch.qos.logback.classic.model;

import ch.qos.logback.core.model.Model;
import ch.qos.logback.core.util.Duration;

public class ConfigurationModel extends Model {

static final String DEBUG_SYSTEM_PROPERTY_KEY = "logback.debug";
static final Duration SCAN_PERIOD_DEFAULT = Duration.buildByMinutes(1);


String debugStr;
String scanStr;
String scanPeriodStr;
String packagingDataStr;


public String getDebugStr() {
return debugStr;
}
public void setDebugStr(String debugStr) {
this.debugStr = debugStr;
}
public String getScanStr() {
return scanStr;
}
public void setScanStr(String scanStr) {
this.scanStr = scanStr;
}
public String getScanPeriodStr() {
return scanPeriodStr;
}
public void setScanPeriodStr(String scanPeriodStr) {
this.scanPeriodStr = scanPeriodStr;
}

public String getPackagingDataStr() {
return packagingDataStr;
}
public void setPackagingDataStr(String packagingDataStr) {
this.packagingDataStr = packagingDataStr;
}
}
@@ -0,0 +1,128 @@
package ch.qos.logback.classic.model.processor;

import java.net.URL;
import java.util.concurrent.ScheduledExecutorService;
import java.util.concurrent.ScheduledFuture;
import java.util.concurrent.TimeUnit;

import ch.qos.logback.classic.LoggerContext;
import ch.qos.logback.classic.joran.ReconfigureOnChangeTask;
import ch.qos.logback.classic.model.ConfigurationModel;
import ch.qos.logback.classic.util.EnvUtil;
import ch.qos.logback.core.CoreConstants;
import ch.qos.logback.core.joran.spi.InterpretationContext;
import ch.qos.logback.core.joran.util.ConfigurationWatchListUtil;
import ch.qos.logback.core.model.Model;
import ch.qos.logback.core.model.processor.ModelHandlerBase;
import ch.qos.logback.core.status.OnConsoleStatusListener;
import ch.qos.logback.core.util.ContextUtil;
import ch.qos.logback.core.util.Duration;
import ch.qos.logback.core.util.OptionHelper;
import ch.qos.logback.core.util.StatusListenerConfigHelper;

public class ConfigurationModelHandler extends ModelHandlerBase {

static final String DEBUG_SYSTEM_PROPERTY_KEY = "logback.debug";
static final Duration SCAN_PERIOD_DEFAULT = Duration.buildByMinutes(1);

ConfigurationModelHandler(LoggerContext context) {
super(context);
}

@Override
public void handle(InterpretationContext interpretationContext, Model model) {

if (!(model instanceof ConfigurationModel)) {
addError("Can only handle models of type [" + ConfigurationModel.class + "]");
return;
}
ConfigurationModel configurationModel = (ConfigurationModel) model;

// See LOGBACK-527 (the system property is looked up first. Thus, it overrides
// the equivalent property in the config file. This reversal of scope priority is justified
// by the use case: the admin trying to chase rogue config file
String debugAttrib = getSystemProperty(DEBUG_SYSTEM_PROPERTY_KEY);
if (debugAttrib == null) {
debugAttrib = interpretationContext.subst(configurationModel.getDebugStr());
}

if (!(OptionHelper.isEmpty(debugAttrib) || debugAttrib.equalsIgnoreCase("false") || debugAttrib.equalsIgnoreCase("null"))) {
StatusListenerConfigHelper.addOnConsoleListenerInstance(context, new OnConsoleStatusListener());
}

processScanAttrib(interpretationContext, configurationModel);

LoggerContext lc = (LoggerContext) context;
boolean packagingData = OptionHelper.toBoolean(interpretationContext.subst(configurationModel.getPackagingDataStr()),
LoggerContext.DEFAULT_PACKAGING_DATA);
lc.setPackagingDataEnabled(packagingData);

if (EnvUtil.isGroovyAvailable()) {
ContextUtil contextUtil = new ContextUtil(context);
contextUtil.addGroovyPackages(lc.getFrameworkPackages());
}
}

String getSystemProperty(String name) {
/*
* LOGBACK-743: accessing a system property in the presence of a SecurityManager (e.g. applet sandbox) can
* result in a SecurityException.
*/
try {
return System.getProperty(name);
} catch (SecurityException ex) {
return null;
}
}

void processScanAttrib(InterpretationContext ic, ConfigurationModel configurationModel) {
String scanStr = ic.subst(configurationModel.getScanStr());
if (!OptionHelper.isEmpty(scanStr) && !"false".equalsIgnoreCase(scanStr)) {

ScheduledExecutorService scheduledExecutorService = context.getScheduledExecutorService();
URL mainURL = ConfigurationWatchListUtil.getMainWatchURL(context);
if (mainURL == null) {
addWarn("Due to missing top level configuration file, reconfiguration on change (configuration file scanning) cannot be done.");
return;
}
ReconfigureOnChangeTask rocTask = new ReconfigureOnChangeTask();
rocTask.setContext(context);

context.putObject(CoreConstants.RECONFIGURE_ON_CHANGE_TASK, rocTask);

String scanPeriodStr = ic.subst(configurationModel.getScanPeriodStr());
Duration duration = getDurationOfScanPeriodAttribute(scanPeriodStr, SCAN_PERIOD_DEFAULT);

addInfo("Will scan for changes in [" + mainURL + "] ");
// Given that included files are encountered at a later phase, the complete list of files
// to scan can only be determined when the configuration is loaded in full.
// However, scan can be active if mainURL is set. Otherwise, when changes are detected
// the top level config file cannot be accessed.
addInfo("Setting ReconfigureOnChangeTask scanning period to " + duration);

ScheduledFuture<?> scheduledFuture = scheduledExecutorService.scheduleAtFixedRate(rocTask, duration.getMilliseconds(), duration.getMilliseconds(),
TimeUnit.MILLISECONDS);
context.addScheduledFuture(scheduledFuture);
}
}

private Duration getDurationOfScanPeriodAttribute(String scanPeriodAttrib, Duration defaultDuration) {
Duration duration = null;

if (!OptionHelper.isEmpty(scanPeriodAttrib)) {
try {
duration = Duration.valueOf(scanPeriodAttrib);
} catch (IllegalStateException | IllegalArgumentException e) {
addWarn("Failed to parse 'scanPeriod' attribute [" + scanPeriodAttrib + "]", e);
// default duration will be set below
}
}

if (duration == null) {
addInfo("No 'scanPeriod' specified. Defaulting to " + defaultDuration.toString());
duration = defaultDuration;
}
return duration;
}

}

0 comments on commit 40af71d

Please sign in to comment.