This example demonstrates how to use an implicit properties location for @TestPropertySourceIf @TestPropertySource is declared as an empty annotation (i.e., without explicit values for the locations or properties attributes), an attempt will be made to detect a default properties file (on the classpath) relative to the class that declares the annotation.
So that means if test class which declares the annotation is at src/test/java/com/logicbig/example/MyTest.java then the logic will look for the default properties file at the path src/test/resources/com/logicbig/example/MyTest.properties. .
Example
Creating a Spring application
package com.logicbig.example;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.stereotype.Service;
@Service
public class ReportService {
@Value("${report-subscriber:admin@example.com}")
private String theSubscriber;
public String getReportSubscriber() {
return theSubscriber;
}
}
A property file on app site
src/main/resources/prod.propertiesreport-subscriber=theManager@example.com
Main Class
@PropertySource("classpath:prod.properties")
@Configuration
@ComponentScan
public class AppConfig {
@Bean
public static PropertySourcesPlaceholderConfigurer propertyConfigInDev() {
return new PropertySourcesPlaceholderConfigurer();
}
public static void main(String[] args) {
AnnotationConfigApplicationContext context =
new AnnotationConfigApplicationContext(AppConfig.class);
ReportService rs = context.getBean(ReportService.class);
System.out.println(rs.getReportSubscriber());
}
}
Running above class:
OutputtheManager@example.com
Test Folder
The default properties file
src/main/resources/src/test/resources/com/logicbig/example/ReportServiceTests.propertiesreport-subscriber=theTester@example.com
The JUnit Test
We are not going to specify 'locations' or 'properties' attribute with @TestPropertySource:
@ExtendWith(SpringExtension.class)
@ContextConfiguration(classes = AppConfig.class)
@TestPropertySource
public class ReportServiceTests {
@Autowired
private ReportService reportService;
@Test
public void testReportSubscriber() {
String s = reportService.getReportSubscriber();
System.out.println(s);
assertEquals("theTester@example.com", s);
}
}
Output$ mvn test -Dtest=ReportServiceTests
[INFO] Scanning for projects...
[INFO]
[INFO] --< com.logicbig.example:test-property-source-with-default-location >---
[INFO] Building test-property-source-with-default-location 1.0-SNAPSHOT
[INFO] from pom.xml
[INFO] --------------------------------[ jar ]---------------------------------
[INFO]
[INFO] --- resources:3.3.1:resources (default-resources) @ test-property-source-with-default-location ---
[WARNING] Using platform encoding (UTF-8 actually) to copy filtered resources, i.e. build is platform dependent!
[INFO] Copying 1 resource from src\main\resources to target\classes
[INFO]
[INFO] --- compiler:3.3:compile (default-compile) @ test-property-source-with-default-location ---
[INFO] Changes detected - recompiling the module!
[WARNING] File encoding has not been set, using platform encoding UTF-8, i.e. build is platform dependent!
[INFO] Compiling 2 source files to D:\example-projects\spring-core-testing\test-property-source-with-default-location\target\classes
[INFO]
[INFO] --- resources:3.3.1:testResources (default-testResources) @ test-property-source-with-default-location ---
[WARNING] Using platform encoding (UTF-8 actually) to copy filtered resources, i.e. build is platform dependent!
[INFO] Copying 1 resource from src\test\resources to target\test-classes
[INFO]
[INFO] --- compiler:3.3:testCompile (default-testCompile) @ test-property-source-with-default-location ---
[INFO] Changes detected - recompiling the module!
[WARNING] File encoding has not been set, using platform encoding UTF-8, i.e. build is platform dependent!
[INFO] Compiling 1 source file to D:\example-projects\spring-core-testing\test-property-source-with-default-location\target\test-classes
[INFO]
[INFO] --- surefire:3.2.5:test (default-test) @ test-property-source-with-default-location ---
[INFO] Using auto detected provider org.apache.maven.surefire.junitplatform.JUnitPlatformProvider
[WARNING] file.encoding cannot be set as system property, use <argLine>-Dfile.encoding=...</argLine> instead
[INFO]
[INFO] -------------------------------------------------------
[INFO] T E S T S
[INFO] -------------------------------------------------------
[INFO] Running com.logicbig.example.ReportServiceTests
theTester@example.com
[INFO] Tests run: 1, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 0.579 s -- in com.logicbig.example.ReportServiceTests
[INFO]
[INFO] Results:
[INFO]
[INFO] Tests run: 1, Failures: 0, Errors: 0, Skipped: 0
[INFO]
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 5.717 s
[INFO] Finished at: 2026-01-31T22:33:18+08:00
[INFO] ------------------------------------------------------------------------
Example ProjectDependencies and Technologies Used: - spring-context 7.0.3 (Spring Context)
Version Compatibility: 5.0.0.RELEASE - 7.0.3 Version compatibilities of spring-context with this example: Versions in green have been tested.
- spring-test 7.0.3 (Spring TestContext Framework)
- junit-jupiter-engine 6.0.2 (Module "junit-jupiter-engine" of JUnit)
- JDK 25
- Maven 3.9.11
|
