import java.lang.annotation.Target;

/**
 * Marks an event subscriber method as being thread-safe. This annotation indicates that EventBus
 * may invoke the event subscriber simultaneously from multiple threads.
 *
 * <p>This does not mark the method, and so should be used in combination with {@link Subscribe}.
 *
 * @author Cliff Biffle
 * @since 10.0
 */
@Retention(RetentionPolicy.RUNTIME)

 * highest valued character that requires escaping. For example a replacement map containing the
 * single character '{@code \}{@code u1000}' will require approximately 16K of memory. If you need
 * to create multiple escaper instances that have the same character replacement mapping consider
 * using {@link ArrayBasedEscaperMap}.
 *
 * @author Sven Mawson
 * @author David Beaumont
 * @since 15.0
 */
@GwtCompatible

///

Cela indiquera à **FastAPI** que la présence de ce paramètre est obligatoire.

## Liste de paramètres / valeurs multiples via Query

Quand on définit un paramètre de requête explicitement avec `Query` on peut aussi déclarer qu'il reçoit une liste de valeur, ou des "valeurs multiples".

Par exemple, pour déclarer un paramètre de requête `q` qui peut apparaître plusieurs fois dans une URL, on écrit :

        assertEquals(0x12345678, ((AvFlags) pair).getFlags(), "Flags value should match");
    }

    /**
     * Test decode with multiple AvPairs
     */
    @Test
    @DisplayName("Decode multiple AvPairs with EOL")
    void testDecodeMultiplePairs() throws CIFSException {
        // Create multiple AvPairs
        byte[] flagData = new byte[4];
        SMBUtil.writeInt4(0xAABBCCDD, flagData, 0);

- Exception types and messages
- Stream consumption (should not consume)
- Consistency across multiple calls

**Test Count**: 11 tests

**Key Scenarios**:
- ✅ Validates non-null streams
- ✅ Throws CrawlerSystemException for null
- ✅ Called during getText execution
- ✅ Does not consume or modify stream
- ✅ Consistent behavior across multiple calls
- ✅ Works with various InputStream types

---

import com.github.ajalt.clikt.parameters.options.default
import com.github.ajalt.clikt.parameters.options.flag
import com.github.ajalt.clikt.parameters.options.help
import com.github.ajalt.clikt.parameters.options.multiple
import com.github.ajalt.clikt.parameters.options.option
import com.github.ajalt.clikt.parameters.types.int
import java.security.cert.X509Certificate
import java.util.Properties
import java.util.concurrent.TimeUnit.SECONDS

     * Server flags from the SMB header.
     */
    public byte sflags;
    /**
     * Server flags2 field from the SMB header.
     */
    public int sflags2;
    /**
     * Maximum number of outstanding multiplex requests.
     */
    public int smaxMpxCount;
    /**
     * Maximum buffer size the server can handle.
     */
    public int maxBufferSize;
    /**
     * Session key for this connection.
     */

    /* 4. State verification after operations                             */
    /* ------------------------------------------------------------------ */

    @Test
    @DisplayName("Multiple reads update offset correctly")
    void testMultipleReadsUpdateOffset() {
        byte[] buffer1 = new byte[] { 0x10, 0x00, 0x00, 0x00 }; // 16
        byte[] buffer2 = new byte[] { 0x20, 0x00, 0x00, 0x00 }; // 32

 * </ul>
 *
 * <p>Methods:
 * <ul>
 * <li>{@link #index(SuggestItem)} - Index a single suggest item.
 * <li>{@link #index(SuggestItem[])} - Index multiple suggest items.
 * <li>{@link #delete(String)} - Delete a suggest item by ID.
 * <li>{@link #deleteByQuery(String)} - Delete suggest items by query string.

        int expectedFlags = DcerpcConstants.DCERPC_FIRST_FRAG | DcerpcConstants.DCERPC_LAST_FRAG;
        assertEquals(expectedFlags, dfsRootEnum.getFlags());
    }

    @Test
    @DisplayName("Multiple server names should be handled correctly")
    void testDifferentServerNames() {
        // Test with different server names
        String[] serverNames = { "server1", "domain.local", "192.168.1.100", "FILESERVER" };