JUnit Jupiter Test Annotatsiyalari

Quyidagi annotatsiyalar SpringExtension va JUnit Jupiter (ya'ni JUnit 5da dasturlash modeli) bilan birgalikda ishlatilganda qo'llab-quvvatlanadi:

• @SpringJUnitConfig

• @SpringJUnitWebConfig

• @TestConstructor

• @NestedTestConfiguration

• @EnabledIf

• @DisabledIf

@SpringJUnitConfig

@SpringJUnitConfig - bu JUnit Jupiter'dan @ExtendWith(SpringExtension.class) va Spring TestContext Framework'dan @ContextConfiguration'ni birlashtiradigan tarkibiy annotatsiya. Uni sinf darajasida @ContextConfiguration'ga o'rinbosar sifatida ishlatish mumkin. Konfiguratsiya parametrlariga kelsak, @ContextConfiguration va @SpringJUnitConfig annotatsiyalari orasidagi yagona farq @SpringJUnitConfig'dagi komponent sinflar value atributi bilan e'lon qilinishi mumkin.

Quyidagi misolda @SpringJUnitConfig annotatsiyasidan konfiguratsiya sinfini belgilash uchun qanday foydalanishni ko'rsatamiz:

@SpringJUnitConfig(TestConfig.class) 
class ConfigurationClassJUnitJupiterSpringTests {
    // sinf tanasi...
}

1. Konfiguratsiya sinfini belgilaymiz.

@SpringJUnitConfig(TestConfig::class) 
class ConfigurationClassJUnitJupiterSpringTests {
    // sinf tanasi...
}

1. Konfiguratsiya sinfini belgilaymiz.

Quyidagi misolda @SpringJUnitConfig annotatsiyasidan konfiguratsion faylning joylashuvini belgilash uchun qanday foydalanishni ko'rsatamiz:

@SpringJUnitConfig(locations = "/test-config.xml") 
class XmlJUnitJupiterSpringTests {
    // sinf tanasi...
}

1. Konfiguratsion faylning joylashuvini belgilaymiz.

@SpringJUnitConfig(locations = ["/test-config.xml"]) 
class XmlJUnitJupiterSpringTests {
    // sinf tanasi...
}

1. Konfiguratsion faylning joylashuvini belgilaymiz.

Batafsil ma'lumotni "Kontekst boshqaruvi" bo'limida hamda @SpringJUnitConfig va @ContextConfiguration javadoc'da ko'rishingiz mumkin.

@SpringJUnitWebConfig

@SpringJUnitWebConfig - bu JUnit Jupiter'dan @ExtendWith(SpringExtension.class) va Spring TestContext Framework'dan @ContextConfiguration va @WebAppConfiguration bilan birlashtirilgan tarkibiy annotatsiya. Uni sinf darajasida @ContextConfiguration va @WebAppConfiguration annotatsiyalariga o'rinbosar sifatida ishlatish mumkin. Konfiguratsiya parametrlariga kelsak, @ContextConfiguration va @SpringJUnitWebConfig annotatsiyalari orasidagi yagona farq @SpringJUnitWebConfig annotatsiyasida komponent sinflar value atributi bilan e'lon qilinishi mumkin. Qo'shimcha, @WebAppConfiguration annotatsiyasida value atributining qiymati faqat @SpringJUnitWebConfig annotatsiyasidagi resourcePath atributi yordamida almashtirilishi mumkin.

Quyidagi misolda @SpringJUnitWebConfig annotatsiyasidan konfiguratsiya sinfini belgilash uchun qanday foydalanishni ko'rsatamiz:

@SpringJUnitWebConfig(TestConfig.class) 
class ConfigurationClassJUnitJupiterSpringWebTests {
    // sinf tanasi...
}

1. Konfiguratsiya sinfini belgilaymiz.

@SpringJUnitWebConfig(TestConfig::class) 
class ConfigurationClassJUnitJupiterSpringWebTests {
    // sinf tanasi...
}

1. Konfiguratsiya sinfini belgilaymiz.

Quyidagi misolda @SpringJUnitWebConfig annotatsiyasidan konfiguratsion faylning joylashuvini belgilash uchun qanday foydalanishni ko'rsatamiz:

@SpringJUnitWebConfig(locations = "/test-config.xml") 
class XmlJUnitJupiterSpringWebTests {
    // sinf tanasi...
}

1. Konfiguratsion faylning joylashuvini belgilaymiz.

@SpringJUnitWebConfig(locations = ["/test-config.xml"]) 
class XmlJUnitJupiterSpringWebTests {
    // sinf tanasi...
}

1. Konfiguratsion faylning joylashuvini belgilaymiz.

Batafsil ma'lumotni "Kontekst boshqaruvi" bo'limida, shuningdek @SpringJUnitWebConfig, @ContextConfiguration va @WebAppConfiguration javadoc'da ko'rishingiz mumkin.

@TestConstructor

@TestConstructor - bu sinf darajasidagi annotatsiya bo'lib, u test sinfi konstruktorining parametrlarini qanday qilib avtomatik ravishda aniqlash va ApplicationContext testidan komponentlar bilan bog'lashni sozlash uchun ishlatiladi.

Agar @TestConstructor annotatsiyasi yoq bo'lmasa yoki test sinfida metaanotatsiya orqali mavjud bo'lsa, odatiy test konstruktori avtomatik aniqlash va bog'lash rejimi ishlatiladi. Odatiy rejimni qanday o'zgartirish haqida batafsil ma'lumotni quyidagi maslahatda ko'rishingiz mumkin. Shuni bilish kerakki, test konstruktori uchun @Autowired annotatsiyasining mahalliy deklaratsiyasi @TestConstructor va odatiy rejimdan ustun turadi.

@NestedTestConfiguration

@NestedTestConfiguration - bu sinflar ierarxiyasida ichki test sinflari uchun Spring test konfigurasiya annotatsiyalarini qanday ishlatishni sozlash uchun ishlatiladigan sinf darajasidagi annotatsiya.

Agar @NestedTestConfiguration annotatsiyasi yoq bo'lmasa yoki test sinfida metaanotatsiya orqali mavjud bo'lsa, uning supertiplar ierarxiyasida yoki uning quyi sinflar ierarxiyasida bo'lsa, umumiy konfiguratsiya merosxo'rlik rejimi odatiy ishlatiladi. Odatiy rejimni qanday o'zgartirish haqida batafsil ma'lumotni quyidagi maslahatda ko'rishingiz mumkin.

Spring TestContext Framework quyidagi annotatsiyalar uchun @NestedTestConfiguration annotatsiyasi semantikasini qo'llab-quvvatlaydi.

• @BootstrapWith

• @ContextConfiguration

• @WebAppConfiguration

• @ContextHierarchy

• @ActiveProfiles

• @TestPropertySource

• @DynamicPropertySource

• @DirtiesContext

• @TestExecutionListeners

• @RecordApplicationEvents

• @Transactional

• @Commit

• @Rollback

• @Sql

• @SqlConfig

• @SqlMergeMode

• @TestConstructor

@Nested annotatsiyali sinf konfiguratsiyasi haqida ko'proq ma'lumot olish uchun "Test sinf konfiguratsiyasi" bo'limiga qarang.

@EnabledIf

@EnabledIf annotatsiyasi JUnit Jupiter'dan annotatsiyalangan test sinfi yoki test metodi faollashtirilganligini va bajarilishi kerakligini bildiradi, agar ko'rsatilgan expression true bo'lsa. Aniqrog'i, agar ifoda Boolean.TRUE yoki String teng true bo'lsa (kichiklotfuqat farqsiz), test faollashadi. Sinf darajasida qo'llanilsa, ushbu sinfdagi barcha test metodlari ham avtomatik ravishda faollashadi.

Ifodalar quyidagi shakllardan biriga ega bo'lishi mumkin:

• Spring Expression Language (SpEL) ifodasi. Misol: @EnabledIf("#{systemProperties['os.name'].toLowerCase().contains('mac')}")

• Framwork Spring'ning Environment'ida mavjud bo'lgan xususiyatlar uchun plaseholder. Misol: @EnabledIf("${smoke.tests.enabled}")

• Matnli literallar. Misol: @EnabledIf("true")

Biroq, shuni bilish kerakki, dinamik xususiyat yer almashtirish natijasi bo'lmagan matnli literal amaliy qiymatga ega emas, chunki @EnabledIf("false") annotatsiyasi @Disabled annotatsiyasiga teng, va @EnabledIf("true") annotatsiyasi mantiqan hech qanday maqsadga ega emas.

@EnabledIf anotatsiyasini maxsus tarkibiy annotatsiyalar yaratish uchun meta-annotatsiya sifatida qo'llashingiz mumkin. Masalan, quyidagicha maxsus @EnabledOnMac annotatsiyasini yaratishingiz mumkin:

@Target({ElementType.TYPE, ElementType.METHOD})
@Retention(RetentionPolicy.RUNTIME)
@EnabledIf(
    expression = "#{systemProperties['os.name'].toLowerCase().contains('mac')}",
    reason = "Enabled on Mac OS"
)
public @interface EnabledOnMac {}

@Target(AnnotationTarget.TYPE, AnnotationTarget.FUNCTION)
@Retention(AnnotationRetention.RUNTIME)
@EnabledIf(
        expression = "#{systemProperties['os.name'].toLowerCase().contains('mac')}",
        reason = "Enabled on Mac OS"
)
annotation class EnabledOnMac {}

@DisabledIf

@DisabledIf annotatsiyasi JUnit Jupiter'dan annotatsiyalangan test sinfi yoki test metodi bekor qilinganini va bajarilmasligini bildiradi, agar ko'rsatilgan ifoda true bo'lsa. Aniqrog'i, agar ifoda Boolean.TRUE yoki String teng true bo'lsa (kichiklotfuqat farqsiz), test bekor qilinadi. Sinf darajasida qo'llanilsa, ushbu sinfdagi barcha test metodlari ham avtomatik ravishda bekor qilinadi.

Ifodalar quyidagi shakllardan biriga ega bo'lishi mumkin:

• Spring Expression Language (SpEL) ifodasi. Misol: @DisabledIf("#{systemProperties['os.name'].toLowerCase().contains('mac')}")

• Framwork Spring'ning Environment'ida mavjud bo'lgan xususiyatlar uchun plaseholder. Misol: @DisabledIf("${smoke.tests.disabled}")

• Matnli literallar. Misol: @DisabledIf("true")

Biroq, shuni bilish kerakki, dinamik xususiyat yer almashtirish natijasi bo'lmagan matnli literal amaliy qiymatga ega emas, chunki @DisabledIf("true") annotatsiyasi @Disabled annotatsiyasiga teng, va @DisabledIf("false") annotatsiyasi mantiqan hech qanday maqsadga ega emas.

@DisabledIf annotatsiyasini maxsus tarkibiy annotatsiyalar yaratish uchun meta-annotatsiya sifatida qo'llashingiz mumkin. Masalan, quyidagicha maxsus @DisabledOnMac annotatsiyasini yaratishingiz mumkin:

@Target({ElementType.TYPE, ElementType.METHOD})
@Retention(RetentionPolicy.RUNTIME)
@DisabledIf(
    expression = "#{systemProperties['os.name'].toLowerCase().contains('mac')}",
    reason = "Disabled on Mac OS"
)
public @interface DisabledOnMac {}

@Target(AnnotationTarget.TYPE, AnnotationTarget.FUNCTION)
@Retention(AnnotationRetention.RUNTIME)
@DisabledIf(
        expression = "#{systemProperties['os.name'].toLowerCase().contains('mac')}",
        reason = "Disabled on Mac OS"
)
annotation class DisabledOnMac {}