```java
import org.codelibs.core.exception.*;

// Runtime exception wrappers eliminate try-catch boilerplate
try {
    // Code that might throw checked exceptions
    return ClassUtil.newInstance(className); // Wraps checked exceptions automatically
} catch (ClassNotFoundRuntimeException e) {
    // Handle the wrapped exception
    logger.error("Class not found: " + className, e);
}
```

## 🏗️ Architecture & Design Patterns

import java.util.Iterator;
import java.util.List;
import java.util.ListIterator;
import java.util.Map;

/**
 * A response list that extends List functionality and includes pagination and search metadata.
 * This class wraps search results with pagination information, facet responses, and query statistics.
 * It implements the List interface to provide standard list operations while adding search-specific

labels.confirmPassword=Confirmar
labels.crawler=Rastreador
labels.crudMode=Modo
labels.errorCountMax=Número máximo de errores
labels.errorCountMin=Número mínimo de errores
labels.facet=Faceta
labels.geo=Geo
labels.groups=Grupos
labels.hash=Hash
labels.maxSize=Tamaño máximo
labels.order=Orden
labels.purgeSuggestSearchLogDay=Eliminar información de sugerencias anterior
labels.q=Consulta
labels.roles=Roles

labels.confirmPassword=Confirmar
labels.crawler=Rastreador
labels.crudMode=Modo
labels.errorCountMax=Número máximo de erros
labels.errorCountMin=Número mínimo de erros
labels.facet=Faceta
labels.geo=Geo
labels.groups=Grupos
labels.hash=Hash
labels.maxSize=Tamanho máximo
labels.order=Ordem
labels.purgeSuggestSearchLogDay=Excluir informações de sugestão anteriores
labels.q=Consulta
labels.roles=Funções

labels.crawler=Robot d'exploration
labels.crudMode=Mode
labels.errorCountMax=Nombre d'erreurs maximum
labels.errorCountMin=Nombre d'erreurs minimum
labels.facet=Facette
labels.geo=Géo
labels.groups=Groupes
labels.hash=Hachage
labels.maxSize=Taille maximale
labels.order=Ordre
labels.purgeSuggestSearchLogDay=Supprimer les anciennes informations de suggestion
labels.q=Requête
labels.roles=Rôles

        log.info("Skip masking for debug level {}", enable ? "enabled" : "disabled");
    }

    /**
     * Enable or disable stack trace inclusion
     *
     * @param enable true to include stack traces
     */
    public void setIncludeStackTrace(boolean enable) {
        this.includeStackTrace = enable;
    }

    /**
     * Set minimum log level
     *

    private static final String META_NAME_THUMBNAIL_CONTENT = "//META[@name=\"thumbnail\" or @name=\"THUMBNAIL\"]/@content";

    /** XPath expression for extracting Open Graph image content from meta tags */
    private static final String META_PROPERTY_OGIMAGE_CONTENT = "//META[@property=\"og:image\"]/@content";

    /** XPath expression for extracting robots content from meta tags */

            byte[] buffer = new byte[16];
            buffer[0] = 0x0F; // Invalid size (15 instead of 16)
            buffer[1] = 0x00;

            // When & Then - InvocationTargetException wraps the actual exception when using reflection
            Exception exception = assertThrows(Exception.class,
                    () -> invokeMethod(response, "readBytesWireFormat", new Class[] { byte[].class, int.class }, buffer, 0),

                    pageSize, 0);
        }
    }

    /**
     * Creates a QueryResponseList containing the search results and metadata.
     * Wraps the document list with additional information about the search operation
     * including record counts, timing, and pagination details.
     *
     * @param documentList the list of search result documents

        log.info("Connection lost, waiting for witness notification before retry");
        
        // Wait briefly for witness notification before retrying
        try {
            Thread.sleep(2000);  // 2 second grace period
        } catch (InterruptedException e) {
            Thread.currentThread().interrupt();
        }
    }
    
    // Proceed with normal error handling/retry
    super.handleConnectionLoss(error);