// Add defensive null/blank checks
        if (StringUtil.isBlank(username) || StringUtil.isBlank(password)) {
            if (logger.isDebugEnabled()) {
                logger.debug("Login failed: username or password is blank");
            }
            return OptionalEntity.empty();
        }

        if (StringUtil.isBlank(fessConfig.getLdapProviderUrl()) || !validate()) {

        if (list == null) {
            final String value = getSystemProperty(Constants.DEFAULT_SORT_VALUE_PROPERTY);
            if (StringUtil.isBlank(value)) {
                list = Collections.emptyList();
            } else {
                final Set<String> keySet = new HashSet<>();

    }

    @Override
    public String customizeActionMappingRequestPath(final String requestPath) {
        if (StringUtil.isBlank(requestPath)) {
            return null;
        }
        final String virtualHostKey = ComponentUtil.getVirtualHostHelper().getVirtualHostKey();
        if (StringUtil.isBlank(virtualHostKey)) {
            return null;
        }
        final String prefix = "/" + virtualHostKey;

                        if (!mappingList.isEmpty()) {
                            elevateWordToLabelBhv.batchInsert(mappingList);
                        }
                    } else if (StringUtil.isBlank(reading) && StringUtil.isBlank(boost)) {
                        elevateWordBhv.delete(elevateWord);
                        final String id = elevateWord.getId();

     * @param u the URL string to extract host from
     * @return the host name, or empty string if URL is blank, or unknown hostname if parsing fails
     */
    default String getHost(final String u) {
        if (StringUtil.isBlank(u)) {
            return StringUtil.EMPTY; // empty
        }

        String url = u;
        final String originalUrl = url;

        int idx = url.indexOf("://");
        if (idx >= 0) {

     * @return the OSDD file
     */
    protected File getOsddFile() {
        if (!isOsddLinkEnabled()) {
            logger.debug("OSDD is disabled.");
            return null;
        }
        if (StringUtil.isBlank(osddPath)) {
            logger.info("OSDD file is not found.");
            return null;
        }
        final String path = LaServletContextUtil.getServletContext().getRealPath(osddPath);
        if (path == null) {

                        final String userCode = userInfoHelper.getUserCode();

                        if (StringUtil.isBlank(userCode)) {
                            throw new WebApiException(HttpServletResponse.SC_BAD_REQUEST, "No user session.");
                        }
                        if (StringUtil.isBlank(favoriteUrl)) {
                            throw new WebApiException(HttpServletResponse.SC_BAD_REQUEST, "URL is null.");

     *
     * @param endpoint the storage endpoint URL
     * @return detected storage type
     */
    public static StorageType detectStorageType(final String endpoint) {
        if (StringUtil.isBlank(endpoint)) {
            // Default to S3 if no endpoint (uses AWS default)
            return StorageType.S3;
        }

        final String lowerEndpoint = endpoint.toLowerCase(Locale.ROOT);

                        logger.debug("Loaded KeyMatch Boost Query: {}", boolQuery);
                    }
                    String virtualHost = keyMatch.getVirtualHost();
                    if (StringUtil.isBlank(virtualHost)) {
                        virtualHost = StringUtil.EMPTY;
                    }

     *
     * @param path The path to normalize.
     * @return The normalized path.
     */
    public String normalizeConfigPath(final String path) {

        if (StringUtil.isBlank(path)) {
            return StringUtils.EMPTY;
        }

        final String p = path.trim();
        if (p.startsWith("#")) {
            return StringUtils.EMPTY;
        }