Skip to content

Commit

Permalink
Polish 'Support profile specific Log4j2 configuration'
Browse files Browse the repository at this point in the history
  • Loading branch information
philwebb committed Oct 14, 2022
1 parent 27ed30f commit 5a7964a
Show file tree
Hide file tree
Showing 7 changed files with 258 additions and 80 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -37,51 +37,38 @@
* included.
*
* @author Ralph Goers
* @since 3.0.0
*/
@Plugin(name = "SpringProfile", category = Node.CATEGORY, elementType = Arbiter.ELEMENT_TYPE, deferChildren = true,
printObject = true)
public final class SpringProfileArbiter implements Arbiter {

private final String[] profileNames;
final class SpringProfileArbiter implements Arbiter {

private final Environment environment;

private SpringProfileArbiter(final String[] profiles, Environment environment) {
this.profileNames = profiles;
private final Profiles profiles;

private SpringProfileArbiter(Environment environment, String[] profiles) {
this.environment = environment;
this.profiles = Profiles.of(profiles);
}

@Override
public boolean isCondition() {
if (this.environment == null) {
return false;
}

if (this.profileNames.length == 0) {
return false;
}
return this.environment.acceptsProfiles(Profiles.of(this.profileNames));
return (this.environment != null) ? this.environment.acceptsProfiles(this.profiles) : false;
}

@PluginBuilderFactory
public static Builder newBuilder() {
static Builder newBuilder() {
return new Builder();
}

/**
* Standard Builder to create the Arbiter.
*/
public static class Builder implements org.apache.logging.log4j.core.util.Builder<SpringProfileArbiter> {
public static final class Builder implements org.apache.logging.log4j.core.util.Builder<SpringProfileArbiter> {

private static final Logger LOGGER = StatusLogger.getLogger();
private static final Logger statusLogger = StatusLogger.getLogger();

/**
* Attribute name identifier.
*/
public static final String ATTR_NAME = "name";

@PluginBuilderAttribute(ATTR_NAME)
@PluginBuilderAttribute
private String name;

@PluginConfiguration
Expand All @@ -90,47 +77,30 @@ public static class Builder implements org.apache.logging.log4j.core.util.Builde
@PluginLoggerContext
private LoggerContext loggerContext;

private Builder() {
}

/**
* Sets the Profile Name or Names.
* @param name the profile name(s).
* Sets the profile name or expression.
* @param name the profile name or expression
* @return this
* @see Profiles#of(String...)
*/
public Builder setName(final String name) {
public Builder setName(String name) {
this.name = name;
return asBuilder();
}

public Builder setConfiguration(final Configuration configuration) {
this.configuration = configuration;
return asBuilder();
}

public Builder setLoggerContext(final LoggerContext loggerContext) {
this.loggerContext = loggerContext;
return asBuilder();
}

private SpringProfileArbiter.Builder asBuilder() {
return this;
}

@Override
public SpringProfileArbiter build() {
String[] profileNames = StringUtils.trimArrayElements(StringUtils
.commaDelimitedListToStringArray(this.configuration.getStrSubstitutor().replace(this.name)));
Environment environment = null;
if (this.loggerContext != null) {
environment = (Environment) this.loggerContext.getObject(Log4J2LoggingSystem.ENVIRONMENT_KEY);
if (environment == null) {
LOGGER.warn("Cannot create Arbiter, no Spring Environment provided");
return null;
}

return new SpringProfileArbiter(profileNames, environment);
}
else {
LOGGER.warn("Cannot create Arbiter, LoggerContext is not available");
Environment environment = Log4J2LoggingSystem.getEnvironment(this.loggerContext);
if (environment == null) {
statusLogger.warn("Cannot create Arbiter, no Spring Environment available");
return null;
}
return null;
String name = this.configuration.getStrSubstitutor().replace(this.name);
String[] profiles = StringUtils.trimArrayElements(StringUtils.commaDelimitedListToStringArray(name));
return new SpringProfileArbiter(environment, profiles);
}

}
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -19,8 +19,6 @@
import java.beans.PropertyChangeEvent;
import java.beans.PropertyChangeListener;
import java.io.File;
import java.util.ArrayList;
import java.util.Collections;
import java.util.EnumSet;
import java.util.LinkedHashMap;
import java.util.List;
Expand Down Expand Up @@ -480,29 +478,6 @@ private String getRelativeClasspathLocation(String fileName) {
return defaultPath;
}

static class TestLog4J2LoggingSystem extends Log4J2LoggingSystem {

private List<String> availableClasses = new ArrayList<>();

TestLog4J2LoggingSystem() {
super(TestLog4J2LoggingSystem.class.getClassLoader());
}

Configuration getConfiguration() {
return ((org.apache.logging.log4j.core.LoggerContext) LogManager.getContext(false)).getConfiguration();
}

@Override
protected boolean isClassAvailable(String className) {
return this.availableClasses.contains(className);
}

private void availableClasses(String... classNames) {
Collections.addAll(this.availableClasses, classNames);
}

}

/**
* Used for testing that loggers in nested classes are returned by
* {@link Log4J2LoggingSystem#getLoggerConfigurations()} .
Expand Down
Original file line number Diff line number Diff line change
@@ -0,0 +1,162 @@
/*
* Copyright 2012-2022 the original author or authors.
*
* Licensed 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
*
* https://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.
*/

package org.springframework.boot.logging.log4j2;

import java.util.Set;

import org.apache.logging.log4j.LogManager;
import org.apache.logging.log4j.Logger;
import org.apache.logging.log4j.core.LoggerContext;
import org.apache.logging.log4j.core.config.Configuration;
import org.apache.logging.log4j.core.config.Reconfigurable;
import org.apache.logging.log4j.util.PropertiesUtil;
import org.apache.logging.log4j.util.PropertySource;
import org.junit.jupiter.api.AfterEach;
import org.junit.jupiter.api.BeforeEach;
import org.junit.jupiter.api.Test;
import org.junit.jupiter.api.extension.ExtendWith;

import org.springframework.boot.logging.LoggingInitializationContext;
import org.springframework.boot.testsupport.classpath.ClassPathExclusions;
import org.springframework.boot.testsupport.logging.ConfigureClasspathToPreferLog4j2;
import org.springframework.boot.testsupport.system.CapturedOutput;
import org.springframework.boot.testsupport.system.OutputCaptureExtension;
import org.springframework.mock.env.MockEnvironment;
import org.springframework.test.util.ReflectionTestUtils;
import org.springframework.util.ClassUtils;

import static org.assertj.core.api.Assertions.assertThat;

/**
* Tests for {@link SpringProfileArbiter}.
*
* @author Phillip Webb
*/
@ExtendWith(OutputCaptureExtension.class)
@ClassPathExclusions("logback-*.jar")
@ConfigureClasspathToPreferLog4j2
class SpringProfileArbiterTests {

private CapturedOutput output;

private final TestLog4J2LoggingSystem loggingSystem = new TestLog4J2LoggingSystem();

private final MockEnvironment environment = new MockEnvironment();

private final LoggingInitializationContext initializationContext = new LoggingInitializationContext(
this.environment);

private Logger logger;

private Configuration configuration;

@BeforeEach
void setup(CapturedOutput output) {
this.output = output;
LoggerContext loggerContext = (LoggerContext) LogManager.getContext(false);
this.configuration = loggerContext.getConfiguration();
this.loggingSystem.cleanUp();
this.logger = LogManager.getLogger(getClass());
cleanUpPropertySources();
}

@AfterEach
void cleanUp() {
this.loggingSystem.cleanUp();
LoggerContext loggerContext = (LoggerContext) LogManager.getContext(false);
loggerContext.stop();
loggerContext.start(((Reconfigurable) this.configuration).reconfigure());
cleanUpPropertySources();
}

@SuppressWarnings("unchecked")
private void cleanUpPropertySources() { // https://issues.apache.org/jira/browse/LOG4J2-3618
PropertiesUtil properties = PropertiesUtil.getProperties();
Object environment = ReflectionTestUtils.getField(properties, "environment");
Set<PropertySource> sources = (Set<PropertySource>) ReflectionTestUtils.getField(environment, "sources");
sources.removeIf((candidate) -> candidate instanceof SpringEnvironmentPropertySource
|| candidate instanceof SpringBootPropertySource);
}

@Test
void profileActive() {
this.environment.setActiveProfiles("production");
initialize("production-profile.xml");
this.logger.trace("Hello");
assertThat(this.output).contains("Hello");
}

@Test
void multipleNamesFirstProfileActive() {
this.environment.setActiveProfiles("production");
initialize("multi-profile-names.xml");
this.logger.trace("Hello");
assertThat(this.output).contains("Hello");
}

@Test
void multipleNamesSecondProfileActive() {
this.environment.setActiveProfiles("test");
initialize("multi-profile-names.xml");
this.logger.trace("Hello");
assertThat(this.output).contains("Hello");
}

@Test
void profileNotActive() {
initialize("production-profile.xml");
this.logger.trace("Hello");
assertThat(this.output).doesNotContain("Hello");
}

@Test
void profileExpressionMatchFirst() {
this.environment.setActiveProfiles("production");
initialize("profile-expression.xml");
this.logger.trace("Hello");
assertThat(this.output).contains("Hello");
}

@Test
void profileExpressionMatchSecond() {
this.environment.setActiveProfiles("test");
initialize("profile-expression.xml");
this.logger.trace("Hello");
assertThat(this.output).contains("Hello");
}

@Test
void profileExpressionNoMatch() {
this.environment.setActiveProfiles("development");
initialize("profile-expression.xml");
this.logger.trace("Hello");
assertThat(this.output).doesNotContain("Hello");
}

private void initialize(String config) {
this.environment.setProperty("logging.log4j2.config.override", getPackageResource(config));
this.loggingSystem.initialize(this.initializationContext, null, null);
}

private String getPackageResource(String fileName) {
String path = ClassUtils.getPackageName(getClass());
path = path.replace('.', '/');
path = path + "/" + fileName;
return "src/test/resources/" + path;
}

}
Original file line number Diff line number Diff line change
@@ -0,0 +1,47 @@
/*
* Copyright 2012-2022 the original author or authors.
*
* Licensed 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
*
* https://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.
*/

package org.springframework.boot.logging.log4j2;

import java.util.ArrayList;
import java.util.Collections;
import java.util.List;

import org.apache.logging.log4j.LogManager;
import org.apache.logging.log4j.core.config.Configuration;

class TestLog4J2LoggingSystem extends Log4J2LoggingSystem {

private List<String> availableClasses = new ArrayList<>();

TestLog4J2LoggingSystem() {
super(TestLog4J2LoggingSystem.class.getClassLoader());
}

Configuration getConfiguration() {
return ((org.apache.logging.log4j.core.LoggerContext) LogManager.getContext(false)).getConfiguration();
}

@Override
protected boolean isClassAvailable(String className) {
return this.availableClasses.contains(className);
}

void availableClasses(String... classNames) {
Collections.addAll(this.availableClasses, classNames);
}

}
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
<?xml version="1.0" encoding="UTF-8"?>
<Configuration>
<SpringProfile name="production, test">
<Loggers>
<Logger name="org.springframework.boot.logging.log4j2" level="TRACE" />
</Loggers>
</SpringProfile>
</Configuration>
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
<?xml version="1.0" encoding="UTF-8"?>
<Configuration>
<SpringProfile name="production">
<Loggers>
<Logger name="org.springframework.boot.logging.log4j2" level="TRACE" />
</Loggers>
</SpringProfile>
</Configuration>
Loading

0 comments on commit 5a7964a

Please sign in to comment.