com.github.mjeanroy.junit.servers.tomcat.jupiter.TomcatServerExtension Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of junit-servers-tomcat Show documentation
Show all versions of junit-servers-tomcat Show documentation
Add Tomcat Embedded Server to your junit tests case.
/**
* The MIT License (MIT)
*
* Copyright (c) 2014-2018
*
* Permission is hereby granted, free of charge, to any person obtaining a copy
* of this software and associated documentation files (the "Software"), to deal
* in the Software without restriction, including without limitation the rights
* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
* copies of the Software, and to permit persons to whom the Software is
* furnished to do so, subject to the following conditions:
*
* The above copyright notice and this permission notice shall be included in
* all copies or substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
* THE SOFTWARE.
*/
package com.github.mjeanroy.junit.servers.tomcat.jupiter;
import com.github.mjeanroy.junit.servers.jupiter.JunitServerExtension;
import com.github.mjeanroy.junit.servers.servers.AbstractConfiguration;
import com.github.mjeanroy.junit.servers.servers.EmbeddedServer;
import com.github.mjeanroy.junit.servers.tomcat.EmbeddedTomcat;
import com.github.mjeanroy.junit.servers.tomcat.EmbeddedTomcatConfiguration;
import com.github.mjeanroy.junit.servers.tomcat.exceptions.IllegalTomcatConfigurationException;
import org.junit.jupiter.api.extension.RegisterExtension;
import static com.github.mjeanroy.junit.servers.engine.Servers.findConfiguration;
/**
* A specialized {@link JunitServerExtension} that will instantiate an {@link EmbeddedTomcat}
* server automatically instead of using the Service Provider API.
*
* Since this jupiter extends {@link JunitServerExtension}, it has exactly the same features (parameter
* injections, etc.).
*
* @see JunitServerExtension
*/
public class TomcatServerExtension extends JunitServerExtension {
/**
* Create the jupiter with default behavior.
*/
public TomcatServerExtension() {
super();
}
/**
* Create the jupiter and specify the embedded tomcat instance to use.
*
* @param tomcat The embedded tomcat instance to use.
* @throws NullPointerException If {@code tomcat} is {@code null}.
*/
public TomcatServerExtension(EmbeddedTomcat tomcat) {
super(tomcat);
}
/**
* Create the jupiter and specify the embedded tomcat configuration to use (when using
* jupiter with {@link RegisterExtension}).
*
* @param configuration The embedded tomcat configuration to use.
* @throws NullPointerException If {@code configuration} is {@code null}.
*/
public TomcatServerExtension(EmbeddedTomcatConfiguration configuration) {
super(configuration);
}
@Override
protected EmbeddedServer instantiateServer(Class testClass, AbstractConfiguration configuration) {
final EmbeddedTomcatConfiguration tomcatConfiguration = extractConfiguration(testClass, configuration);
return tomcatConfiguration == null ? new EmbeddedTomcat() : new EmbeddedTomcat(tomcatConfiguration);
}
/**
* Try to extract {@link EmbeddedTomcat} configuration from:
*
* - The given {@code configuration} if it is not {@code null}.
* - A class field/method annotated with {@link com.github.mjeanroy.junit.servers.annotations.TestServerConfiguration} on given {@code testClass} otherwise.
*
*
* @param testClass The test class to analyze.
* @param configuration The configuration to use if not {@code null}.
* @return The {@link EmbeddedTomcat} configuration.
* @throws IllegalTomcatConfigurationException If extracted {@code configuration} is not an instance of {@link EmbeddedTomcatConfiguration}.
*/
private EmbeddedTomcatConfiguration extractConfiguration(Class testClass, AbstractConfiguration configuration) {
final AbstractConfiguration configurationToUse = configuration == null ? findConfiguration(testClass) : configuration;
if (configurationToUse == null) {
return null;
}
if (!(configurationToUse instanceof EmbeddedTomcatConfiguration)) {
throw new IllegalTomcatConfigurationException();
}
return (EmbeddedTomcatConfiguration) configurationToUse;
}
}