/*
 * Copyright 2015-2019 the original author or authors.
 *
 * All rights reserved. This program and the accompanying materials are
 * made available under the terms of the Eclipse Public License v2.0 which
 * accompanies this distribution and is available at
 *
 * http://www.eclipse.org/legal/epl-v20.html
 */

package org.junit.jupiter.engine.descriptor;

import static org.apiguardian.api.API.Status.INTERNAL;
import static org.junit.jupiter.engine.descriptor.DisplayNameUtils.createDisplayNameSupplierForNestedClass;

import java.util.LinkedHashSet;
import java.util.Optional;
import java.util.Set;

import org.apiguardian.api.API;
import org.junit.jupiter.api.extension.ExtensionContext;
import org.junit.jupiter.api.extension.TestInstances;
import org.junit.jupiter.engine.config.JupiterConfiguration;
import org.junit.jupiter.engine.execution.JupiterEngineExecutionContext;
import org.junit.jupiter.engine.extension.ExtensionRegistry;
import org.junit.platform.engine.TestDescriptor;
import org.junit.platform.engine.TestTag;
import org.junit.platform.engine.UniqueId;

TestDescriptor for tests based on nested (but not static) Java classes.

Default Display Names

The default display name for a non-static nested test class is the simple name of the class.

Since:5.0
/** * {@link TestDescriptor} for tests based on nested (but not static) Java classes. * * <h3>Default Display Names</h3> * * <p>The default display name for a non-static nested test class is the simple * name of the class. * * @since 5.0 */
@API(status = INTERNAL, since = "5.0") public class NestedClassTestDescriptor extends ClassTestDescriptor {
Set of local class-level tags; does not contain tags from parent.
/** * Set of local class-level tags; does not contain tags from parent. */
private final Set<TestTag> tags; public NestedClassTestDescriptor(UniqueId uniqueId, Class<?> testClass, JupiterConfiguration configuration) { super(uniqueId, testClass, createDisplayNameSupplierForNestedClass(testClass), configuration); this.tags = getTags(testClass); } // --- TestDescriptor ------------------------------------------------------ @Override public final Set<TestTag> getTags() { // return modifiable copy Set<TestTag> allTags = new LinkedHashSet<>(this.tags); getParent().ifPresent(parentDescriptor -> allTags.addAll(parentDescriptor.getTags())); return allTags; } // --- Node ---------------------------------------------------------------- @Override protected TestInstances instantiateTestClass(JupiterEngineExecutionContext parentExecutionContext, ExtensionRegistry registry, ExtensionContext extensionContext) { // Extensions registered for nested classes and below are not to be used for instantiating outer classes Optional<ExtensionRegistry> childExtensionRegistryForOuterInstance = Optional.empty(); TestInstances outerInstances = parentExecutionContext.getTestInstancesProvider().getTestInstances( childExtensionRegistryForOuterInstance); return instantiateTestClass(Optional.of(outerInstances), registry, extensionContext); } }