Annotations

---
name: annotations
description: Conventions for using annotations in all tests using Jupiter
---

## 1. Make sure to use `@param:Value` eveywhere @Value is declared for Kotlin classes and files only

Remember to run tests after replacing all of them

## 2. Make sure to use interpolation prefixes for the `@Value` annotation in Kotlin classes and files only

### Example 1 (applying to params)

Replace this:

```kotlin
class VirtualThreadsDemoApplication(
    val taskService: TaskService,
    @param:Value("\${org.jesperancinha.vtcc.tasks}") private val tasks: Int,
)
```

with this:

```kotlin
class VirtualThreadsDemoApplication(
    val taskService: TaskService,
    @param:Value($$"${org.jesperancinha.vtcc.tasks}") private val tasks: Int,
) 
```

### Example 2 (applying to fields, on lateinit vars

Replace this:

```kotlin
class BankCompanyLauncherOtherPropertiesKotlinTest {
    /**
     * Properties and environment variables
     */
    @Value($$"${environment}")
    private lateinit var environment: String
}
```

with this:

```kotlin
class BankCompanyLauncherOtherPropertiesKotlinTest {
    /**
     * Properties and environment variables
     */
    @field:Value($$"${environment}")
    private lateinit var environment: String
}
```

The same should be applied to annotation `@Autowired`, but only for non-test classes and only in Kotlin files.
The same should be applied to annotation `@JsonProperty`, `@JsonDeserialize`, `@JsonAlias`, `@LocalServerPort`, but only in Kotlin files.
Do not add `@Autowired`, or any form of it with a different target to any parameter. `@Autowired` usage should be removed from production code instead.

## 3. Checklist

[] Make sure there is no more use of `@Value` annotation being used directly
[] Make sure no `@param:Value` has been changed in a Java file
[] Check that all `@param:Value` annotations are used correctly