* @since 4.0.0
 */
@Experimental
@Immutable
public interface Request<S extends ProtoSession> {

    /**
     * Returns the session associated with this request.
     *
     * @return the session instance, never {@code null}
     */
    @Nonnull
    S getSession();

    /**
     * Returns the trace information associated with this request, if any.
     * The trace provides context about the request's position in the operation

        // Test writeDataWireFormat returns 0
        response = new Trans2QueryFSInformationResponse(config, FileSystemInformation.SMB_INFO_ALLOCATION);

        byte[] buffer = new byte[10];
        int written = response.writeDataWireFormat(buffer, 0);

        assertEquals(0, written);
    }

    @Test
    void testReadSetupWireFormat() {
        // Test readSetupWireFormat returns 0

  public static ListenableFuture<@Nullable Void> immediateVoidFuture() {
    return (ListenableFuture<@Nullable Void>) ImmediateFuture.NULL;
  }

  /**
   * Returns a {@code ListenableFuture} which has an exception set immediately upon construction.
   *
   * <p>The returned {@code Future} can't be cancelled, and its {@code isDone()} method always
   * returns {@code true}. Calling {@code get()} will immediately throw the provided {@code

 *
 * <p>The {@link #rowKeySet} method returns a {@link SortedSet} and the {@link #rowMap} method
 * returns a {@link SortedMap}, instead of the {@link Set} and {@link Map} specified by the {@link
 * Table} interface.
 *
 * <p>The views returned by {@link #column}, {@link #columnKeySet()}, and {@link #columnMap()} have

        assertEquals("testfile.txt", fileBothDirectoryInfo.getName());
    }

    @Test
    @DisplayName("Test getType returns TYPE_FILESYSTEM")
    void testGetType() {
        assertEquals(SmbConstants.TYPE_FILESYSTEM, fileBothDirectoryInfo.getType());
    }

    @Test
    @DisplayName("Test getFileIndex returns correct value")
    void testGetFileIndex() throws SMBProtocolDecodingException {
        // Prepare test data

        assertSame(session, session.acquire());
        verify(transport, times(1)).acquire();
        assertTrue(session.isInUse());
    }

    @Test
    @DisplayName("getSessionKey: throws when absent, returns when present")
    void testGetSessionKey() throws Exception {
        SmbSessionImpl session = newSession();

        // Absent key -> CIFSException

            buffer[i] = (byte) (0xFF - i);
        }

        return buffer;
    }

    private byte[] createMockBuffer(byte infoLevel) {
        switch (infoLevel) {
        case FileInformation.FILE_BASIC_INFO:
            return createMockFileBasicInfoBuffer();
        case FileInformation.FILE_STANDARD_INFO:
            return createMockFileStandardInfoBuffer();
        case FileInformation.FILE_INTERNAL_INFO:

        if (canonicalProtocol != null) {
            return canonicalProtocol;
        }
        return protocol;
    }

    /**
     * Returns the {@link File} object of the Jar file indicated by the URL.
     *
     * @param fileUrl
     *            The URL of the Jar file. Must not be {@literal null}.
     * @return The {@link File} of the Jar file.
     */
    public static File toFile(final URL fileUrl) {

    @Test
    void testWriteSetupWireFormat() {
        // Test that writeSetupWireFormat returns 0
        byte[] dst = new byte[100];
        int result = response.writeSetupWireFormat(dst, 10);
        assertEquals(0, result);
    }

    @Test
    void testWriteParametersWireFormat() {
        // Test that writeParametersWireFormat returns 0
        byte[] dst = new byte[100];

        assertNull(delegatingConfig.getRandom(), "Should return null when delegate returns null");
        assertNull(delegatingConfig.getLocalAddr(), "Should return null when delegate returns null");
        assertNull(delegatingConfig.getNetbiosHostname(), "Should return null when delegate returns null");
        assertNull(delegatingConfig.getResolveOrder(), "Should return null when delegate returns null");