- **SuggestIndexer**: Thread-safe for indexing
- **SuggestSettings**: NOT thread-safe for modifications

### Performance
- Use batch operations for indexing (100-500 items)
- Don't call `refresh()` too frequently
- Limit `maxReadingNum` to prevent memory issues
- OpenSearch auto-refreshes every 1 second by default

### Compatibility
- Designed for OpenSearch 2.x+
- All text processing uses UTF-8

        @Test
        @DisplayName("Should throw exception with insufficient buffer")
        void testReadBytesWireFormatInsufficientBuffer() {
            // Given
            byte[] buffer = new byte[1]; // Too small

            // When & Then
            assertThrows(ArrayIndexOutOfBoundsException.class, () -> response.readBytesWireFormat(buffer, 0));
        }

        @Test

        });

        assertThrows(CIFSException.class, () -> {
            preauthService.initializeSession("test", new byte[8], PreauthIntegrityService.HASH_ALGO_SHA512); // Too small
        });
    }

    @Test
    @DisplayName("Test unsupported hash algorithm")
    public void testUnsupportedHashAlgorithm() {
        byte[] salt = preauthService.generatePreauthSalt();

        }));
        if (!form.hasConditionQuery()) {
            if (StringUtil.isNotBlank(form.q)) {
                form.as.put("q", new String[] { form.q });
            } else {
                // TODO set default?
            }
        }
        return asHtml(virtualHost(path_AdvanceJsp)).renderWith(data -> {
            buildInitParams();

     * <p>
     * This method allows you to specify a custom ObjectInputFilter for fine-grained
     * control over which classes can be deserialized. Use this when the default filter
     * is too restrictive or permissive for your use case.
     * </p>
     *
     * @param bytes the byte array (must not be {@literal null})
     * @param filter the ObjectInputFilter to use, or null to disable filtering

     * @param thumbnailId The thumbnail ID.
     * @param value The thumbnail value to update.
     */
    protected void updateThumbnailField(final String thumbnailId, final String value) {
        // TODO bulk
        final FessConfig fessConfig = ComponentUtil.getFessConfig();
        try {
            ComponentUtil.getIndexingHelper()

            long totalTime = System.nanoTime() - startTime;

            // Should complete in reasonable time (< 10ms for 3000 operations)
            assertTrue(totalTime < 10_000_000L, "Null/empty password comparisons taking too long: " + totalTime + " ns");
        } finally {
            auth1.close();
            auth2.close();
            auth3.close();
        }
    }

    /**

            fail("Expected IORuntimeException for large file");
        } catch (final IORuntimeException e) {
            assertTrue("Error message should mention file size", e.getMessage().contains("File too large"));
        }
    }

    /**
     * Test readBytes with file within size limit
     *
     * @throws Exception
     */
    @Test
    public void testReadBytes_NormalFile() throws Exception {

        } finally {
            synchronized (run_thread) {
                if (run_thread != thread) {
                    /* Thread no longer the one setup for this transport --
                     * doConnect returned too late, just ignore.
                     */
                    if ((ex0 != null) && (LogStream.level >= 2)) {
                        ex0.printStackTrace(log);
                    }
                    return;

     * @return formatted file size string (e.g., "1.5M", "2.3G", "512K")
     */
    public static String formatFileSize(final long value) {
        double target = value;
        String unit = ""; // TODO l10n?
        String format = "0.#";
        if (value < 1024) {
            format = "0";
        } else if (value < 1024L * 1024L) {
            target /= 1024;
            unit = "K";