() -> asHtml(path_AdminWizard_AdminWizardConfigJsp));
            return null;
        }
    }

    /**
     * Retrieves an integer value from system properties with a default fallback.
     *
     * @param key the property key to look up
     * @param defaultValue the default value if the property is not found or invalid
     * @return the integer value or default value
     */

            logger.debug("Storing state in session: {}", stateData);
        }
        stateMap.put(state, stateData);
    }

    /**
     * Processes authentication data from the OAuth2 callback.
     * @param request The HTTP servlet request containing authentication data.
     * @return The login credential or null if processing fails.
     */

**Registration**:
```java
extractorFactory.addExtractor("text/html", htmlExtractor, 2);  // Weight 2
extractorFactory.addExtractor("text/html", tikaExtractor, 1);  // Fallback
```

### Helpers

**RobotsTxtHelper**: RFC 9309 parsing, user-agent matching, crawl-delay, sitemaps
**SitemapsHelper**: Sitemap XML parsing, index handling
**MimeTypeHelper**: MIME detection via Tika

        // Create GroovyShell with custom class loader for proper resource management
        GroovyClassLoader classLoader = null;
        try {
            // Get parent class loader with fallback to ensure robustness across threading contexts
            ClassLoader parentClassLoader = Thread.currentThread().getContextClassLoader();
            if (parentClassLoader == null) {

 * authentication context without requiring users to explicitly enter credentials.
 *
 * The authenticator supports various configuration options including delegation,
 * basic authentication fallback, and localhost authentication bypass.
 */
public class SpnegoAuthenticator implements SsoAuthenticator {

    /** Logger for this class. */

        }

        if (isSearchField(field)) {
            return fieldBuilder.buildQuery(field, text, boost);
        }

        // Fallback: treat as default field query
        context.addFieldLog(Constants.DEFAULT_FIELD, text);
        return buildDefaultQueryBuilder(fessConfig, context, defaultBuilder);
    }

        return getSystemPropertyAsInt(Constants.LTR_WINDOW_SIZE_PROPERTY, 100);
    }

    /**
     * Gets the permission fields for Entra ID authentication.
     * Uses new entraid.permission.fields key with fallback to legacy aad.permission.fields.
     * @return Array of permission field names.
     */
    default String[] getEntraIdPermissionFields() {
        String value = getSystemProperty("entraid.permission.fields", null);

            } finally {
                SMailCallbackContext.clearPreparedMessageHookOnThread();
            }
        }
    }

    /**
     * Retrieves a value from a map with a default fallback.
     *
     * @param dataMap the map to retrieve the value from
     * @param key the key to look up
     * @param defaultValue the default value to return if key is not found or value is blank

        }
    }

    /**
     * Flushes configuration files to the search engine and executes a callback.
     *
     * @param callback the callback to execute after flushing
     */
    public void flushConfigFiles(final Runnable callback) {
        final FessConfig fessConfig = ComponentUtil.getFessConfig();

        final String fesenType = fessConfig.getFesenType();

     *   <li>Index update operations through callbacks</li>
     *   <li>Error handling and failure logging</li>
     *   <li>Cleanup of old documents after successful crawling</li>
     * </ul>
     */
    protected static class DataCrawlingThread extends Thread {

        /** Configuration for the data store being crawled */
        private final DataConfig dataConfig;

        /** Callback for handling document indexing operations */