*
     * @param protocol the protocol name to add (without colon suffix)
     */
    public void addWebProtocol(final String protocol) {
        final String prefix = protocol + ":";
        if (stream(webProtocols).get(stream -> stream.anyMatch(s -> s.equals(prefix)))) {
            logger.debug("Web protocols already contains: protocol={}", protocol);
            return;
        }

        if (StringUtil.isNotBlank(value)) {
            return check(protocols, value);
        }
        return true;
    }

    /**
     * Checks if the given value matches any of the specified protocols.
     *
     * @param protocols the allowed protocols
     * @param value the URI string to validate
     * @return true if the value matches allowed protocols, false otherwise
     */

        assertFalse(protocolHelper.isValidFileProtocol("gcs://bucket/path"));

        // Add s3 protocol dynamically
        protocolHelper.addFileProtocol("s3");
        assertTrue(protocolHelper.isValidFileProtocol("s3://bucket/path"));
        assertFalse(protocolHelper.isValidFileProtocol("gcs://bucket/path"));

        // Add gcs protocol dynamically
        protocolHelper.addFileProtocol("gcs");

    }

    /**
     * Parses and filters URL patterns from text based on protocol types.
     * Processes each line of the input text, filtering URLs based on web and file protocol support.
     *
     * @param text the raw text containing URL patterns, one per line
     * @param web true if web protocol URLs should be included
     * @param file true if file protocol URLs should be included

        }

        return false;
    }

    /**
     * Converts a crawling path to the appropriate protocol format.
     * Handles various path formats and adds proper protocol prefixes.
     *
     * @param path the original path to convert
     * @return the converted path with appropriate protocol prefix
     */
    protected String convertCrawlingPath(final String path) {

    /**
     * Gets the logger instance for this transformer.
     *
     * @return the logger instance
     */
    Logger getLogger();

    /**
     * Extracts the host name from a URL string.
     * Removes protocol and path components to return just the hostname.
     *
     * @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
     */

        return appendQueryParameter(document, url);
    }

    /**
     * Updates file protocol based on user agent type.
     * Handles different browser-specific file protocol formats.
     *
     * @param url the file URL to update
     * @return the updated URL with appropriate file protocol
     */
    protected String updateFileProtocol(String url) {
        final int pos = url.indexOf(':', 5);

import jakarta.validation.Payload;

public class UriTypeTest extends UnitFessTestCase {

    // Test field with UriType annotation for WEB protocol
    @UriType(protocolType = ProtocolType.WEB)
    private String testFieldWeb;

    // Test field with UriType annotation for FILE protocol
    @UriType(protocolType = ProtocolType.FILE)
    private String testFieldFile;

    // Test field with custom message

            return "[" + compressed + "]";
        }
        return address.getHostAddress();
    }

    /**
     * Builds a URL from protocol, InetAddress, port, and path.
     * Properly handles IPv6 addresses by wrapping them in brackets.
     *
     * @param protocol the protocol (e.g., "http", "https")
     * @param address the InetAddress for the host
     * @param port the port number

        protocols = new String[] { "http:" };
        values = "https://www.foo.com/\nhttps://www.bar.com/";
        assertFalse(UriTypeValidator.check(protocols, values));

        protocols = new String[] { "http:" };
        values = "https://www.foo.com/\n \nhttps://www.bar.com/";
        assertFalse(UriTypeValidator.check(protocols, values));

        protocols = new String[] { "http:" };