}

    /**
     * Adds a metadata field with its corresponding XPath expression for extraction.
     *
     * @param name the name of the metadata field
     * @param xpath the XPath expression to extract the metadata value
     */
    public void addMetadata(final String name, final String xpath) {
        metadataXpathMap.put(name, xpath);
    }

    /*
     * (non-Javadoc)
     *
     * @see

    }

    /**
     * Checks if a path is valid for crawling (not a JavaScript, mailto, or other invalid URL).
     *
     * @param path the path to validate
     * @return true if the path is valid, false otherwise
     */
    protected boolean isValidPath(final String path) {
        if (StringUtil.isBlank(path)) {
            return false;
        }

    }

    /**
     * Adds a field rule to the transformer.
     * @param name The name of the field.
     * @param xpath The XPath expression for the field.
     */
    public void addFieldRule(final String name, final String xpath) {
        fieldRuleMap.put(name, xpath);
    }

    /**
     * Returns data as XML content of String.
     *
     * @return XML content of String.
     */

    }

    /**
     * Gets the XPath expression for selecting target nodes.
     *
     * @return the target node path
     */
    public String getTargetNodePath() {
        return targetNodePath;
    }

    /**
     * Sets the XPath expression for selecting target nodes.
     *
     * @param targetNodePath the target node path to set
     */

 *
 * @see javax.xml.xpath.XPath
 * @see javax.xml.xpath.XPathFactory
 * @see javax.xml.xpath.XPathExpressionException
 */
public class XPathAPI {

    private final XPath xPath;

    /**
     * Creates a new XPathAPI instance.
     */
    public XPathAPI() {
        xPath = createXPath(f -> {});
    }

    /**

     * @param path The path to match.
     * @return The matching SmbAuthentication object, or null if no match is found.
     */
    public SmbAuthentication get(final String path) {
        if (path == null) {
            return null;
        }

        for (final Map.Entry<String, SmbAuthentication> entry : authMap.entrySet()) {
            if (path.startsWith(entry.getKey())) {

            }
        }

        /**
         * Adds a disallowed path to this directive.
         * @param path the path to disallow
         */
        public void addDisallow(final String path) {
            if (!disallowedPaths.contains(path)) {
                disallowedPaths.add(path);
            }
        }

        /**
         * Gets all allowed paths for this directive.

<components namespace="fessCrawler">
    <include path="crawler/container.xml"/>
    <include path="crawler/client.xml"/>
    <include path="crawler/rule.xml"/>
    <include path="crawler/filter.xml"/>
    <include path="crawler/interval.xml"/>
    <include path="crawler/extractor.xml"/>
    <include path="crawler/mimetype.xml"/>
    <include path="crawler/encoding.xml"/>
    <include path="crawler/urlconverter.xml"/>

    }

    /**
     * Gets the base path for storing files.
     *
     * @return the base path
     */
    public String getPath() {
        return path;
    }

    /**
     * Sets the base path for storing files.
     *
     * @param path the base path to set
     */
    public void setPath(final String path) {
        this.path = path;
    }

    /**

        assertTrue(auth.matches("ftp://hostname:21/path/to/resource.txt"));
        assertTrue(auth.matches("ftp://hostname/path/to/resource.txt"));
        assertFalse(auth.matches("ftp://hostname:22/path/to/resource.txt"));
        assertFalse(auth.matches("ftp://otherhost/path/to/resource.txt"));

        // Test with special characters in path
        assertTrue(auth.matches("ftp://hostname:21/path%20with%20spaces/resource.txt"));