On peut aussi ajouter plus d'informations sur le paramètre.

Ces informations seront incluses dans le schéma `OpenAPI` généré et utilisées par la documentation interactive ou les outils externes utilisés.

/// note

Gardez en tête que les outils externes utilisés ne supportent pas forcément tous parfaitement OpenAPI.

 * }</pre>
 *
 * <h2>Extension Points</h2>
 *
 * <p>To add new upgrade strategies:</p>
 * <ol>
 *   <li>Implement {@link org.apache.maven.cling.invoker.mvnup.goals.UpgradeStrategy}</li>
 *   <li>Optionally extend {@link org.apache.maven.cling.invoker.mvnup.goals.AbstractUpgradeStrategy}</li>
 *   <li>Annotate with {@code @Named} and {@code @Singleton}</li>
 *   <li>Use {@code @Priority} to control execution order</li>
 * </ol>
 *

 * java.util.function.Predicate} is expected, use the method reference {@code
 * guavaPredicate::apply}. For the other direction, use {@code javaUtilPredicate::test}. A future
 * version of this interface will be made to <i>extend</i> {@code java.util.function.Predicate}, so
 * that conversion will be necessary in only one direction. At that time, this interface will be
 * officially discouraged.
 *
 * @author Kevin Bourrillion
 * @since 2.0
 */

            // When
            Handler testHandler = new Handler();

            // Then
            assertNotNull(testHandler);
        }

        @Test
        @DisplayName("Should extend jcifs.smb1.http.Handler")
        void testInheritance() {
            // Then
            assertTrue(handler instanceof jcifs.smb1.http.Handler);
            assertTrue(handler instanceof URLStreamHandler);
        }

        assertEquals(SMBProtocolDowngradeException.class.getName(), ex.toString());

        // Assert - type hierarchy: subclass of CIFSException and IOException
        assertTrue(ex instanceof jcifs.CIFSException, "Should extend CIFSException");
        assertTrue(ex instanceof IOException, "Should be an IOException (checked)");
    }

    @ParameterizedTest(name = "Message-only ctor preserves message: [{0}]")
    @MethodSource("messages")

Você pode fazer isso usando o <a href="https://docs.pydantic.dev/latest/concepts/validators/#field-after-validator" class="external-link" target="_blank">`AfterValidator` do Pydantic</a> dentro de `Annotated`.

/// tip | Dica

O Pydantic também tem <a href="https://docs.pydantic.dev/latest/concepts/validators/#field-before-validator" class="external-link" target="_blank">`BeforeValidator`</a> e outros. 🤓

///

            // When
            Handler testHandler = new Handler(null);

            // Then
            assertNotNull(testHandler);
        }

        @Test
        @DisplayName("Should extend jcifs.http.Handler")
        void testInheritance() {
            // Then
            assertTrue(handler instanceof jcifs.http.Handler);
            assertTrue(handler instanceof URLStreamHandler);
        }
    }

 * <i>other type</i> of supplier is expected, use the method reference {@code supplier::get}. A
 * future version of {@code com.google.common.base.Supplier} will be made to <i>extend</i> {@code
 * java.util.function.Supplier}, making conversion code necessary only in one direction. At that
 * time, this interface will be officially discouraged.
 *
 * @author Harry Heymann
 * @since 2.0
 */

    }

    @Test
    @DisplayName("Context should extend AbstractCIFSContext")
    void testInheritanceHierarchy() {
        // Then
        assertTrue(context instanceof AbstractCIFSContext, "BaseContext should extend AbstractCIFSContext");
    }

    @Test
    @DisplayName("Context should handle concurrent access safely")

import java.util.Map;
import java.util.Optional;
import java.util.Set;
import org.jspecify.annotations.Nullable;

/**
 * This class provides a skeletal implementation of {@link ValueGraph}. It is recommended to extend
 * this class rather than implement {@link ValueGraph} directly.
 *
 * <p>The methods implemented in this class should not be overridden unless the subclass admits a
 * more efficient implementation.
 *