}

        throwValidationErrorApi(messages -> messages.addErrorsInvalidQueryUnknown(GLOBAL));
        return null; // ignore
    }

    /**
     * Retrieves a specific document by ID.
     *
     * @param id the document ID to retrieve
     * @return JSON response containing the document
     */
    // GET /api/admin/searchlist/doc/{doc_id}
    @Execute

    public abstract String getType();

    /**
     * Retrieves a paginated list of dictionary items.
     *
     * @param offset the starting offset for pagination
     * @param size the number of items to retrieve
     * @return a paginated list of dictionary items
     */
    public abstract PagingList<T> selectList(int offset, int size);

    /**
     * Retrieves a dictionary item by its ID.
     *

                .expireAfterWrite(fessConfig.getSuggestPopularWordCacheExpireAsInteger().longValue(), TimeUnit.MINUTES)
                .build();
    }

    /**
     * Retrieves a list of popular words based on the specified search parameters.
     * Uses caching to improve performance for repeated requests.
     *
     * @param searchRequestType the type of search request

        CrawlingParameterUtil.setUrlQueue(urlQueue);

        // Verify it can be retrieved
        UrlQueue<?> retrieved = CrawlingParameterUtil.getUrlQueue();
        assertNotNull(retrieved);
        assertEquals("test-session", retrieved.getSessionId());
        assertEquals("http://example.com", retrieved.getUrl());
    }

    public void test_urlQueue_setNull() {
        // Set a UrlQueue first

public interface UrlQueue<IDTYPE> {

    /**
     * Retrieves the unique identifier of the URL queue.
     *
     * @return the unique identifier of type IDTYPE.
     */
    IDTYPE getId();

    /**
     * Sets the unique identifier for the URL queue.
     *
     * @param id the unique identifier to set
     */
    void setId(IDTYPE id);

    /**
     * Retrieves the session ID associated with this URL queue.
     *

        return LocalDateTime.parse(value, formatter).atZone(ZoneId.systemDefault()).withZoneSameInstant(ZoneOffset.UTC).toLocalDateTime();
    }

    /**
     * Retrieves a specific search log entry by log type and ID.
     *
     * @param logType The type of log to retrieve (search, click, favorite, userinfo)
     * @param id The ID of the log entry
     * @return Optional entity containing the log entry if found
     */

 * </p>
 *
 * <p>
 * The {@link #storeData(ResponseData, ResultData)} method is the main entry point for storing
 * the content of a crawled resource. The {@link #getData(AccessResultData)} method retrieves
 * the stored file path as a File object.
 * </p>
 */
public class FileTransformer extends HtmlTransformer {
    /** Logger instance for this class */

        String[] retrieved = data.getValues("empty");
        assertNotNull(retrieved);
        assertEquals(0, retrieved.length);
    }

    public void test_nullValues() {
        // Test with null values
        ExtractData data = new ExtractData();

        data.putValue("key", null);

        String[] retrieved = data.getValues("key");
        assertNotNull(retrieved);

 *   <li>{@code done} - Flag indicating whether the file has been retrieved.</li>
 * </ul>
 *
 * <p>Constructors:</p>
 * <ul>
 *   <li>{@code ContentOutputStream(int threshold, File tmpDir)} - Constructs a ContentOutputStream with a specified threshold and temporary directory.</li>
 * </ul>
 *
 * <p>Methods:</p>
 * <ul>
 *   <li>{@code getFile()} - Marks the file as retrieved and returns the file.</li>

public interface AccessResultData<IDTYPE> {

    /**
     * Retrieves the unique identifier of the access result data.
     *
     * @return the unique identifier of type IDTYPE.
     */
    IDTYPE getId();

    /**
     * Sets the ID of the access result data.
     *
     * @param id the ID to set
     */
    void setId(IDTYPE id);

    /**
     * Retrieves the name of the transformer associated with this access result data.