private boolean isRecoverableError(Exception error) {
        // Timeout errors are often recoverable
        if (error instanceof SocketTimeoutException) {
            return true;
        }

        // Some socket errors might be recoverable
        if (error instanceof SocketException) {
            String message = error.getMessage();
            if (message != null) {
                message = message.toLowerCase();

            throw new IORuntimeException(e);
        }
    }

    /**
     * Closes the {@link ZipInputStream}.
     * <p>
     * If {@link ZipInputStream#closeEntry()} throws an exception, an error message is logged.
     * The exception is not rethrown.
     * </p>
     *
     * @param zis
     *            {@link ZipInputStream}. Must not be {@literal null}.
     * @see ZipInputStream#closeEntry()
     */

        assertTrue(ex.getMessage().contains("failed"));
        verify(transport).hasCapability(42);
    }

    // Edge: disconnected status toggles
    @ParameterizedTest
    @DisplayName("isDisconnected reflects current mocked state")
    @ValueSource(booleans = { true, false })
    void isDisconnected_states(boolean disconnected) {
        when(transport.isDisconnected()).thenReturn(disconnected);

    int DEFAULT_PORT = 445;

    /** Default maximum multiplex count */
    int DEFAULT_MAX_MPX_COUNT = 10;
    /** Default response timeout in milliseconds */
    int DEFAULT_RESPONSE_TIMEOUT = 30000;
    /** Default socket timeout in milliseconds */
    int DEFAULT_SO_TIMEOUT = 35000;
    /** Default receive buffer size in bytes */
    int DEFAULT_RCV_BUF_SIZE = 60416;
    /** Default send buffer size in bytes */

- `opensearch/{index}/bsbhv/` - Base behaviors (do not edit)
- `opensearch/{index}/exbhv/` - Extended behaviors (customize here)

## Key Patterns

### Actions (Controllers)
- Located in `app.web.*` or `app.web.admin.*`
- Methods with `@Execute` are web endpoints
- DI via `@Resource` annotation
- `HtmlResponse` for JSP, `JsonResponse` for APIs

### Services
- Business logic in `app.service.*`

        done = true;
        return super.getFile();
    }

    /**
     * Closes the stream and deletes the temporary file if it was not retrieved.
     * If an error occurs during file deletion, it is logged but not thrown to avoid
     * masking exceptions from the main operation.
     *
     * @throws IOException if an I/O error occurs during stream closure
     */
    @Override
    public void close() throws IOException {

    // keeping parsed request parameters, normal texts or uploaded files
    // keys are requested parameter names (treated as field name here)
    protected Map<String, Object> elementsAll; // lazy-loaded, then after not null
    protected Map<String, MultipartFormFile> elementsFile; // me too
    protected Map<String, String[]> elementsText; // me too

    @Mock
    Configuration mockCfg;

    // Provides a fresh handler instance for tests
    private Handler newHandler() {
        return new Handler();
    }

    // Provides a handler wired with a mocked CIFSContext
    private Handler newHandlerWith(CIFSContext ctx) {
        return new Handler(ctx);
    }

    @Test
    @DisplayName("getDefaultPort returns SMB default port")
    void testGetDefaultPort() {

        assertEquals(0, controller.afterProcessingCount);
        assertEquals(0, controller.noUrlInQueueCount);
        assertEquals(0, controller.waitNewUrlCount);
        // Should not throw exception, just logged
    }

    /**
     * Test exception handling with ignoreException = true (default)
     */
    public void test_exceptionHandling_ignoreTrue() {

        if (extPos >= 0) {
            return path.substring(0, extPos);
        }
        return path;
    }

    /**
     * Returns the root directory where the class file of the specified class is located.
     *
     * @param clazz
     *            The class. Must not be {@literal null}.
     * @return The root directory.
     * @see #getBuildDir(String)
     */