* {@link XpathTransformer} is a class that transforms HTML content into XML format based on XPath expressions.
 * It extracts data from an HTML document by applying XPath rules defined in {@link #fieldRuleMap}.
 * The extracted data is then formatted into an XML structure and stored in the {@link ResultData}.
 * <p>
 * This class extends {@link HtmlTransformer} and overrides the {@link #storeData(ResponseData, ResultData)} method

    }

    /**
     * Sets the response body from a file.
     *
     * @param responseBody the file containing the response body
     * @param isTemporary true if the file is temporary and should be deleted when closing
     */
    public void setResponseBody(final File responseBody, final boolean isTemporary) {
        responseBodyFile = responseBody;
        isTemporaryFile = isTemporary;
    }

    /**

        assertFalse(status == nullStatus);
        assertFalse(status.equals(nullStatus));

        // null == Enum should be false
        assertFalse(nullStatus == status);

        // Verify no NullPointerException when comparing with ==
        boolean result = (nullStatus == CrawlerStatus.INITIALIZING);
        assertFalse(result);
    }

    /**
     * Test thread safety of enum
     */

        assertArrayEquals(new String[] { "reading1" }, itemReadings[0]);
    }

    @Test
    public void testToSuggestItemWithNullTagsAndRoles() {
        // Test toSuggestItem when tags and roles are null (converted to empty lists)
        String word = "null tags and roles";
        float boost = 1.0f;
        List<String> readings = Arrays.asList("reading1");

    protected static class ComponentHolder<T> {
        /**
         * The component instance being held.
         */
        protected T instance;

        /**
         * The destroyer function to be called when the component is destroyed.
         */
        protected Consumer<T> destroyer;

        /**
         * Creates a new ComponentHolder with the specified instance and destroyer.

        assertFalse(conditionalRule.match(responseData)); // Doesn't match pattern

        testRule.setMatchResult(true);
        assertTrue(testRule.match(responseData)); // Always matches when set to true

        // Both should inherit same property behavior
        conditionalRule.setRuleId("conditional");
        testRule.setRuleId("test");

    }

    /**
     * Extracts keywords from the given query string based on the specified fields.
     *
     * @param q the query string to parse and extract keywords from
     * @param fields the fields to consider when extracting keywords
     * @return a list of unique keywords extracted from the query string
     */
    public static List<String> getKeywords(final String q, final String[] fields) {

 *   <li>XInclude awareness</li>
 * </ul>
 *
 * <p>
 * It also allows defining field rules using XPath expressions to extract specific data from the XML document and map it to fields in the ResultData.
 * The extracted data is then formatted into an XML structure suitable for indexing.
 * </p>
 *
 * <p>
 * The class uses a cache for XPathAPI objects to improve performance. The cache duration is configurable.
 * </p>
 *
 * <p>

        }
    }

    /**
     * Listener for connection events.
     */
    public interface OnConnectListener {
        /**
         * Called when the client connects to OpenSearch.
         */
        void onConnect();
    }

    /**
     * Sets the scroll configuration for delete operations.
     *

    /** Map of HTML tag names to attribute names for extracting child URLs. */
    protected Map<String, String> childUrlRuleMap = new LinkedHashMap<>();

    /** Default character encoding to use when none is specified. */
    protected String defaultEncoding;

    /** Number of bytes to read from input stream to determine character set encoding.
     * If you want to follow a html spec, use 512. */