*/
    boolean generate(String thumbnailId, File outputFile);

    /**
     * Checks if this generator can handle the given document.
     * @param docMap The document map containing metadata.
     * @return True if this generator can handle the document, false otherwise.
     */
    boolean isTarget(Map<String, Object> docMap);

    /**

                // Cleanup persistent handle manager
                if (persistentHandleManager != null) {
                    try {
                        persistentHandleManager.shutdown();
                        log.debug("Persistent handle manager shutdown on session logoff");
                    } catch (Exception e) {
                        log.warn("Error shutting down persistent handle manager during logoff", e);

        // Just verify that contexts were written
        assertTrue(bytesWritten > 60); // Should be larger than basic negotiate request
    }

    @Test
    @DisplayName("Should handle empty negotiate contexts array")
    void testWriteBytesWireFormatEmptyContexts() {
        // Given
        when(mockConfig.getMaximumVersion()).thenReturn(DialectVersion.SMB302);

# OpenAPI

There are several utilities to handle OpenAPI.

    }

    @ParameterizedTest
    @ValueSource(strings = { "", "a", "short", "medium length text", "very long text that exceeds typical block sizes" })
    @DisplayName("Should handle various input sizes for hashing")
    void testHashVariousInputSizes(String input) {
        // Given
        byte[] data = input.getBytes();

        // When
        MessageDigest md4 = Crypto.getMD4();

# Advanced Middleware { #advanced-middleware }

In the main tutorial you read how to add [Custom Middleware](../tutorial/middleware.md){.internal-link target=_blank} to your application.

And then you also read how to handle [CORS with the `CORSMiddleware`](../tutorial/cors.md){.internal-link target=_blank}.

In this section we'll see how to use other middlewares.

## Adding ASGI middlewares { #adding-asgi-middlewares }

import jcifs.SmbTreeHandle;

/**
 * Internal interface for SMB tree handle operations.
 *
 * This interface provides internal methods for managing
 * SMB tree connections and their lifecycle.
 *
 * @author mbechler
 */
public interface SmbTreeHandleInternal extends SmbTreeHandle {

    /**
     * Releases this tree handle back to the pool for reuse
     */
    void release();

    /**

    }

    @Test
    void testConstructorWithSmbFileOnly() throws IOException, CIFSException {
        // Given
        // Mock the AutoCloseable tree handle behavior
        SmbTreeHandleImpl autoCloseableMockTreeHandle = mock(SmbTreeHandleImpl.class);
        when(mockFile.ensureTreeConnected()).thenReturn(autoCloseableMockTreeHandle);

        // Next call should handle CIFSException and close iterator
        assertFalse(it.hasNext()); // After error, hasNext should return false

        // Assert
        verify(tree, times(1)).release();
    }

    @Test
    @DisplayName("close() closes when there is a next element and releases handle")
    void explicitClose() throws Exception {
        // Arrange

                assertEquals(testByte, buffer[i], "Byte at position " + i + " was modified");
            }
        }

        @Test
        @DisplayName("Should handle encoding at buffer boundary")
        void testEncodeAtBufferBoundary() {
            // Given
            byte[] exactBuffer = new byte[EXPECTED_SIZE];
            SrvCopychunk chunk = new SrvCopychunk(999L, 888L, 777);